Esta página se ha traducido con Cloud Translation API.
Switch to English

Guía de inicio rápido: implementación

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

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir a la página del selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

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

    Habilita las API

  5. Instala e inicializa el SDK de Cloud.

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'
      args:
      - '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 --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 Cloud Run en Cloud Console.

    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?