Guía de inicio rápido para Go 1.12+ 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 página, se muestra cómo implementar una aplicación básica de App Engine que muestra un mensaje corto. Si quieres ver una introducción más detallada de Go en 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

  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. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  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. 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. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  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

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:

    • Ejecuta el siguiente comando a fin de instalar el componente de gcloud, que incluye la extensión de App Engine para Go 1.12+:

      gcloud components install app-engine-go
      

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:

En esta guía de inicio rápido, se da por sentado que estás familiarizado con el lenguaje de programación Go y que instalaste Go.

Descarga la app de Hello World

Creamos una app de Hello World sencilla para Go a fin de que puedas familiarizarte con rapidez con la implementación de una app en Google Cloud. Sigue estos pasos para descargar la app de Hello World en tu máquina local.

Descarga la app de muestra y navega a su directorio:

  1. Clona el repositorio de la app de muestra Hello World:

    git clone https://github.com/GoogleCloudPlatform/golang-samples.git
    

    Como alternativa, descarga la muestra como un archivo ZIP y extráela.

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

    cd golang-samples/appengine/go11x/helloworld
    

Implementa Hello World en App Engine

  1. Para implementar la app de Hello World en App Engine, ejecuta el siguiente comando desde el directorio golang-samples/appengine/go11x/helloworld:

    gcloud app deploy
    
  2. Mira la app en vivo en https://PROJECT_ID.REGION_ID.r.appspot.com:

    gcloud app browse
    

Un servidor web que se ejecuta en una instancia de App Engine muestra el mensaje Hello, world!.

¡Felicitaciones! Implementaste un servicio web de Go en App Engine de forma correcta.

Realiza una limpieza

Si deseas seguir aprendiendo sobre App Engine, puedes conservar tu proyecto de Cloud y seguir las instrucciones para compilar una app.

Como alternativa, puedes borrar el proyecto de Cloud para detener la facturación de todos los recursos que se usaron en él.

  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

Ahora que tienes experiencia en la implementación de un servicio web en App Engine, lee Compila una app para obtener una introducción más detallada sobre Go en App Engine.