Cómo implementar y probar tu aplicación

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

Cómo ejecutar de manera local

Para probar la funcionalidad antes de implementar, ejecuta tu aplicación en tu entorno local con las herramientas para desarrolladores que usas con normalidad.

Si deseas obtener más información, incluidos los comandos específicos según tu complemento, consulta Pruebas locales para el entorno de ejecución de Java 8 o Jetty 9 o Pruebas locales del entorno de ejecución de Java 8.

Cómo implementar tu aplicación

Antes de comenzar

Antes de implementar tu aplicación:

Cómo implementar un servicio

Para implementar la aplicación de Java en el entorno flexible de App Engine, puedes usar cualquiera de las herramientas compatibles. Para la implementación de la línea de comandos, usa gcloud app deploy del SDK de Cloud o los complementos de Maven o Gradle. Para implementar con un IDE, usa los complementos de IntelliJ o Eclipse. Para implementar tus aplicaciones de manera programática, usa la API de administrador.

Cómo ignorar archivos

Puedes usar 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 tu implementación.

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

Cómo compilar manualmente un contenedor para la implementación

Para compilar un contenedor de imágenes fuera de Google Cloud Platform, primero debes subirlas a un repositorio de imágenes de contenedor antes de poder implementar tus imágenes en App Engine con el comando gcloud app deploy.

Por ejemplo, si compilas tus imágenes de contenedor de manera local con Docker, puedes enviarlas a Google Container Registry y, luego, especificar la URL de tu imagen en la marca --image-url del comando:

gcloud app deploy src/main/appengine/app.yaml --image-url gcr.io/YOUR_PROJECT_ID/YOUR_CONTAINER_IMAGE

Cómo utilizar la canalización de implementación continua y automática

Puedes utilizar Cloud Build para automatizar las implementaciones en las canalizaciones continuas. Para obtener más información, consulta Implementa artefactos y Automatiza compilaciones con activadores de compilación en la documentación de Cloud Build.

Imágenes base de Docker para Java

Si deseas crear una aplicación Java en un entorno de ejecución personalizado desde cero, usa una imagen base provista en tu Dockerfile:

Entorno de ejecución Comando Docker
Java 8 FROM gcr.io/google_appengine/openjdk
Java 8 / Jetty 9 FROM gcr.io/google-appengine/jetty

Cómo visualizar tu aplicación

Luego de que implementes tu aplicación en App Engine, puedes ejecutar el siguiente comando para iniciar el navegador y visualizarla en http://YOUR_PROJECT_ID.appspot.com:

gcloud app browse

Cómo realizar pruebas en App Engine

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

  1. Implementa tu versión nueva con el parámetro promote configurado como false:

  2. Accede a la nueva versión desde la siguiente URL:

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

    Ahora puedes probar tu nueva versión en el entorno de ejecución de App Engine. Para depurar tu aplicación, visualiza los registros en el Visor de registros de Stackdriver de Google Cloud Platform Console. Para obtener más información, consulta Escribe registros de aplicaciones.

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

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

    Cómo administrar versiones

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

Puedes usar 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 versiones y servicios específicos, consulta Cómo enrutar solicitudes.

Solución de problemas

El siguiente es un mensaje de error común que puedes encontrar cuando implementas aplicaciones:

PERMISSION_DENIED: Operation not allowed
The "appengine.applications.create" permission is required.
Si el proyecto de GCP no incluye la aplicación de App Engine requerida, el comando gcloud app deploy puede fallar cuando intentes ejecutar el comando gcloud app create. Solo las cuentas con función de Propietario tienen los permisos necesarios para crear aplicaciones de App Engine.