Implementa en el entorno flexible de App Engine

En este documento, se describe cómo implementar una aplicación de App Engine en el entorno flexible de App Engine desde IntelliJ IDEA.

Antes de comenzar

  • Sigue la guía Crea una app a fin de instalar y configurar Cloud Code, además de crear una app de App Engine para el entorno flexible. Asegúrate de agregar compatibilidad con el framework flexible de App Engine.

    Si no tienes una aplicación, pero aun así deseas probar estos procedimientos de implementación, descarga la app de muestra:

    1. Clona la app de muestra Spring Boot en tu máquina local:

       git clone https://github.com/spring-guides/gs-spring-boot
      
    2. En IntelliJ, selecciona Archivo > Abrir para abrir el selector de archivos.

    3. Navega hacia /gs-spring-boot/.

    4. Selecciona el directorio /complete/.

    5. Haz clic en Aceptar.

    6. Agrega compatibilidad con el framework flexible de App Engine.

Cómo crear la configuración de implementación

  1. Selecciona Tools(Herramientas) > Cloud Code (Cloud Code) > Deploy to App Engine (Implementar en App Engine).

    Cuadro de diálogo Crear la configuración de implementación Campos para Nombre, Servidor, Implementación, Proyecto, Versión y app.yaml

  2. Sigue las acciones a continuación para confirmar la configuración del servidor:

    1. Haz clic en la elipsis (…) junto al campo Server (Servidor).

    2. En el cuadro de diálogo, verifica que el campo Name (Nombre) muestre Google App Engine.

    3. Haz clic en Aceptar.

  3. Selecciona la fuente de Deployment (Implementación).

    Cloud Code admite implementaciones desde artefactos de Maven, artefactos nativos de IntelliJ o archivos JAR o WAR del sistema de archivos.

    1. Si seleccionas un archivo JAR o WAR del sistema de archivos como la fuente de tu implementación, haz clic en la elipsis (…) junto al campo Archivo de implementación para navegar a este.
  4. En el campo Project (Proyecto), selecciona uno.

    La primera vez que configures la implementación, se te solicitará acceder a la cuenta asociada con el proyecto de Cloud Console que deseas implementar.

  5. En la sección Configuración flexible de App Engine, selecciona un archivo app.yaml válido.

    1. Si no ves un archivo app.yaml válido en el menú desplegable, haz clic en Editar para seleccionar uno. Para obtener más información, consulta la sección Actualiza los parámetros de configuración flexible de App Engine.
  6. Llena los otros campos según sea necesario a fin de configurar la implementación.

  7. Haz clic en Run (Ejecutar) para compilar tu app y luego implementarla.

  8. En la ventana Servidores de la aplicación, haz clic en el nombre de tu proyecto para supervisar el progreso de su implementación. Si la ventana no se abre, haz clic en View (Ver) > Tool Windows (Ventanas de herramientas) > Application Servers (Servidores de la aplicación).

    Cuando la implementación se complete, podrás ver la URL de tu app en el resultado de la consola.

Implementa en un entorno de ejecución personalizado

Puedes modificar el archivo app.yaml a fin de implementar tu app en un entorno de ejecución personalizado mediante un archivo de Docker.

  1. En el archivo app.yaml, establece el entorno de ejecución en custom (personalizado).

  2. Cuando completes los pasos de crea la configuración de implementación, en la sección App Engine Flexible Configuration (Configuración flexible de App Engine), se mostrará la ruta de acceso a tu archivo app.yaml y al archivo Docker.

    Cuadro de diálogo en el que se muestra la sección de configuración flexible de App Engine de la pantalla de creación de la configuración de implementación Un campo en el que se muestra la ruta al archivo app.yaml Botón de edición para seleccionar otro archivo Una etiqueta que muestra el entorno de ejecución como personalizado Una etiqueta que muestra la ruta del archivo Docker Un campo Nombre del artefacto por etapas que muestra la ruta al archivo Docker

  3. Haz clic en Edit (Editar) para seleccionar archivos app.yaml y Docker válidos.

    Cuadro de diálogo en el que se muestra la sección de configuración flexible de App Engine de la pantalla de creación de la configuración de implementación Un campo en el que se muestra la ruta al archivo app.yaml Botón de edición para seleccionar otro archivo Una etiqueta que muestra el entorno de ejecución como personalizado Una etiqueta que muestra la ruta del archivo Docker Un campo Nombre del artefacto por etapas que muestra la ruta al archivo Docker

  4. Haz clic en los puntos suspensivos (…) junto a los campos app.yaml y Directorio de Dockerfile para navegar hasta los archivos correspondientes.

  5. Haz clic en Aceptar.

Actualiza la configuración flexible de App Engine

Después de crear la configuración inicial de la implementación, puedes modificarla según las necesidades de tu aplicación.

  1. Selecciona File (Archivo) > Project Structure (Estructura del proyecto).

    Aparecerá el cuadro de diálogo Project Structure (Estructura del proyecto).

  2. En Project Settings (Configuración del proyecto), selecciona Facets (Facetas).

  3. Selecciona la faceta flexible de App Engine.

  4. Para seleccionar un archivo app.yaml, haz clic en los puntos suspensivos (…) junto al campo app.yaml para navegar hasta la ubicación de un archivo válido.

  5. Si realizas una implementación en un entorno de ejecución personalizado, haz clic en los puntos suspensivos (…) junto al campo Directorio de Dockerfile para navegar hasta la ubicación de un archivo válido.

  6. Haz clic en Aceptar.

Borra el servidor

Si alguna vez deseas borrar el servidor que configuraste para tu proyecto, puedes hacerlo de la siguiente manera:

  1. Selecciona Archivo > Configuración > Compilación, Ejecución, Implementación > Nubes.

    En macOS, la ruta es IntelliJ IDEA > Preferencias > Compilación, Ejecución, Implementación > Nubes.

  2. Selecciona tu servidor (App Engine) y haz clic en el signo menos (-) de la parte superior de la ventana para quitarlo.

  3. Haz clic en Aceptar.

Próximos pasos

Obtén asistencia

Para enviar comentarios, informar problemas en GitHub o hacer preguntas en Stack Overflow.