Comienza a usar App Engine (Python 3)

1. Descripción general

Las aplicaciones de Google App Engine son fáciles de crear, mantener y escalar a medida que cambian tus necesidades de almacenamiento de datos y tráfico. Con App Engine, no tendrás que mantener servidores. Solo debes subir tu aplicación y estará lista para usar.

En este codelab, aprenderás a implementar una app web simple de Python escrita con el framework web Flask. Aunque esta muestra usa Flask, puedes usar otros frameworks web, como Django, Pyramid, Bottle y web.py.

Este instructivo está adaptado desde https://cloud.google.com/appengine/docs/standard/python3/quickstart.

Qué aprenderás

• Cómo crear un servidor de Python simple en Google App Engine
• Cómo actualizar el código sin inhabilitar el servidor

Requisitos

• Conocimientos de Python
• Conocimientos de editores de texto estándares de Linux, como Vim, Emacs o nano

Encuesta

¿Cómo usarás este instructivo?

Leer Leer y completar los ejercicios

¿Cómo calificarías tu experiencia en Python?

Principiante Intermedio Avanzado

¿Cómo calificarías tu experiencia con los servicios de Google Cloud?

Principiante Intermedio Avanzado .

2. Configuración y requisitos

Configuración del entorno de autoaprendizaje

1. Accede a Google Cloud Console y crea un proyecto nuevo o reutiliza uno existente. Si aún no tienes una cuenta de Gmail o de Google Workspace, debes crear una.

• El Nombre del proyecto es el nombre visible de los participantes de este proyecto. Es una cadena de caracteres que no se utiliza en las APIs de Google. Puedes actualizarla cuando quieras.
• El ID del proyecto es único en todos los proyectos de Google Cloud y es inmutable (no se puede cambiar después de configurarlo). La consola de Cloud genera automáticamente una cadena única. Por lo general, no importa cuál sea. En la mayoría de los codelabs, deberás hacer referencia al ID de tu proyecto (suele identificarse como PROJECT_ID). Si no te gusta el ID que se generó, podrías generar otro aleatorio. También puedes probar uno propio y ver si está disponible. No se puede cambiar después de este paso y se usa el mismo durante todo el proyecto.
• Recuerda que hay un tercer valor, un número de proyecto, que usan algunas APIs. Obtén más información sobre estos tres valores en la documentación.

Precaución: El ID del proyecto es único a nivel global y no lo puede usar nadie más después de que lo hayas seleccionado. Eres el único usuario de ese ID. Incluso si se borra un proyecto, no se puede volver a usar el ID.

Nota: Si usas una cuenta de Gmail, puedes dejar la ubicación predeterminada como Sin organización. Si usas una cuenta de Google Workspace, elige una ubicación adecuada para tu organización.

2. A continuación, deberás habilitar la facturación en la consola de Cloud para usar las APIs o los recursos de Cloud. Ejecutar este codelab no costará mucho, tal vez nada. Para cerrar recursos y evitar que se generen cobros más allá de este instructivo, puedes borrar los recursos que creaste o borrar el proyecto. Los usuarios nuevos de Google Cloud son aptos para participar en el programa Prueba gratuita de $300.

Inicia Cloud Shell

Si bien Google Cloud se puede operar de manera remota desde tu laptop, en este codelab usarás Cloud Shell, un entorno de línea de comandos que se ejecuta en la nube.

Activar Cloud Shell

1. En la consola de Cloud, haz clic en Activar Cloud Shell.

Si es la primera vez que inicias Cloud Shell, verás una pantalla intermedia que describe en qué consiste. Si apareció una pantalla intermedia, haz clic en Continuar.

El aprovisionamiento y la conexión a Cloud Shell solo tomará unos minutos.

Esta máquina virtual está cargada con todas las herramientas de desarrollo necesarias. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud, lo que mejora considerablemente el rendimiento de la red y la autenticación. Gran parte de tu trabajo en este codelab, si no todo, se puede hacer con un navegador.

Una vez que te conectes a Cloud Shell, deberías ver que estás autenticado y que el proyecto está configurado con tu ID del proyecto.

2. En Cloud Shell, ejecuta el siguiente comando para confirmar que tienes la autenticación:

gcloud auth list

