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. En el caso de las apps creadas después de febrero de 2020, REGION_ID.r se incluye en las URL de App Engine. En el caso de las apps existentes creadas antes de esta fecha, el ID de región es opcional en la URL.

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

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

Por ejemplo, una app que maneja tus solicitudes de cliente puede incluir servicios independientes que gestionan tareas diferentes, como las que se muestran a continuación:

  • 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 tu app en cada servicio te permite alternar rápidamente de versión 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 tus 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-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

Tenga en cuenta que la longitud combinada de VERSION-dot-SERVICE-dot-PROJECT_ID (en la que VERSION es el nombre de tu versión, SERVICE es el nombre de tu servicio y PROJECT_ID es el ID del proyecto) no puede tener más de 63 caracteres y no puede empezar o terminar con un guion. Si la longitud combinada es mayor que 63 caracteres, es posible que veas Error DNS address could not be found.

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 enrutar las solicitudes a servicios y a versiones específicos. Para obtener más información, consulta Comunicación entre servicios.

Registro de las 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 210
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

También existe un límite en la cantidad de caracteres para la URL de tu aplicación.

Descripción Límite
Cantidad máxima de caracteres en la URL del proyecto para la URL VERSION-dot-SERVICE-dot-PROJECT_ID 63