Guía de inicio rápido: Implementa en Cloud Run desde un repositorio de Git

Guía de inicio rápido: Implementa en Cloud Run desde un repositorio de Git

En esta página, se muestra cómo implementar de forma continua en Cloud Run desde un repositorio de Git.

---

Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:

GUIARME

---

Las instrucciones completas para este proceso se pueden encontrar en Implementación continua desde Git mediante Cloud Build.

Antes de comenzar

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.
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.
Make sure that you have the following role or roles on the project: Cloud Run Admin, Cloud Run Source Developer, Logs Viewer
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Ir a IAM
2. Selecciona el proyecto.
3. Haz clic en Otorgar acceso.

4. En el campo Principales nuevas, ingresa tu identificador de usuario. Esta suele ser la dirección de correo electrónico de una Cuenta de Google.

5. En la lista Seleccionar un rol, elige uno.
6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
7. Haz clic en Guardar.

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

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.

Make sure that you have the following role or roles on the project: Cloud Run Admin, Cloud Run Source Developer, Logs Viewer

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Ir a IAM
2. Selecciona el proyecto.
3. Haz clic en Otorgar acceso.

4. En el campo Principales nuevas, ingresa tu identificador de usuario. Esta suele ser la dirección de correo electrónico de una Cuenta de Google.

5. En la lista Seleccionar un rol, elige uno.
6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
7. Haz clic en Guardar.

1. Enable the Cloud Build API.

   Enable the API

2. Si estás bajo una política de la organización de restricción de dominios que restringe las invocaciones no autenticadas para tu proyecto, deberás acceder al servicio implementado como se describe en Prueba servicios privados.

3. Asegúrate de tener el rol de usuario de cuenta de servicio otorgado en la identidad del servicio. De forma predeterminada, la identidad del servicio es la cuenta de servicio predeterminada de Compute Engine.

   Otorga los roles

   Para otorgar acceso al recurso de identidad del servicio, usa el comando gcloud iam service-accounts add-iam-policy-binding, y reemplaza las variables destacadas por los valores adecuados:

         gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
             --member="PRINCIPAL" \
             --role="roles/iam.serviceAccountUser"
         

   Reemplaza lo siguiente:

   • SERVICE_ACCOUNT_EMAIL: La dirección de correo electrónico de la cuenta de servicio que usas como identidad de servicio, por ejemplo:
     • La cuenta de servicio predeterminada de Compute Engine: [e-mail]
     • Una cuenta de servicio que creaste: SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
   • PRINCIPAL: Es el identificador del usuario. Por lo general, esta es la dirección de correo electrónico de una Cuenta de Google.
4. Revisa los precios de Cloud Run o estima los costos con la calculadora de precios.

Crea un repositorio a partir de una plantilla

Para crear un repositorio, haz lo siguiente:

1. Ve al repositorio de plantillas:

   Node.js

   Ve a github.com/GoogleCloudPlatform/cloud-run-microservice-template-nodejs

   Python

   Ve a github.com/GoogleCloudPlatform/cloud-run-microservice-template-python

   Go

   Ve a github.com/GoogleCloudPlatform/cloud-run-microservice-template-go

   Java

   Ve a github.com/GoogleCloudPlatform/cloud-run-microservice-template-java

2. Haz clic en Usar esta plantilla.

3. Selecciona Crear un repositorio nuevo.

4. En el formulario, ingresa un nombre de repositorio.

5. Haz clic en Crear repositorio a partir de una plantilla.

Implementa desde el repositorio

Para implementar desde el repositorio, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página de Cloud Run:

   Ir a Cloud Run

2. Selecciona Servicios en el menú y haz clic en Implementar contenedor.

3. En Crear servicio, asegúrate de que la opción Implementar continuamente a partir de un repositorio esté seleccionada.

4. En el formulario, haz clic en Configurar Cloud Build.

5. En el panel derecho, haz lo siguiente:

   1. En Repositorio, selecciona el repositorio que acabas de crear. Si aún no te autenticaste, es posible que debas hacerlo. Usa el vínculo authenticate en el campo Proveedor del repositorio.

   2. Consulta el acuerdo de confirmación sobre la interactividad de GitHub y Google Cloud .

   3. Haz clic en Siguiente.

   4. En Tipo de compilación, selecciona Google Cloud Buildpacks.

   5. Haz clic en Guardar.

6. En el formulario Crear servicio, haz lo siguiente:

   1. Confirma el nombre del servicio. Se propagará automáticamente con el nombre del repositorio.

   2. En el menú desplegable Región, selecciona la región donde quieres que se ubique el servicio.

   3. En Autenticación, selecciona Permitir acceso público. Si no tienes permisos (rol de administrador de Cloud Run) para seleccionar esta opción, el servicio se implementará y requerirá autenticación.

   4. Haz clic en Crear para implementar el repositorio de muestra en Cloud Run y espera a que termine la implementación.

7. Haz clic en el vínculo de la URL que se muestra para ejecutar el contenedor implementado.

Ubicaciones de Cloud Run

