Esegui il deployment di un'applicazione containerizzata in Cloud Run utilizzando Cloud Build

Questa pagina mostra come utilizzare Cloud Build per eseguire il deployment di un'applicazione containerizzata in Cloud Run.

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

    Go to project selector

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

  4. Enable the Cloud Build, Cloud Run, Artifact Registry, and Compute Engine APIs.

    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 APIs

  5. Installa Google Cloud CLI.

  6. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  7. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

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

    Go to project selector

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

  10. Enable the Cloud Build, Cloud Run, Artifact Registry, and Compute Engine APIs.

    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 APIs

  11. Installa Google Cloud CLI.

  12. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  13. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

Concedi le autorizzazioni

Cloud Build richiede diverse autorizzazioni prima di poter eseguire il deployment di un'immagine in Cloud Run. Per concedere queste autorizzazioni:

  1. Apri una finestra del terminale.

  2. Imposta le variabili di ambiente per memorizzare l'ID e il numero del progetto.

    PROJECT_ID=$(gcloud config list --format='value(core.project)')
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='value(projectNumber)')

  3. Concedi il ruolo Amministratore di Cloud Run al tuo service account Cloud Build.

    gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
    --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
    --role=roles/run.admin \

  4. Concedi il ruolo Storage Object User al tuo account di serviziot Cloud Build.

    gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
    --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
    --role=roles/storage.objectUser \

  5. Concedi il ruolo Utente account di servizio al tuo service account Cloud Build.

    gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member=serviceAccount:$(gcloud projects describe $PROJECT_ID \
    --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
    --role=roles/iam.serviceAccountUser

Esegui il deployment di un'immagine predefinita

Puoi configurare Cloud Build in modo da eseguire il deployment in Cloud Run di un'immagine predefinita archiviata in Artifact Registry.

Per eseguire il deployment di un'immagine predefinita:

  1. Apri una finestra del terminale (se non è già aperta).

  2. Crea una nuova directory denominata helloworld e accedi alla directory:

    mkdir helloworld
cd helloworld

  3. Crea un file denominato cloudbuild.yaml con i seguenti contenuti. Questo file è il file di configurazione di Cloud Build. Contiene le istruzioni per Cloud Build per eseguire il deployment dell'immagine denominata us-docker.pkg.dev/cloudrun/container/hello nel servizio Cloud Run denominato 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. Esegui il deployment dell'immagine lanciando questo comando:

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

Al termine della build, vedrai un output simile al seguente:

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

Hai appena eseguito il deployment dell'immagine hello in Cloud Run.

Esegui l'immagine di cui hai effettuato il deployment

  1. Apri la pagina Cloud Run nella console Google Cloud :

    Apri la pagina Cloud Run

  2. Seleziona il progetto e fai clic su Apri.

    Viene visualizzata la pagina Servizi Cloud Run.

  3. Nella tabella, individua la riga denominata cloudrunservice e fai clic su cloudrunservice.

    Viene visualizzata la pagina Dettagli del servizio per cloudrunservice.

  4. Per eseguire l'immagine di cui hai eseguito il deployment su cloudrunservice, fai clic sull'URL:

    Screenshot della pagina dei dettagli del servizio Cloud Run

Passaggi successivi