Implementa una aplicación alojada en contenedores en Cloud Run con Cloud Build

En esta página, se muestra cómo usar Cloud Build para implementar en Cloud Run una aplicación en contenedores.


Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

Guiarme


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

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. Habilita las API de Cloud Build, Cloud Run, Artifact Registry, and Compute Engine.

    Habilita las API

  5. Instala Google Cloud CLI.
  6. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init
  7. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  8. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  9. Habilita las API de Cloud Build, Cloud Run, Artifact Registry, and Compute Engine.

    Habilita las API

  10. Instala Google Cloud CLI.
  11. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init

Otorga permisos

Cloud Build requiere los permisos Administrador de Cloud Run y Usuario de la cuenta de servicio de IAM para poder implementar una imagen en Cloud Run.

  1. Abre una ventana de terminal.

  2. Configura las variables de entorno para almacenar el ID y el número del proyecto:

    PROJECT_ID=$(gcloud config list --format='value(core.project)')
    PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='value(projectNumber)')
    
  3. Otorga la función Administrador de Cloud Run a la cuenta de servicio de Cloud Build de la siguiente manera:

    gcloud projects add-iam-policy-binding $PROJECT_ID \
        --member=serviceAccount:$PROJECT_NUMBER@cloudbuild.gserviceaccount.com \
        --role=roles/run.admin
    
  4. Otorga la función Usuario de cuenta de servicio de IAM a la cuenta de servicio de Cloud Build en la cuenta de servicio del entorno de ejecución de Cloud Run mediante los pasos siguientes:

    gcloud iam service-accounts add-iam-policy-binding \
        $PROJECT_NUMBER-compute@developer.gserviceaccount.com \
        --member=serviceAccount:$PROJECT_NUMBER@cloudbuild.gserviceaccount.com \
        --role=roles/iam.serviceAccountUser
    

Implementa una imagen compilada con anterioridad

Puedes configurar Cloud Build para implementar en Cloud Run una imagen compilada con anterioridad almacenada en Artifact Registry.

Para implementar una imagen compilada con anterioridad sigue estos pasos:

  1. Abre una ventana de la terminal (si no está abierta).

  2. Crea un directorio nuevo llamado helloworld y navega hasta él:

    mkdir helloworld
    cd helloworld
    
  3. Crea un archivo llamado cloudbuild.yaml con el siguiente contenido: Este es el archivo de configuración de Cloud Build. Contiene instrucciones para que Cloud Build implemente la imagen denominada us-docker.pkg.dev/cloudrun/container/hello en el servicio Cloud Run llamado cloudrunservice.

    steps:
    - name: 'gcr.io/cloud-builders/gcloud'
      script: |
        gcloud run deploy cloudrunservice --image us-docker.pkg.dev/cloudrun/container/hello --region us-central1 --platform managed --allow-unauthenticated
  4. Para implementar la imagen, ejecuta el siguiente comando:

    gcloud builds submit --region=us-west2 --config cloudbuild.yaml
    

Cuando se complete la compilación, verás un resultado similar al siguiente:

DONE
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

ID                                    CREATE_TIME                DURATION  SOURCE                                                                                            IMAGES  STATUS
784653b2-f00e-4c4b-9f5f-96a5f115bef4  2020-01-23T14:53:13+00:00  23S       gs://cloudrunqs-project_cloudbuild/source/1579791193.217726-ea20e1c787fb4784b19fb1273d032df2.tgz  -       SUCCESS

Acabas de implementar la imagen hello en Cloud Run.

Ejecuta la imagen implementada

  1. Abre la página de Cloud Run en la consola de Google Cloud:

    Abrir la página de Cloud Run

  2. Selecciona tu proyecto y haz clic en Open.

    Verás la página Servicios de Cloud Run.

  3. En la tabla, busca la fila con el nombre cloudrunservice y haz clic en cloudrunservice.

    Se muestra la página Detalles del servicio (Service details) de cloudrunservice.

  4. Para ejecutar la imagen que implementó en cloudrunservice, haga clic en la URL:

    Captura de pantalla de la página de detalles del servicio de Cloud Run

¿Qué sigue?