Guía de inicio rápido para Java en el entorno estándar de App Engine

ID de región

REGION_ID es un código abreviado que Google asigna en función de la región que seleccionas cuando creas la app. El código no corresponde a un país ni a una provincia, aunque algunos ID de región puedan parecer similares a los códigos de país y provincia que se suelen usar. En el caso de las apps creadas después de febrero de 2020, REGION_ID.r se incluye en las URL de App Engine. En el caso de las apps existentes creadas antes de esta fecha, el ID de región es opcional en la URL.

Obtén más información acerca de los ID de región.

En esta guía de inicio rápido, se muestra cómo implementar una app de muestra en App Engine. Si deseas obtener más información sobre cómo programar una app para App Engine, consulta Compila una app.

¿App Engine es la opción de procesamiento adecuada para ti? Consulta otras opciones para alojar la aplicación en Google Cloud.

Costos

No hay costos asociados por usar esta guía. Ejecutar esta app de muestra por sí sola no supera tu cuota gratuita.

Antes de comenzar

En esta guía de inicio rápido, suponemos que instalaste Java SE 11 Development Kit (JDK).

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. Habilita Cloud Build API.

    Habilita la API

  5. Instala Google Cloud CLI.

  6. Para inicializar la CLI de gcloud, ejecuta el siguiente comando: 

    gcloud init
    7.

  7. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  8. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  9. Habilita Cloud Build API.

    Habilita la API

  10. Instala Google Cloud CLI.

  11. Para inicializar la CLI de gcloud, ejecuta el siguiente comando: 

    gcloud init
    12.

Requisitos previos adicionales

  1. Inicializa tu app de App Engine con el proyecto y selecciona su región:

    gcloud app create --project=[YOUR_PROJECT_ID]

    Cuando se te solicite, selecciona la región en la que deseas ubicar tu aplicación de App Engine.

  2. Instala los siguientes requisitos:

Ubicaciones de App Engine

App Engine es regional, lo que significa que la infraestructura que ejecuta las apps se encuentra en una región específica, y Google la administra para que esté disponible de forma redundante en todas las zonas dentro de esa región.

El cumplimiento de tus requisitos de latencia, disponibilidad o durabilidad debe ser un factor principal para seleccionar la región en la que se ejecutan las apps. Por lo general, puedes seleccionar la región más cercana a la de los usuarios de la app, pero debes considerar las ubicaciones en las que App Engine está disponible y las ubicaciones de los otros productos y servicios de Google Cloud que usa la app. Usar servicios en varias ubicaciones puede afectar la latencia de la app y sus precios.

No puedes cambiar la región de una app una vez configurada.

Si ya creaste una aplicación de App Engine, puedes ver su región mediante una de las siguientes opciones:

Descarga la app de Hello World

Creamos una app de Hello World sencilla para Java 11 a fin de que puedas familiarizarte con rapidez con la implementación de una app en Google Cloud.

  1. Clona el repositorio de la app de Hello World de muestra en la máquina local.

    git clone https://github.com/GoogleCloudPlatform/java-docs-samples

    De manera opcional, puedes descargar la muestra como un archivo ZIP y extraerla.

  2. Cambia al directorio que contiene el código de muestra.

    cd java-docs-samples/appengine-java11/springboot-helloworld

Ejecuta Hello World en tu máquina local

Para ejecutar la app de Hello World en la computadora local, haz lo siguiente:

  1. Inicia un servidor web local mediante el complemento de Maven para Spring Boot. 
    mvn spring-boot:run

  2. En el navegador web, ingresa la siguiente dirección:

    http://localhost:8080

    Nota: Si usas Cloud Shell, en la barra de herramientas, haz clic en Vista previa en la Web y selecciona Vista previa en el puerto 8080.

El mensaje de Hello World de la app de muestra aparece en la página. En la ventana de la terminal, presiona Ctrl + C para salir del servidor web.

Implementa y ejecuta Hello World en App Engine

Para implementar la app en el entorno estándar de App Engine, haz lo siguiente:

  1. Implementa la app de Hello World mediante la ejecución del siguiente comando desde el directorio springboot-helloworld: 

    gcloud app deploy

    Obtén más información sobre las marcas opcionales.

    Marcas comunes del comando de gcloud

    • Incluye la marca --version para especificar un ID que identifique esa versión de la app de forma única. De lo contrario, se generará uno para que lo uses. Por ejemplo: --version [YOUR_VERSION_ID].
    • Incluye la marca --project para especificar un ID del proyecto de Cloud alternativo al que inicializaste como predeterminado en la herramienta de gcloud. Por ejemplo: --project [YOUR_PROJECT_ID].

    Ejemplo:

    gcloud app deploy --version pre-prod-5 --project my-sample-app

    Para obtener más información sobre la implementación de la app desde la línea de comandos, consulta Prueba e implementa la app. Para obtener una lista de todas las marcas de comandos, consulta la referencia de gcloud app deploy.

  2. Inicia tu navegador para ver la app en https://PROJECT_ID.REGION_ID.r.appspot.com. 

    gcloud app browse
    En el ejemplo anterior, PROJECT_ID representa el ID del proyecto de Google Cloud.

Esta vez, la página que muestra el mensaje Hello World se envía mediante un servidor web que se ejecuta en una instancia de App Engine.

¡Felicitaciones! Implementaste tu primera app de Java 11 en el entorno estándar de App Engine.

Consulta las siguientes secciones a fin de obtener información sobre limpieza y vínculos a los siguientes pasos que podrías realizar.

Realiza una limpieza

A fin de evitar que se apliquen cargos, puedes borrar el proyecto de Cloud para detener la facturación de todos los recursos que se usan en ese proyecto.

  1. En la consola de Google Cloud, ve a la página Administrar recursos.

    Ir a Administrar recursos

  2. En la lista de proyectos, elige el proyecto que quieres borrar y haz clic en Borrar.
  3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

Próximos pasos

Conoce toda la plataforma

Ahora que sabes cómo implementar y desarrollar apps en App Engine, puedes explorar el resto de Google Cloud. Ya tienes la herramienta de línea de comandos de gcloud instalada, que te brinda las herramientas para interactuar con productos como Cloud SQL, Cloud Storage, Firestore y más.

Obtén información sobre el entorno estándar de App Engine

Aquí hay algunos temas para ayudarte a continuar tu aprendizaje sobre App Engine.