Organiza archivos de configuración YAML

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 tu 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 para 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.

Lee este documento para comprender cómo estructurar los servicios y recursos relacionados de tu aplicación en App Engine.

Estructura del directorio

Cada versión del servicio de App Engine se define en un archivo de configuración app.yaml. El requisito mínimo para la implementación, en el caso de las apps simples, es definir el archivo app.yaml. El archivo app.yaml actúa como un descriptor de implementación y define el tipo de escalamiento y los recursos de CPU, disco y memoria para una versión específica de un servicio. Si estás implementando distintas versiones de un servicio, puedes crear varios archivos YAML en el mismo directorio a fin de representar la configuración para cada versión.

Los archivos de configuración en el formato YAML se usan para los entornos de ejecución Eclipse Jetty 9 y Java 8.

La organización de los archivos depende de qué entorno de ejecución de Java uses. Es posible que necesites un archivo WAR o un archivo JAR, uno para cada servicio en la app. Consulta la guía para desarrolladores del entorno de ejecución de Java correspondiente a fin de obtener más detalles.

Consideraciones de diseño para el tiempo de actividad de las instancias

Las fallas de hardware o software que causan que la aplicación finalice antes de tiempo o las instancias se reinicien frecuentemente pueden ocurrir de improvisto, y su resolución puede llevar mucho tiempo. Tu aplicación debe manejar estas fallas.

A continuación se detallan algunas estrategias para evitar el tiempo de inactividad por reinicios de las instancias.

  • Reduce el tiempo que lleva reiniciar tus instancias o iniciar las nuevas.
  • Crea puntos de control de forma periódica para los cálculos de larga duración, a fin de permitirte reanudar el proceso desde ese estado.
  • La app debe ser "sin estado" para que no se almacene nada en la instancia.
  • Usa colas para ejecutar tareas asíncronas.
  • Si configuras tus instancias para el ajuste de escala manual, haz lo siguiente:
    • Usa el balanceo de cargas en varias instancias.
    • Configura más instancias de las necesarias para controlar un tráfico normal.
    • Escribe una lógica de resguardo que use resultados almacenados en caché cuando no esté disponible una instancia de ajuste de escala manual.

Obtén más información sobre las instancias en Cómo se administran las instancias.

El servicio default

Todas las aplicaciones de App Engine incluyen un servicio default. Debes implementar la versión inicial de la app en el servicio default para poder crear e implementar servicios adicionales en la app.

El servicio predeterminado se puede especificar de forma opcional en el archivo app.yaml con la configuración service: default.

Las solicitudes enviadas a la app mediante el proyecto de Cloud se envían al servicio default, por ejemplo, https://PROJECT_ID.REGION_ID.r.appspot.com. Para obtener más información sobre cómo orientar a otros servicios, consulta Establece comunicaciones entre servicios.

Archivos de configuración opcional

Los siguientes archivos de configuración controlan las funciones opcionales que se aplican a todos los servicios en una app individual. Consulta los siguientes temas para obtener más información sobre cada función opcional:

Consideraciones sobre el almacenamiento de archivos y datos

Desde App Engine, puedes acceder con facilidad a otros servicios de Google Cloud, como Datastore, Cloud SQL y Cloud Storage.

También puedes usar una base de datos externa o de terceros si es compatible con tu lenguaje y se puede acceder desde tu instancia de App Engine.

Para obtener más información sobre cómo almacenar archivos en Google Cloud o de forma externa, consulta Información sobre el almacenamiento de datos y archivos.

Además, puedes seleccionar la forma en que deseas entregar el contenido estático. Puedes entregar el contenido estático de la app directamente desde esa app en App Engine, alojar el contenido estático en una opción de Google Cloud como Cloud Storage, o usar una red de distribución de contenidos (CDN) de terceros. Para obtener más información sobre la entrega de contenido estático, consulta Entrega archivos estáticos.