Preparar archivos de configuración para el entorno de ejecución de Python 3

Antes de que puedas ejecutar tu app en el entorno de ejecución de Python 3 del entorno estándar de App Engine, es posible que debas cambiar algunos de los archivos de configuración que usa App Engine:

app.yaml Este archivo contiene información sobre el código de la aplicación, como el entorno de ejecución y los controladores de aplicación.
appengine_config.py. El entorno de ejecución de Python 2 usa este archivo para acceder a bibliotecas de terceros y proporcionar valores para constantes y “funciones hook”. El entorno de ejecución de Python 3 no usa este archivo.

Actualizando `app.yaml`

Se modificó el comportamiento de algunos campos del archivo de configuración app.yaml. Quita los campos que ya no sean compatibles y actualiza otros campos como se describe en la siguiente tabla.

Campo	Tipo de cambio	Descripción
app_engine_apis	Solo aplicable a Python 3	Se debe configurar como `true` si deseas acceder a los servicios agrupados en paquetes heredados para Python 3.
api_version application_readable builtins	Ya no son compatibles.	No aplicable en el entorno de ejecución de Python 3.
threadsafe	Ya no son compatibles.	Se presume que todas las aplicaciones son seguras para usar en subprocesos. Si tu aplicación no tiene protección de subprocesos, especifica un `entrypoint` y configura 1 subproceso por trabajador. Por ejemplo, cuando uses la clase de instancia F4: `entrypoint: gunicorn -b :$PORT -w 8 --threads 1 main:app` Consulta las prácticas recomendadas de puntos de entrada para la cantidad recomendada de trabajadores en cada clase de instancia.
bibliotecas	Ya no son compatibles.	Usa el archivo `requirements.txt` para declarar dependencias y, además, instalar bibliotecas cliente.
controladores: acceso	Compatible si `app_engine_apis` es `true`	Si no usas los servicios agrupados en paquetes heredados para Python 3, usa Identity and Access Management (IAM) en la administración de usuarios.
controladores: secuencia de comandos	Modificado	En el entorno de ejecución de Python 2, usa el campo `script` para enrutar las solicitudes entrantes a la secuencia de comandos de tu app. En el entorno de ejecución de Python 3, debes usar un framework web con enrutamiento integrado en la app (como Flask o Django) en lugar de usar el campo `script`. Para migrar tu archivo `app.yaml` al entorno de ejecución de Python 3, realiza una de las siguientes acciones, según si el archivo contiene controladores estáticos y controladores de secuencias de comandos: Si tu archivo `app.yaml` contiene controladores estáticos, realiza una de las siguientes acciones para asegurarte de que las solicitudes de contenido dinámico se enruten a la secuencia de comandos de tu aplicación: Quita todos los campos `script`. Luego, agrega un campo `entrypoint` para iniciar un servidor web que ejecute tu aplicación. Las solicitudes que no coincidan con ninguno de tus controladores estáticos se dirigirán al servidor web que especificaste en el campo `entrypoint`. El servidor web y framework de tu aplicación son responsables de enrutar la solicitud a la secuencia de comandos correcta. Reemplaza el valor de todos los campos `script` por `auto`. App Engine ejecutará tu aplicación en un servidor web de forma automática (siempre que tu aplicación cumpla con algunos requisitos), y todas las solicitudes que coinciden con un controlador de secuencia de comandos se dirigirán al servidor web. El servidor web y el framework de tu aplicación son responsables de enrutar la solicitud a la secuencia de comandos correcta. Si tu archivo `app.yaml` no contiene controladores estáticos, quita todos los campos `script`. Todas las solicitudes a tu app se dirigirán a su servidor web, y el framework de tu app enrutará la solicitud a la secuencia de comandos correcta. De forma opcional, puedes agregar un campo `entrypoint` para personalizar el comportamiento de inicio predeterminado. Si tu `app.yaml` tiene ambos tipos de controladores, puedes quitar todos los controladores de secuencias de comandos que se marcarían como `auto` y dejar los controladores estáticos, así como los controladores `auto` que requieren otras directivas, como el controlador de solo administrador en el ejemplo a continuación. El manejo de archivos estáticos no se modifica.

Si usas cualquiera de los campos obsoletos, App Engine muestra un error cuando implementas tu app.

Puedes usar los siguientes ejemplos para comparar las diferencias entre los archivos app.yaml:

Python 2

runtime: python27
api_version: 1
threadsafe: true

handlers:
- url: /
  script: home.app

- url: /index\.html
  script: home.app

- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: admin.app
  login: admin

- url: /.*
  script: not_found.app

Python 3

runtime: python312
app_engine_apis: true

handlers:
- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: auto
  login: admin

Quita `appengine_config.py`

El entorno de ejecución de Python 2 en el entorno estándar de App Engine usa el archivo appengine_config.py.

Este archivo se ignora en el entorno de ejecución de Python 3. En su lugar, el entorno de ejecución de Python 3 usa el archivo requirements.txt estándar para instalar dependencias, incluidas las dependencias que usan código nativo.