Resultado del comando

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Nota: gcloud es la herramienta de línea de comandos potente y unificada de Google Cloud. Ya está preinstalada en Cloud Shell. Notarás que esta función es compatible con la función de autocompletado con tabulador. Es posible que se te solicite autenticar la primera vez que ejecutes un comando. Para obtener más información, consulta la descripción general de la herramienta de línea de comandos de gcloud.

3. Ejecuta el siguiente comando en Cloud Shell para confirmar que el comando de gcloud conoce tu proyecto:

gcloud config list project

Resultado del comando

[core]
project = <PROJECT_ID>

De lo contrario, puedes configurarlo con el siguiente comando:

gcloud config set project <PROJECT_ID>

Resultado del comando

Updated property [core/project].

Nota: Si estás completando este instructivo fuera de Cloud Shell, sigue Configura las credenciales predeterminadas de la aplicación.

3. Escribe la app web

Después de iniciar Cloud Shell, puedes usar la línea de comandos para invocar el comando gcloud del SDK de Cloud o cualquier otra herramienta disponible en la instancia de la máquina virtual. Puedes usar el directorio $HOME en el almacenamiento del disco persistente para guardar archivos en los proyectos y entre sesiones de Cloud Shell. Tu directorio $HOME es privado, por lo que otros usuarios no pueden acceder a él.

Comencemos creando una carpeta nueva para la aplicación en el directorio $HOME:

mkdir ~/helloworld
cd ~/helloworld

Crea un archivo llamado main.py:

touch main.py

Edita el archivo con tu editor de línea de comandos preferido (nano, vim o emacs) o haz clic en el botón del editor de Cloud Shell:

Para editar directamente el archivo con el editor de Cloud Shell, usa este comando:

cloudshell edit main.py

main.py

import flask

# If `entrypoint` is not defined in app.yaml, App Engine will look for an app
# called `app` in `main.py`.
app = flask.Flask(__name__)


@app.get("/")
def hello():
    """Return a friendly HTTP greeting."""
    return "Hello World!\n"


if __name__ == "__main__":
    # Used when running locally only. When deploying to Google App
    # Engine, a webserver process such as Gunicorn will serve the app. This
    # can be configured by adding an `entrypoint` to app.yaml.
    app.run(host="localhost", port=8080, debug=True)

Esta app web es un servicio web simple que responde a solicitudes HTTP GET con el mensaje Hello World!.

4. Cómo definir las dependencias

Para especificar las dependencias de tu app web, regresa a la terminal y crea un archivo requirements.txt en el directorio raíz de tu proyecto, con la versión exacta de Flask que usarás:

touch requirements.txt

Para editar el archivo con el editor de Cloud Shell, usa este comando:

cloudshell edit requirements.txt

requirements.txt

# https://pypi.org/project/Flask
Flask==3.0.2

La dependencia principal de tu app web es Flask.

5. Configura la implementación

Para implementar la aplicación web en App Engine, necesitas un archivo app.yaml. Este archivo de configuración define la configuración de tu app web para App Engine.

En la terminal, crea y edita el archivo app.yaml en el directorio raíz de tu proyecto:

touch app.yaml

Para editar el archivo con el editor de Cloud Shell, usa este comando:

cloudshell edit app.yaml

app.yaml

runtime: python312

Con esta app web sencilla, solo debes especificar la versión de Python (p.ej., 3.12 aquí). En el caso de las apps web más complicadas, puedes establecer parámetros de configuración adicionales, como escalamiento, controladores para archivos estáticos, controladores adicionales y otros elementos de la aplicación, como variables de entorno y nombres de servicios. Para obtener más información y una lista de todos los elementos compatibles, consulta la referencia de app.yaml.

6. Implementa la app web

Se omiten algunos pasos aquí. En un ciclo de desarrollo estándar, antes de la implementación, primero debes configurar un entorno de desarrollo local, instalar las mismas dependencias de forma local y probar la app de forma local. Consulta Configura un entorno de desarrollo de Python.

En la terminal, verifica el contenido de tu directorio:

ls

Deberías tener los 3 archivos siguientes:

app.yaml  main.py  requirements.txt

Implementa tu aplicación web con el siguiente comando:

gcloud app deploy

La primera vez, debes elegir una región de implementación:

Please choose the region where you want your App Engine application
located:

 [1] asia-east2
...
 [7] australia-southeast1
 [8] europe-west
 [9] europe-west2