Cloud Run es regional, lo que significa que la infraestructura que ejecuta los servicios se ubica en una región específica, y Google la administra para que esté disponible de manera redundante en todas las zonas de esa región.



El cumplimiento de los requisitos de latencia, disponibilidad o durabilidad es el factor principal para seleccionar la región en la que se ejecutan los servicios de Cloud Run. Por lo general, puedes seleccionar la región más cercana a tus usuarios, pero debes considerar la ubicación de los otros Google Cloud productos que usa tu servicio de Cloud Run. Si usas Google Cloud productos en varias ubicaciones, la latencia y el costo del servicio pueden verse afectados.



Cloud Run está disponible en las siguientes regiones:

Sujetas a los Precios del nivel 1

• asia-east1 (Taiwán)
• asia-northeast1 (Tokio)
• asia-northeast2 (Osaka)
• asia-south1 (Bombay, India)
• europe-north1 (Finlandia) Bajo nivel de CO₂
• europe-north2 (Estocolmo) Bajo nivel de CO₂
• europe-southwest1 (Madrid) Bajo nivel de CO₂
• europe-west1 (Bélgica) Bajo nivel de CO₂
• europe-west4 (Países Bajos) Bajo nivel de CO₂
• europe-west8 (Milán)
• europe-west9 (París) Bajo nivel de CO₂
• me-west1 (Tel Aviv)
• northamerica-south1 (México)
• us-central1 (Iowa) Bajo nivel de CO₂
• us-east1 (Carolina del Sur)
• us-east4 (Virginia del Norte)
• us-east5 (Columbus)
• us-south1 (Dallas) Bajo nivel de CO₂
• us-west1 (Oregón) Bajo nivel de CO₂

Sujetas a los Precios del nivel 2

• africa-south1 (Johannesburgo)
• asia-east2 (Hong Kong)
• asia-northeast3 (Seúl, Corea del Sur)
• asia-southeast1 (Singapur)
• asia-southeast2 (Yakarta)
• asia-south2 Delhi (India)
• australia-southeast1 (Sídney)
• australia-southeast2 (Melbourne)
• europe-central2 (Varsovia, Polonia)
• europe-west10 (Berlín) Bajo nivel de CO₂
• europe-west12 (Turín)
• europe-west2 (Londres, Reino Unido) Bajo nivel de CO₂
• europe-west3 (Fráncfort, Alemania)
• europe-west6 (Zúrich, Suiza) Bajo nivel de CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) Bajo nivel de CO₂
• northamerica-northeast2 (Toronto) Bajo nivel de CO₂
• southamerica-east1 (São Paulo, Brasil) Bajo nivel de CO₂
• southamerica-west1 (Santiago, Chile) Bajo nivel de CO₂
• us-west2 (Los Ángeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Si ya creaste un servicio de Cloud Run, puedes ver la región en el panel de Cloud Run en la consola.Google Cloud

Aceptar

Actualiza el servicio

Para realizar cambios en el servicio, sigue estos pasos:

1. Envía una confirmación a la rama principal del repositorio.

2. Actualiza el servicio de Cloud Run para ver el estado de la actualización.

Correcto: Implementaste una imagen de contenedor desde un repositorio de Git en Cloud Run.

Cloud Run ajusta automáticamente la escala de tus instancias de contenedor según la demanda, y solo pagas por la CPU, la memoria y las herramientas de redes que se consumen durante el procesamiento de solicitudes.

Limpia

Para evitar cargos adicionales en tu cuenta de Google Cloud , borra todos los recursos que implementaste con esta guía de inicio rápido.

Borra tu repositorio

Cloud Run no te cobra cuando no se usa el servicio implementado. Sin embargo, es posible que se te cobre por almacenar la imagen del contenedor en Artifact Registry. Para borrar repositorios de Artifact Registry, sigue los pasos que se indican en Borra repositorios en la documentación de Artifact Registry.

Borra tu servicio

Los servicios de Cloud Run no generan costos hasta que reciben solicitudes. Para borrar tu servicio de Cloud Run, sigue uno de estos pasos:

Console

Para borrar un servicio, debes hacer lo siguiente:

1. En la consola de Google Cloud , ve a Cloud Run:

   Ir a Cloud Run

2. Buscar el servicio que deseas borrar en la lista de servicios y hacer clic en su casilla de verificación para seleccionarlo

3. Haz clic en Borrar. Esta acción borra todas las revisiones del servicio

gcloud

Para borrar un servicio, ejecuta el siguiente comando:

gcloud run services delete SERVICE --region REGION

Reemplaza lo siguiente:

• SERVICE: Nombre de tu servicio.
• REGION: Google Cloud Región del servicio.

Borra tu proyecto de prueba

Si borras tu proyecto de Google Cloud , se detendrá la facturación de todos los recursos que contenga. Para liberar todos los recursos Google Cloud de tu proyecto, sigue estos pasos:

Precaución: Borrar un proyecto tiene las siguientes consecuencias:
• Se borra todo en el proyecto. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de 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.

¿Qué sigue?

• Guía de inicio rápido: Compila e implementa
• Implementación continua con Cloud Build
• Compila contenedores mediante Buildpacks