Guía de inicio rápido para Go 1.11 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. Incluir REGION_ID.r en las URL de App Engine es opcional en el caso de las apps existentes, y pronto será obligatorio para todas las apps nuevas.

A fin de garantizar una transición sin problemas, estamos actualizando App Engine de forma paulatina para usar los ID de región. Si aún no actualizamos tu proyecto de Google Cloud, no verás un ID de región para la app. Dado que el ID es opcional en las apps existentes, no es necesario que actualices las URL ni realices otros cambios una vez que el ID de región esté disponible en las apps existentes.

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 Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyecto

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. Habilita las Cloud Build API.

    Habilita la API

  5. Instala e inicializa el SDK de Cloud.

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.11:

      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 simple para Go, de manera que puedas familiarizarte rápidamente con el proceso de implementación en Google Cloud Platform. Sigue estos pasos para descargar Hello World en tu equipo local.

Descarga la app de muestra y navega al directorio de la app:

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

    go get -u -d github.com/GoogleCloudPlatform/golang-samples
    

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

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

    cd $GOPATH/src/github.com/GoogleCloudPlatform/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 Cloud Console, 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.