Implementa en el entorno flexible de App Engine en Cloud Code para IntelliJ

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 OK.

    6. Agrega compatibilidad con el marco de trabajo flexible de App Engine.

Crea la configuración de implementación

  1. Selecciona Herramientas > Cloud Code > 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 para IntelliJ admite la implementación desde un artefacto de Maven, un artefacto específico de IntelliJ o un archivo 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á que accedas a la cuenta asociada con el proyecto de la consola de Google Cloud 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 OK.

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 la elipsis (…) junto al campo Dockerfile directory (Directorio de Dockerfile) para navegar hasta la ubicación de un archivo válido.

  6. Haz clic en OK.

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.

¿Qué sigue?

Obtener asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve aTools >Cloud Code >Help / About >Envía comentarios o informa un problema para informar un problema en GitHub o hacer una pregunta en Stack Overflow.