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

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

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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 Conceder acceso.

    4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    5. En la lista Selecciona un rol, elige un rol.
    6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
    7. Haz clic en Guardar.

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

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. 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 Conceder acceso.

    4. En el campo Nuevos principales, introduce tu identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    5. En la lista Selecciona un rol, elige un rol.
    6. Para conceder más roles, haz clic en Añadir otro rol y añade cada rol adicional.
    7. Haz clic en Guardar.

  8. Enable the Cloud Build API.

    Enable the API

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

  10. Asegúrate de que tienes asignado el rol Usuario de cuenta de servicio en la identidad de servicio. De forma predeterminada, la identidad de servicio es la cuenta de servicio predeterminada de Compute Engine.

    Conceder los roles

    Para conceder acceso al recurso de identidad de servicio, usa el comando gcloud iam service-accounts add-iam-policy-binding y sustituye las variables destacadas por los valores correspondientes:

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

    Haz los cambios siguientes:

    • SERVICE_ACCOUNT_EMAIL: la dirección de correo de la cuenta de servicio que usas como identidad de servicio, como:
      • Cuenta de servicio predeterminada de Compute Engine: PROJECT_NUMBER-compute@developer.gserviceaccount.com
      • Una cuenta de servicio que has creado: SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
    • PRINCIPAL: el identificador de usuario. Normalmente, se trata de la dirección de correo de una cuenta de Google.

    11. Crear un repositorio a partir de una plantilla

    Para crear un repositorio, sigue estos pasos:

    1. Ve al repositorio de plantillas:

    2. Haz clic en Usar esta plantilla.

    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 tus requisitos de latencia, disponibilidad o durabilidad son factores primordiales para 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) icono de una hoja CO2 bajo
    • europe-north2 (Estocolmo) icono de una hoja CO2 bajo
    • europe-southwest1 (Madrid) icono de una hoja CO2 bajo
    • europe-west1 (Bélgica) icono de una hoja CO2 bajo
    • europe-west4 (Países Bajos) icono de una hoja CO2 bajo
    • europe-west8 (Milán)
    • europe-west9 (París) icono de una hoja CO2 bajo
    • me-west1 (Tel Aviv)
    • northamerica-south1 (México)
    • us-central1 (Iowa) icono de una hoja CO2 bajo
    • us-east1 (Carolina del Sur)
    • us-east4 (Norte de Virginia)
    • us-east5 (Columbus)
    • us-south1 (Dallas) icono de una hoja CO2 bajo
    • us-west1 (Oregón) icono de una hoja CO2 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) icono de una hoja CO2 bajo
    • europe-west12 (Turín)
    • europe-west2 (Londres, Reino Unido) icono de una hoja CO2 bajo
    • europe-west3 (Fráncfort, Alemania)
    • europe-west6 (Zúrich, Suiza) icono de una hoja CO2 bajo
    • me-central1 (Doha)
    • me-central2 (Dammam)
    • northamerica-northeast1 (Montreal) icono de una hoja CO2 bajo
    • northamerica-northeast2 (Toronto) icono de una hoja CO2 bajo
    • southamerica-east1 (São Paulo, Brasil) icono de una hoja CO2 bajo
    • southamerica-west1 (Santiago, Chile) icono de una hoja CO2 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.

    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.

    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.

    Siguientes pasos