Implementa y prueba tu aplicación

Aprende a ejecutar, implementar y probar tu aplicación de manera local en App Engine.

Ejecuta de manera local

Para probar la funcionalidad antes de la implementación, ejecuta tu aplicación en un entorno local con las herramientas para desarrolladores que sueles utilizar.

Por ejemplo, npm start.

Implementa tu aplicación

Implementa tu aplicación en App Engine con el comando gcloud app deploy.

Durante la implementación, el servicio Cloud Build compila una imagen de contenedor de la aplicación para ejecutar en el entorno estándar de App Engine. Obtén más información en Administra imágenes de compilación.

Para implementar tus aplicaciones de manera programática, utiliza la API de Administrador.

Antes de comenzar

Antes de implementar tu aplicación, se deben cumplir estos requisitos:

Implementa un servicio

Para implementar la aplicación en App Engine debes implementar versiones de los servicios de tu aplicación y cada uno de sus archivos de configuración.

Para implementar una versión del servicio de tu aplicación, ejecuta el comando a continuación desde el directorio en el que se encuentra el archivo app.yaml de tu servicio.

gcloud app deploy

Si no especificas archivos con este comando, solo se implementa el archivo app.yaml en tu directorio actual. Según la configuración predeterminada, el comando deploy genera un ID único para la versión, la implementa en el proyecto de GCP en el que configuraste la herramienta gcloud y enruta todo el tráfico a la versión nueva.

Puedes cambiar el comportamiento predeterminado del comando si orientas los archivos específicos o incluyes los parámetros adicionales.

  • Para implementar los demás archivos de configuración de tu servicio, debes implementar y orientar cada archivo por separado. Por ejemplo:

    gcloud app deploy cron.yaml
    gcloud app deploy dispatch.yaml
    gcloud app deploy index.yaml
    
  • Para especificar un ID de versión personalizada, utiliza el marcador --version.

  • Para evitar que el tráfico se enrute automáticamente a la versión nueva, utiliza el marcador --no-promote.

  • Para implementar en un proyecto de GCP específico, utiliza el marcador --project.

Por ejemplo, para implementar el servicio definido mediante app.yaml en un proyecto de GCP específico, asígnalo a un ID de versión personalizada y evita que el tráfico se enrute a la versión nueva:

gcloud app deploy --project PROJECT_ID --version VERSION_ID --no-promote

Para obtener más información sobre este comando, consulta la referencia de gcloud app deploy.

Implementa varios servicios

Se utiliza el mismo comando de implementación para implementar o actualizar varios servicios que conforman tu aplicación.

Para implementar varios servicios, debes implementar el archivo app.yaml de cada servicio por separado. Por ejemplo:

gcloud app deploy service1/app.yaml
gcloud app deploy service2/app.yaml

Puedes especificar varios archivos con un comando de implementación único:

gcloud app deploy service1/app.yaml service2/app.yaml

Requisitos para implementar varios servicios

  • En primera instancia, debes implementar una versión de tu aplicación en el servicio default antes de poder crear y, luego, implementar servicios posteriores.

  • El ID de cada uno de tus servicios se debe especificar en los archivos de configuración app.yaml correspondientes. Para especificar el ID del servicio, incluye la definición del elemento service en cada archivo de configuración. Según la configuración predeterminada, se implementa la versión en el servicio default si se excluye esta definición de elemento de tu archivo de configuración.

Omite archivos

Puedes utilizar un archivo .gcloudignore para especificar que los archivos y directorios no se suban a GCP cuando implementes tus servicios. Esto es útil para ignorar artefactos de compilación y otros archivos que no necesitan subirse con la implementación.

Si no tienes un archivo .gcloudignore en el directorio de tu servicio, la herramienta gcloud crea automáticamente un archivo .gcloudignore predeterminado cuando lo implementas. El archivo predeterminado contiene los siguientes archivos y directorios:

.gcloudignore
.git
.gitignore
node_modules/

Los archivos y directorios que se enumeran no se subirán a GCP.

Obtén más información sobre la sintaxis del archivo .gcloudignore en la referencia de gcloud.

Administra imágenes

Cada vez que implementas una versión nueva, se crea una imagen de contenedor con el servicio Cloud Build. Esa imagen de contenedor luego se ejecuta en el entorno estándar de App Engine.

Las imágenes de contenedor compiladas se almacenan en la carpeta app-engine en Container Registry. Puedes descargar estas imágenes para mantenerlas o ejecutarlas en otro lugar. Una vez que se complete la implementación, App Engine no necesitará las imágenes de contenedor. Ten en cuenta que no se borran automáticamente, por lo que puedes borrar con seguridad cualquier imagen que no necesites para evitar que alcancen tu cuota de almacenamiento. Para obtener más información sobre cómo administrar imágenes en Container Registry, consulta la documentación de Container Registry.

Ve tu aplicación

Después de implementar tu aplicación en App Engine, puedes ejecutar el siguiente comando para iniciar tu navegador y verlo en http://YOUR_PROJECT_ID.appspot.com:

gcloud app browse

Realiza pruebas en App Engine

Antes de configurar una versión nueva para recibir tráfico, puedes probarla en App Engine. Por ejemplo, si deseas probar una nueva versión de tu servicio default:

  1. Implementa tu versión nueva y, luego, incluye el marcador --no-promote:

    gcloud app deploy --no-promote
  2. Accede a la versión nueva desde esta URL:

    http://VERSION_ID.default.YOUR_PROJECT_ID.appspot.com
    

    Ahora puedes probar tu versión nueva en el entorno de ejecución de App Engine. Puedes depurar tu aplicación cuando ves sus registros. Para obtener más información, consulta Escribe registros de aplicaciones.

    Las solicitudes enviadas a http://YOUR_PROJECT_ID.appspot.com se enrutarán a la versión configurada anteriormente para recibir tráfico.

  3. Cuando desees enviar tráfico a la versión nueva, utiliza GCP Console para migrarlo:

    Administrar versiones

    Selecciona la versión que acabas de implementar y haz clic en Migrar tráfico.

Puedes utilizar el mismo proceso para probar las versiones nuevas de otros servicios si reemplazas default en la URL por el nombre de tu servicio:

http://VERSION_ID.SERVICE_ID.YOUR_PROJECT_ID.appspot.com

Para obtener más información sobre cómo orientar servicios y versiones, consulta: Cómo se enrutan las solicitudes.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del entorno estándar de App Engine para Node.js