...
 [12] northamerica-northeast1
 [13] southamerica-east1
...
 [19] us-west4
...
Please enter your numeric choice:

Confirma que quieres iniciar la implementación:

Creating App Engine application in project [PROJECT_ID] and region [REGION]....done.
Services to deploy:

descriptor:      [~/helloworld/app.yaml]
source:          [~/helloworld]
target project:  [PROJECT_ID]
target service:  [default]
target version:  [YYYYMMDDtHHMMSS]
target url:      [https://PROJECT_ID.REGION_ID.r.appspot.com]

Do you want to continue (Y/n)?

Se implementará tu app:

Beginning deployment of service [default]...
Created .gcloudignore file. See `gcloud topic gcloudignore` for details.
Uploading 3 files to Google Cloud Storage
100%
File upload done.
Updating service [default]...done.     
Setting traffic split for service [default]...done.
Deployed service [default] to [https://PROJECT_ID.REGION_ID.r.appspot.com]

Tu app web ya está lista para responder a las solicitudes HTTP en https://PROJECT_ID.REGION_ID.r.appspot.com.

7. Prueba la app web

Tu app web está lista para responder a las solicitudes HTTP en https://PROJECT_ID.REGION_ID.r.appspot.com.

Primero, recupera el nombre de host de tu app web con el comando gcloud app describe:

APPENGINE_HOSTNAME=$(gcloud app describe --format "value(defaultHostname)")

Prueba tu aplicación web con esta simple solicitud HTTP GET:

curl https://$APPENGINE_HOSTNAME

Deberías obtener la siguiente respuesta:

Hello World!

Tu app web se puede entregar a través de un dominio personalizado, como example.com, en lugar de la dirección predeterminada appspot.com. Consulta Asigna dominios personalizados.

Resumen

En los pasos anteriores, configuraste una aplicación web simple de Python, la ejecutaste y la implementaste en App Engine.

8. Actualiza la app web

Para modificar tu aplicación web, cambia el cuerpo de la función hello() en el archivo main.py.

Para editar el archivo con el editor de Cloud Shell, usa este comando:

cloudshell edit main.py

main.py

import flask

# If `entrypoint` is not defined in app.yaml, App Engine will look for an app
# called `app` in `main.py`.
app = flask.Flask(__name__)


@app.get("/")
def hello():
    """Return a friendly HTTP greeting."""
    # return "Hello World!\n"  # ← Replace this line
    who = flask.request.args.get("who", "World")
    return f"Hello {who}!\n"


if __name__ == "__main__":
    # Used when running locally only. When deploying to Google App
    # Engine, a webserver process such as Gunicorn will serve the app. This
    # can be configured by adding an `entrypoint` to app.yaml.
    app.run(host="localhost", port=8080, debug=True)

Aquí se usa el objeto de contexto request de Flask para controlar un parámetro opcional en la solicitud HTTP GET.

En la terminal, vuelve a implementar para actualizar tu aplicación web:

gcloud app deploy --quiet

La marca --quiet inhabilita el mensaje interactivo, que inicia directamente la implementación.

Se implementará la nueva versión de tu app:

Beginning deployment of service [default]...
Uploading 1 file to Google Cloud Storage 
...
Deployed service [default] to [https://PROJECT_ID.REGION_ID.r.appspot.com]

La nueva versión se implementa de manera transparente y el tráfico se enruta automáticamente hacia ella (si se implementó de forma correcta).

Prueba la nueva versión de tu aplicación web, exactamente como lo hiciste anteriormente:

curl https://$APPENGINE_HOSTNAME

Deberías obtener la misma respuesta:

Hello World!

Pruébalo con el parámetro opcional:

curl https://$APPENGINE_HOSTNAME?who=Universe

Deberías obtener la siguiente respuesta:

Hello Universe!

Resumen

En este paso, actualizaste y volviste a implementar tu aplicación web sin ninguna interrupción del servicio.

9. ¡Felicitaciones!

Aprendiste a escribir tu primera aplicación web de App Engine en Python.

Más información

• Documentación de App Engine: https://cloud.google.com/appengine
• Explora este instructivo para escribir una aplicación completa de Python en App Engine: https://cloud.google.com/appengine/docs/standard/python3/building-app.

Licencia

Este trabajo cuenta con una licencia Atribución 2.0 Genérica de Creative Commons.