Introducción: Configura tu entorno de desarrollo

Aprende a configurar tu entorno de compilación para el desarrollo y la implementación de apps en el entorno de ejecución de Java 8 en el entorno estándar de App Engine.

En esta guía, se muestra cómo realizar las siguientes tareas:

  • Instala Google Cloud CLI.
  • Instalar y configurar el complemento de App Engine para Maven App Engine también proporciona complementos para Gradle, IntelliJ IDEA y Eclipse, pero, en esta guía, se demuestra el complemento de Maven.
  • Crear un proyecto nuevo de App Engine
  • Otorgar permiso a Cloud Build para habilitar la compilación y la implementación de la app

Instala los SDK requeridos

  1. Si todavía no instalaste el SDK de Java SE 8, instala el kit de desarrollo de Java SE 8 (JDK).

  2. Instala e inicializa la versión más reciente de la CLI de gcloud.

    Instalar e inicializar la CLI de gcloud

  3. Instala el componente Java de App Engine:

    gcloud components install app-engine-java
    
  4. Autoriza tu cuenta de usuario:

    gcloud auth application-default login
    

Configura Maven en tu entorno de desarrollo

  1. Descarga Maven 3.5 o una versión posterior desde el sitio web de Maven.

  2. Instala Maven 3.5 o una versión más reciente en tu máquina local.

Crea un proyecto nuevo de App Engine

Para crear una aplicación de App Engine, sigue estos pasos:

  1. Crea un directorio nuevo.

  2. Inicializa el proyecto nuevo en el directorio creado:

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. Establece -Dappengine-version en la versión más reciente del SDK de App Engine para Java y application-id en el ID de tu proyecto de Google Cloud.

    2. Configura -Djava8=true para implementar el proyecto en el entorno de ejecución de Java 8.

    3. Configura -DCloudSDK_Tooling=true para usar las herramientas de gcloud CLI.

  3. Cuando se solicite elegir un arquetipo, elige el valor 2 para el arquetipo de App Engine. Esto crea un proyecto vacío que contiene la estructura de directorio y los archivos requeridos.

  4. Cuando se solicite la versión, presiona ENTER para seleccionar la versión predeterminada más reciente.

  5. Cuando debas configurar Define value for property 'groupId', proporciona el espacio de nombres que desees para tu aplicación, por ejemplo, com.mycompany.myapp.

  6. Cuando debas configurar Define value for property 'artifactId', ingresa el nombre del proyecto, por ejemplo, myapp.

  7. Cuando debas configurar Define value for property 'version', acepta el valor predeterminado.

  8. Cuando debas configurar Define value for property 'package', proporciona tu nombre de paquete preferido (o acepta el predeterminado). Los archivos de Java generados tendrán el nombre de paquete que especifiques aquí.

  9. Cuando se solicite confirmar tus elecciones, acepta el valor predeterminado (Y).

  10. Espera a que el proyecto se termine de generar y, luego, cambia los directorios al directorio del proyecto nuevo, por ejemplo, myapp/.

  11. Agrega el complemento basado en la CLI de gcloud al archivo pom.xml de tu proyecto.

    <build>
        <plugins>
           [...]
              <plugin>
                <groupId>com.google.cloud.tools</groupId>
                <artifactId>appengine-maven-plugin</artifactId>
                <version>2.4.4</version>
                <configuration>
                    <projectId>your-project-ID-goes-here</projectId>
                    <version>1</version>
                </configuration>
              </plugin>
           [...]
        </plugins>
    </build>
    
  12. Especifica el ID del proyecto de Google Cloud Platform de destino y el servicio y la versión en la configuración del complemento.

Otorga permiso a Cloud Build

Cuando implementas la app, App Engine usa Cloud Build para compilarla en un contenedor e implementar el contenedor en el entorno de ejecución. Cloud Build no tiene permiso para implementar apps de Java 8 de forma predeterminada, por lo que debes otorgar permiso a Cloud Build para implementar apps en tu proyecto. Las compilaciones se crean en la región de la app.

¿Qué sigue?

Ahora que el entorno de desarrollo está configurado, puedes comenzar a implementar y desarrollar apps de Java en App Engine.