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

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

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

---

Para seguir las instrucciones paso a paso de esta tarea directamente en la Google Cloud consola, haz clic en Ayúdame:

Guíame

---

Puedes consultar las instrucciones completas de este proceso en el artículo Despliegue continuo desde Git mediante Cloud Build.

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 role (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

Si vas a usar un proyecto que ya tengas para seguir esta guía, comprueba que tienes los permisos necesarios para completar la guía. Si has creado un proyecto, ya tienes los permisos necesarios.

Verify that billing is enabled for your Google Cloud project.

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 role (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

Si vas a usar un proyecto que ya tengas para seguir esta guía, comprueba que tienes los permisos necesarios para completar la guía. Si has creado un proyecto, ya tienes los permisos necesarios.

Verify that billing is enabled for your Google Cloud project.

1. 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

2. Si tu proyecto está sujeto a una política de organización de restricción de dominio que restringe las invocaciones no autenticadas, tendrás que acceder al servicio desplegado tal como se describe en la sección Probar servicios privados.

3. Consulta los precios de Cloud Run o calcula los costes con la calculadora de precios.

Roles obligatorios

Para obtener los permisos que necesitas para completar esta guía de inicio rápido, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

• Desarrollador de fuentes de Cloud Run (roles/run.sourceDeveloper) en el servicio
• Administrador de Cloud Run (roles/run.admin) en el proyecto
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser) en la identidad de servicio
• Visualizador de registros (roles/logging.viewer) en el proyecto

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear un repositorio a partir de una plantilla

Para crear un repositorio, sigue estos pasos:

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 Ejecutar en Google Cloud.

3. Selecciona Crear un repositorio.

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

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

Desplegar desde el repositorio

Para desplegar desde el repositorio, sigue estos pasos:

1. En la Google Cloud consola, ve a la página 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 Desplegar continuamente desde un repositorio esté seleccionada.

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

5. En el panel de la derecha:

   1. En Repository (Repositorio), selecciona el repositorio que acabas de crear. Si aún no te has autenticado, es posible que tengas que hacerlo. Usa el enlace Autenticar que aparece debajo del campo Proveedor de repositorio.

   2. Marca la casilla de confirmación sobre GitHub y la Google Cloud interactividad.

   3. Haz clic en Siguiente.

   4. En Build Type (Tipo de compilación), selecciona Google Cloud Buildpacks.

   5. Haz clic en Guardar.

6. En el formulario Crear servicio:

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

   2. En el menú desplegable Región, selecciona la región en la que quieres que se encuentre tu servicio.

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

   4. Haz clic en Crear para desplegar el repositorio de ejemplo en Cloud Run y espera a que se complete el despliegue.

7. Haga clic en el enlace 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 tus servicios de Cloud Run se encuentra en una región específica y Google la gestiona para que esté disponible de forma redundante en todas las zonas de esa región.



Cumplir los requisitos de latencia, disponibilidad o durabilidad es el factor principal a la hora de seleccionar la región en la que se ejecutan tus servicios de Cloud Run. Por lo general, puedes seleccionar la región más cercana a tus usuarios, pero debes tener en cuenta la ubicación de los otros Google Cloudproductos que utiliza tu servicio de Cloud Run. Usar Google Cloud productos juntos en varias ubicaciones puede afectar a la latencia y al coste de tu servicio.



Cloud Run está disponible en las siguientes regiones:

Con sujeción a los precios del nivel 1

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

Con sujeción 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, la India)
• australia-southeast1 (Sídney)
• australia-southeast2 (Melbourne)
• europe-central2 Varsovia (Polonia)
• europe-west10 (Berlín)
• europe-west12 (Turín)
• europe-west2 (Londres, Reino Unido) CO₂ bajo
• europe-west3 (Fráncfort, Alemania)
• europe-west6 (Zúrich, Suiza) Bajas emisiones de CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) CO₂ bajo
• northamerica-northeast2 (Toronto) CO₂ bajo
• southamerica-east1 (São Paulo, Brasil) CO₂ bajo
• southamerica-west1 (Santiago, Chile) CO₂ bajo
• us-west2 (Los Ángeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

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

Aceptar

Actualizar el servicio

Para hacer 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: has desplegado una imagen de contenedor desde un repositorio de Git en Cloud Run.

Cloud Run escala automáticamente tus instancias de contenedor en función de la demanda, y solo pagas por la CPU, la memoria y la red consumidas durante el procesamiento de las solicitudes.

Limpieza

Para evitar que se apliquen cargos adicionales a tu cuenta de Google Cloud , elimina todos los recursos que hayas desplegado con esta guía de inicio rápido.

Eliminar un repositorio

Cloud Run no te cobra cuando no se usa el servicio desplegado. Sin embargo, es posible que se te cobre por almacenar la imagen de contenedor en Artifact Registry. Para eliminar repositorios de Artifact Registry, sigue los pasos que se indican en el artículo Eliminar repositorios de la documentación de Artifact Registry.

Eliminar tu servicio

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

Consola

Para eliminar un servicio, sigue estos pasos:

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

   Ir a Cloud Run

2. Busca el servicio que quieras eliminar en la lista de servicios y marca la casilla correspondiente para seleccionarlo.

3. Haz clic en Eliminar. Se eliminarán todas las revisiones del servicio.

gcloud

Para eliminar un servicio, ejecuta el siguiente comando:

gcloud run services delete SERVICE --region REGION

Haz los cambios siguientes:

• SERVICE: nombre de tu servicio.
• REGION: Google Cloud región del servicio.

Eliminar un proyecto de prueba

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

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

• Guía de inicio rápido: compilar y desplegar
• Despliegue continuo con Cloud Build
• Crear contenedores con paquetes de compilación