Crear una aplicación de Go 1.11 en el entorno estándar de App Engine

Crear una aplicación de Go 1.11 en el entorno estándar de App Engine

ID de región

El REGION_ID es un código abreviado que Google asigna en función de la región que selecciones al crear tu aplicación. El código no corresponde a un país o provincia, aunque algunos IDs de región pueden parecerse a los códigos de país y provincia que se usan habitualmente. En las aplicaciones creadas después de febrero del 2020, REGION_ID.r se incluye en las URLs de App Engine. En las aplicaciones creadas antes de esa fecha, el ID de región es opcional en la URL.

Más información sobre los IDs de región

Aceptar

En esta página se muestra cómo desplegar una aplicación básica de App Engine que muestre un mensaje breve. Para obtener una introducción más detallada a Go en App Engine, consulta el artículo Crear una aplicación.

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

Costes

No hay ningún coste asociado a esta guía. Si ejecutas esta aplicación de ejemplo por sí sola, no superarás tu cuota gratuita.

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Requisitos previos adicionales

1. Inicializa tu aplicación de App Engine con tu proyecto y elige su región:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

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

   Precaución: No puedes cambiar la región de una aplicación una vez que se haya definido.

2. Instala los siguientes requisitos previos:

   • Descarga e instala Git.

• Ejecuta el siguiente comando para instalar el componente gcloud que incluye la extensión 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 tus aplicaciones está ubicada en una región concreta y Google la gestiona para que esté disponible de forma redundante en todas las zonas de esa región.

Cumplir con los requisitos de latencia, disponibilidad o durabilidad son factores principales para seleccionar la región donde se ejecutan tus aplicaciones. Por lo general, puedes seleccionar la región más cercana a los usuarios de tu aplicación, pero debes tener en cuenta las ubicaciones en las que está disponible App Engine, así como las ubicaciones de los demásGoogle Cloud productos y servicios que utilice tu aplicación. Usar servicios en varias ubicaciones puede afectar a la latencia de tu aplicación, así como a su precio.

No es posible cambiar la región de una aplicación después de configurarla.

Nota: En los comandos de App Engine y en la Google Cloud consola,us-central se utilizan los nombres europe-west y us-central para dos ubicaciones, que en otras partes de la documentación de Google se denominan europe-west1 y us-central1, respectivamente.

Si ya has creado una aplicación de App Engine, puedes ver su región de una de las siguientes formas:

• Ejecuta el comando gcloud app describe.

• Abre el panel de control de App Engine en la Google Cloud consola. La región aparece cerca de la parte superior de la página.

Aceptar

En esta guía de inicio rápido se da por hecho que conoces el lenguaje de programación Go y que tienes Go instalado.

Descargar la aplicación Hello World

Hemos creado una aplicación Hello World sencilla para Go para que puedas familiarizarte rápidamente con el proceso de desplegar una aplicación en Google Cloud Platform. Sigue estos pasos para descargar Hello World en tu máquina local.

Descarga la aplicación de muestra y navega hasta el directorio de la aplicación:

1. Clona el repositorio de la aplicación de ejemplo Hello World:

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

   También puedes descargar la muestra como un archivo ZIP y extraerla.

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

   cd golang-samples/appengine/go11x/helloworld/
   

Desplegar Hello World en App Engine

1. Despliega la aplicación Hello World en App Engine ejecutando el siguiente comando desde el directorio golang-samples/appengine/go11x/helloworld:

   gcloud app deploy
   

2. Consulta la aplicación publicada en https://PROJECT_ID.REGION_ID.r.appspot.com:

   gcloud app browse
   

El mensaje Hello, World! ahora lo envía un servidor web que se ejecuta en una instancia de App Engine.

¡Enhorabuena! Has desplegado correctamente un servicio web de Go en App Engine.

Limpieza

Si quieres seguir aprendiendo sobre App Engine, puedes conservar tu proyecto y seguir las instrucciones de Crear una aplicación. Google Cloud

También puedes eliminar tu Google Cloud proyecto para dejar de recibir facturas por todos los recursos utilizados en él.

Precaución: Eliminar un proyecto tiene los siguientes efectos:
• Se elimina todo el contenido del proyecto. Si has usado un proyecto que ya existía para las tareas de este documento, cuando lo elimines, también se eliminará cualquier otro trabajo que hayas realizado en él.
• Se pierden los IDs de proyecto personalizados. Cuando creaste este proyecto, es posible que hayas creado un ID de proyecto personalizado que quieras usar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, elimina los recursos seleccionados dentro del proyecto en lugar de eliminar todo el proyecto.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Siguientes pasos

Ahora que ya tienes experiencia desplegando un servicio web en App Engine, puedes consultar una introducción más detallada a Go en App Engine leyendo el artículo Crear una aplicación.