Python 2 ya no es compatible con la comunidad. Recomendamos que migres las apps de Python 2 a Python 3.

Descripción general de App Engine

ID de región

REGION_ID es un código abreviado que Google asigna en función de la región que seleccionas cuando creas la app. El código no corresponde a un país ni a una provincia, aunque algunos ID de región puedan parecer similares a los códigos de país y provincia que se suelen usar. Incluir REGION_ID.r en las URL de App Engine es opcional en el caso de las apps existentes, y pronto será obligatorio para todas las apps nuevas.

A fin de garantizar una transición sin problemas, estamos actualizando App Engine de forma paulatina para usar los ID de región. Si aún no actualizamos tu proyecto de Google Cloud, no verás un ID de región para la app. Dado que el ID es opcional en las apps existentes, no es necesario que actualices las URL ni que realices otros cambios una vez que el ID de región esté disponible para las apps existentes.

Obtén más información acerca de los ID de región.

Una aplicación de App Engine consta de un solo recurso de aplicación que consiste en uno o más servicios. Cada servicio se puede configurar para utilizar entornos de ejecución diferentes y operar con una configuración de rendimiento distinta. Dentro de cada servicio se implementan sus versiones. Luego, cada versión se ejecuta en una o más instancias, según la cantidad de tráfico que configuraste para que maneje.

Componentes de una aplicación

Cuando creas un recurso de aplicación, la app de App Engine se crea en el proyecto de Google Cloud. La aplicación de App Engine es un contenedor de nivel superior que incluye el servicio, la versión y los recursos de instancias que componen la app. Cuando creas una app de App Engine, todos los recursos se crean en la región elegida, incluido el código y los metadatos de la app, y un conjunto de configuraciones y credenciales.

Cada aplicación de App Engine incluye al menos un servicio, el default, que puede contener muchas versiones, según el estado de facturación de la app. Para obtener más información, consulta Límites a continuación.

En el siguiente diagrama, se muestra la jerarquía de una aplicación de App Engine que se ejecuta con varios servicios. En este diagrama, la app tiene dos servicios que contienen varias versiones, y dos de esas versiones se ejecutan de manera activa en varias instancias.

Gráfico de jerarquías de servicios, instancias y versiones de una app

Otros servicios de Google Cloud, como Datastore, se comparten en la app de App Engine. Para obtener más información, consulta Estructura servicios web.

Servicios

Usa los servicios de App Engine para factorizar tus apps grandes en componentes lógicos que puedan compartir funciones de App Engine de forma segura y comunicarse entre sí. En general, los servicios de App Engine se comportan como microservicios. Por lo tanto, puedes ejecutar tu app en un solo servicio o puedes diseñar e implementar varios servicios para que se ejecuten como un conjunto de microservicios.

Por ejemplo, una aplicación que controla las solicitudes de los clientes podría incluir servicios separados, y cada uno controlar diferentes tareas, como:

  • Solicitudes a la API desde dispositivos móviles
  • Solicitudes de administración internas
  • Procesamiento de backend, como canalización de facturación y análisis de datos

Cada servicio de App Engine consta del código fuente de tu app y los archivos de configuración de App Engine correspondientes. El conjunto de archivos que implementas en un servicio representa una sola versión de ese servicio, y cada vez que implementas en ese servicio creas versiones adicionales dentro de este.

Versiones

Tener varias versiones de la app en cada servicio te permite alternar de versión con rapidez para reversiones, pruebas o distintos eventos temporales. Puedes enrutar tráfico a una o más versiones específicas de la app mediante la migración o división del tráfico.

Instancias

Las versiones de los servicios se ejecutan en una o más instancias. De forma predeterminada, App Engine escala tu aplicación para que coincida con la carga. Tus apps escalarán la cantidad de instancias que se ejecutan para brindar un rendimiento coherente o reducirán la escala con el objetivo de minimizar las instancias inactivas y reducir costos. Para obtener más información sobre las instancias, consulta cómo se administran las instancias.

Solicitudes de aplicación

Cada uno de los servicios de tu app, así como cada una de sus versiones, deben tener un nombre único. Puedes usar esos nombres únicos para orientar y enrutar el tráfico a recursos específicos mediante las URL, por ejemplo:

https://VERSION_ID-dot-SERVICE_ID-dot-PROJECT_ID.REGION_ID.r.appspot.com

Las solicitudes de usuario entrantes se enrutan a los servicios o a las versiones que se configuraron para manejar el tráfico. También puedes orientar y enviar solicitudes hacia servicios y versiones específicos. Para obtener más información, consulta Cómo manejar solicitudes.

Registra solicitudes de la aplicación

Cuando la aplicación maneja una solicitud, también puede escribir sus propios mensajes de registro en stdout y stderr. Para obtener más información sobre los registros de tu app, consulta Escribe registros de la aplicación.

Límites

La cantidad máxima de servicios y versiones que puedes implementar depende de los precios de tu app:

Límite Aplicación gratuita Aplicación pagada
Número máximo de servicios por app 5 105
Número máximo de versiones por app 15 210

También existe un límite en la cantidad de instancias para cada servicio con el escalamiento básico o manual:

Máximo de instancias por versión de escalamiento manual/básico
Aplicación gratuita Aplicación pagada en EE.UU. Aplicación pagada en la UE
20 25 (200 para us-central) 25