Deployment delle immagini container in Cloud Run

Console

Per eseguire il deployment di un'immagine container:

1. Nella console Google Cloud , vai alla pagina Cloud Run:

   Vai a Cloud Run

2. Seleziona Servizi dal menu e fai clic su Esegui il deployment del contenitore per visualizzare il modulo Crea servizio.

   1. Nel modulo, seleziona l'opzione di deployment:

      1. Se vuoi eseguire il deployment manuale di un container, seleziona Esegui il deployment di una revisione da un'immagine container esistente e specifica l'immagine container.

      2. Se vuoi automatizzare il deployment continuo, seleziona Esegui il deployment continuo di nuove revisioni da un repository di codice sorgente e segui le istruzioni per i deployment continui.

   2. Inserisci il nome del servizio necessario. I nomi dei servizi devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto. Il nome del servizio non può essere modificato in seguito ed è visibile pubblicamente.

   3. Seleziona la regione in cui vuoi che si trovi il servizio. Il selettore di regioni indica il livello di prezzo, la disponibilità dei mapping dei domini ed evidenzia le regioni con il minore impatto di carbonio.

   4. Imposta la fatturazione in base alle esigenze.

   5. In Scalabilità del servizio, se utilizzi la scalabilità automatica predefinita di Cloud Run, specifica facoltativamente le istanze minime. Se utilizzi la scalabilità manuale, specifica il numero di istanze per il servizio.

   6. Imposta le impostazioni di Ingresso nel modulo in base alle esigenze.

   7. In Autenticazione, configura quanto segue:

      • Se stai creando un'API o un sito web pubblici, seleziona Consenti chiamate non autenticate. Se selezioni questa opzione, viene assegnato il ruolo Invoker IAM all'identificatore speciale allUser. Puoi utilizzare IAM per modificare questa impostazione in un secondo momento dopo aver creato il servizio.
      • Se vuoi un servizio sicuro protetto dall'autenticazione, seleziona Richiedi autenticazione.

3. Fai clic su Container, volumi, networking, sicurezza per impostare altre impostazioni facoltative nelle schede appropriate:

   • Contemporaneità
   • Configurazione del container
   • Limiti di CPU
   • Limiti di memoria
   • Timeout della richiesta
   • Secret
   • Variabili di ambiente
   • Ambiente di esecuzione
   • HTTP/2
   • Service account
   • Connessioni Cloud SQL
   • Connessione VPC

4. Al termine della configurazione del servizio, fai clic su Crea per eseguire il deployment dell'immagine in Cloud Run e attendi il completamento del deployment.

5. Fai clic sul link URL visualizzato per aprire l'endpoint unico e stabile del servizio di cui è stato eseguito il deployment.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Per eseguire il deployment di un'immagine container:

   1. Esegui questo comando:

      gcloud run deploy SERVICE --image IMAGE_URL

      • Sostituisci SERVICE con il nome del servizio in cui vuoi eseguire il deployment. I nomi dei servizi devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto. Se il servizio non esiste ancora, questo comando lo crea durante il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome del servizio se lo ometti.
      • Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG . Tieni presente che se non fornisci il flag --image, il comando di deployment tenterà di eseguire il deployment dal codice sorgente.

      Se stai creando un'API o un sito web pubblici, consenti le chiamate non autenticate del tuo servizio utilizzando il flag --allow-unauthenticated. In questo modo viene assegnato il ruolo IAM Invoker di Cloud Run a allUsers. Puoi anche specificare --no-allow-unauthenticated per non consentire chiamate non autenticate. Se ometti uno di questi flag, ti viene chiesto di confermare l'esecuzione del comando deploy.

   2. Attendi il completamento del deployment. Al completamento dell'operazione, viene visualizzato un messaggio di operazione riuscita insieme all'URL del servizio di cui è stato eseguito il deployment.

   Tieni presente che per eseguire il deployment in una posizione diversa da quella impostata utilizzando le proprietà run/region gcloud, utilizza:

   gcloud run deploy SERVICE --region REGION

YAML

Puoi archiviare la specifica del servizio in un file YAML e poi deployarlo utilizzando gcloud CLI.

1. Crea un nuovo file service.yaml con i seguenti contenuti:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

   Sostituisci

   • SERVICE con il nome del tuo servizio Cloud Run. I nomi dei servizi devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto.
   • IMAGE con l'URL dell'immagine container.

   Puoi anche specificare altre configurazioni, come variabili di ambiente o limiti di memoria.

2. Esegui il deployment del nuovo servizio utilizzando il seguente comando:

   gcloud run services replace service.yaml

3. Se vuoi consentire l'accesso non autenticato al servizio, rendilo pubblico.

Cloud Code

Per eseguire il deployment con Cloud Code, leggi le guide per IntelliJ e Visual Studio Code.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

  provider "google" {
    project = "PROJECT-ID"
  }

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"
    client   = "terraform"

    template {
      containers {
        image = "IMAGE"
      }
    }
  }

  resource "google_cloud_run_v2_service_iam_member" "noauth" {
    location = google_cloud_run_v2_service.default.location
    name     = google_cloud_run_v2_service.default.name
    role     = "roles/run.invoker"
    member   = "allUsers"
  }

Sostituisci:

• PROJECT-ID con l' Google Cloud ID progetto
• REGION con la regione Google Cloud
• SERVICE con il nome del tuo servizio Cloud Run. I nomi dei servizi devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto.
• IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

Questa configurazione consente l'accesso pubblico (l'equivalente di --allow-unauthenticated). Per rendere privato il servizio, rimuovi la sezione google_cloud_run_v2_service_iam_member.

Librerie client

Per eseguire il deployment di un nuovo servizio dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per eseguire il deployment di un nuovo servizio, invia una richiesta HTTP POST all'endpoint service dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services?serviceId=SERVICE

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per il deployment dei servizi. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza container.
• IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
• SERVICE con il nome del servizio di cui vuoi eseguire il deployment. I nomi dei servizi devono contenere al massimo 49 caratteri e devono essere univoci per regione e progetto.
• REGION con la regione Google Cloud del servizio.
• PROJECT-ID con l' Google Cloud ID progetto.

Console

Per eseguire il deployment di una nuova revisione di un servizio esistente:

1. Nella console Google Cloud , vai alla pagina Cloud Run:

   Vai a Cloud Run

2. Individua il servizio che vuoi aggiornare nell'elenco dei servizi e fai clic per aprire i relativi dettagli.

3. Fai clic su Modifica ed esegui il deployment di una nuova revisione per visualizzare il modulo di deployment della revisione.

   1. Se necessario, fornisci l'URL della nuova immagine del container di cui vuoi eseguire il deployment.

   2. Configura il contenitore in base alle esigenze.

   3. Imposta la fatturazione in base alle esigenze.

   4. In Capacità, specifica i limiti di memoria e i limiti di CPU.

   5. Specifica il timeout della richiesta e la contemporaneità in base alle esigenze.

   6. Specifica l'ambiente di esecuzione in base alle esigenze.

   7. In Scalabilità automatica, specifica le istanze minime e massime.

   8. Utilizza le altre schede in base alle esigenze per configurare facoltativamente:

      • Secret
      • Variabili di ambiente
      • HTTP/2
      • Service account
      • Connessioni Cloud SQL
      • Connessione VPC

4. Per inviare tutto il traffico alla nuova revisione, seleziona Pubblica questa revisione immediatamente. Per implementare gradualmente una nuova revisione, deseleziona la casella di controllo. Il risultato è un deployment in cui nessun traffico viene inviato alla nuova revisione. Segui le istruzioni per implementazioni graduali dopo il deployment.

5. Fai clic su Esegui il deployment e attendi il completamento del deployment.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Per eseguire il deployment di un'immagine container:

   1. Esegui il comando:

      gcloud run deploy SERVICE --image IMAGE_URL

      • Sostituisci SERVICE con il nome del servizio in cui esegui il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome del servizio se lo ometti.
      • Sostituisci IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .

      Il suffisso di revisione viene assegnato automaticamente per le nuove revisioni. Se vuoi fornire il tuo suffisso di revisione, utilizza il parametro --revision-suffix di gcloud CLI.

   2. Attendi il completamento del deployment. Al completamento dell'operazione, viene visualizzato un messaggio di operazione riuscita insieme all'URL del servizio di cui è stato eseguito il deployment.

YAML

Se devi scaricare o visualizzare la configurazione di un servizio esistente, utilizza il seguente comando per salvare i risultati in un file YAML:

gcloud run services describe SERVICE --format export > service.yaml

Da un file YAML di configurazione del servizio, modifica gli attributi secondari spec.template in base alle esigenze per aggiornare le impostazioni di revisione, quindi esegui il deployment della nuova revisione:

gcloud run services replace service.yaml

Cloud Code

Per eseguire il deployment di una nuova revisione di un servizio esistente con Cloud Code, consulta le guide per IntelliJ e Visual Studio Code.

Terraform

Assicurati di aver configurato Terraform come descritto nell'esempio Deployment di un nuovo servizio.

1. Apporta una modifica al file di configurazione.

2. Applica la configurazione Terraform:

   terraform apply

   Conferma di voler applicare le azioni descritte inserendo yes.

Librerie client

Per eseguire il deployment di una nuova revisione dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per eseguire il deployment di una nuova revisione, invia una richiesta HTTP PATCH all'endpoint service dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per il deployment delle revisioni. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza container.
• IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .
• SERVICE con il nome del servizio a cui esegui il deployment.
• REGION con la regione Google Cloud del servizio.
• PROJECT-ID con l' Google Cloud ID progetto.

Console

1. Nella console Google Cloud , vai alla pagina Cloud Run:

   Vai a Cloud Run

   • Per eseguire il deployment in un servizio esistente, individua il servizio nell'elenco dei servizi, fai clic per aprirlo, poi fai clic su Modifica ed esegui il deployment di una nuova revisione per visualizzare il modulo di deployment della revisione.
   • Seleziona Servizi dal menu e fai clic su Esegui il deployment del contenitore per visualizzare il modulo Crea servizio.

2. Per un nuovo servizio,

   1. Fornisci il nome del servizio e l'URL dell'immagine del container di ingresso di cui vuoi eseguire il deployment.
   2. Fai clic su Container, volumi, networking, sicurezza.

3. Nella scheda Modifica contenitore, configura il contenitore di ingresso in base alle esigenze.

4. Fai clic su Aggiungi contenitore e configura un contenitore sidecar da aggiungere insieme al contenitore di ingresso. Se il sidecar dipende da un altro container nel servizio, indicalo nel menu a discesa Ordine di avvio del container. Ripeti questo passaggio per ogni contenitore sidecar che stai eseguendo il deployment.

5. Per inviare tutto il traffico alla nuova revisione, seleziona Pubblica questa revisione immediatamente. Per un lancio graduale, deseleziona la casella di controllo. Il risultato è un deployment in cui non viene inviato traffico alla nuova revisione. Segui le istruzioni per le implementazioni graduali dopo l'implementazione.

6. Fai clic su Crea per un nuovo servizio o su Esegui il deployment per un servizio esistente, quindi attendi il completamento del deployment.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Per eseguire il deployment di più container in un servizio, esegui questo comando:

   gcloud run deploy SERVICE \
    --container INGRESS_CONTAINER_NAME \
    --image='INGRESS_IMAGE' \
    --port='CONTAINER_PORT' \
    --container SIDECAR_CONTAINER_NAME \
    --image='SIDECAR_IMAGE'

   Sostituisci:

   • SERVICE con il nome del servizio a cui esegui il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome del servizio se lo ometti.
   • INGRESS_CONTAINER_NAME con un nome per il contenitore che riceve le richieste, ad esempio app.
   • INGRESS_IMAGE con un riferimento all'immagine container che deve ricevere le richieste, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest.
   • CONTAINER_PORT con la porta in cui il container in entrata è in ascolto delle richieste in arrivo. A differenza di un servizio a singolo container, per un servizio contenente sidecar non esiste una porta predefinita per il container di ingresso. Devi configurare esplicitamente la porta del container per il container di ingresso e solo un container può avere la porta esposta.
   • SIDECAR_CONTAINER_NAME con un nome per il container sidecar, ad esempio sidecar.
   • SIDECAR_IMAGE con un riferimento all'immagine container sidecar

   Se vuoi configurare ogni contenitore nel comando di deployment, fornisci la configurazione di ciascun contenitore dopo i parametri container, ad esempio:

   gcloud run deploy SERVICE \
     --container CONTAINER_1_NAME \
     --image='INGRESS_IMAGE' \
     --set-env-vars=KEY=VALUE \
     --port='CONTAINER_PORT' \
     --container SIDECAR_CONTAINER_NAME \
     --image='SIDECAR_IMAGE' \
     --set-env-vars=KEY_N=VALUE_N

3. Attendi il completamento del deployment. Al termine dell'operazione, viene visualizzato un messaggio di operazione riuscita insieme all'URL del servizio di cui è stato eseguito il deployment.

YAML

Queste istruzioni mostrano un file YAML di base per il servizio Cloud Run con i sidecar. Crea un file denominato service.yaml e aggiungi quanto segue:

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  annotations:
  name: SERVICE
spec:
  template:
    spec:
      containers:
      - image: INGRESS_IMAGE
        ports:
          - containerPort: CONTAINER_PORT
      - image: SIDECAR_IMAGE
      

Sostituisci

• SERVICE con il nome del tuo servizio Cloud Run. I nomi dei servizi devono contenere al massimo 49 caratteri.
• CONTAINER_PORT con la porta in cui il container in entrata è in ascolto delle richieste in arrivo. A differenza di un servizio a singolo container, per un servizio contenente sidecar non esiste una porta predefinita per il container di ingresso. Devi configurare esplicitamente la porta del container per il container di ingresso e solo un container può avere la porta esposta.
• INGRESS_IMAGE con un riferimento all'immagine container che deve ricevere le richieste, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest.
• SIDECAR_IMAGE con un riferimento all'immagine container sidecar. Puoi specificare più sidecar aggiungendo altri elementi all'array containers nel file YAML.

Dopo aver aggiornato il file YAML in modo da includere i container Ingress e sidecar, esegui il deployment su Cloud Run utilizzando il comando:

gcloud run services replace service.yaml

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "REGION"
  ingress = "INGRESS_TRAFFIC_ALL"
  template {
    containers {
      name = "INGRESS_CONTAINER_NAME"
      ports {
        container_port = CONTAINER_PORT
      }
      image = "INGRESS_IMAGE"
      depends_on = ["SIDECAR_CONTAINER_NAME"]
    }
    containers {
      name = "SIDECAR_CONTAINER_NAME"
      image = "SIDECAR_IMAGE"
      }
    }
  }

CONTAINER_PORT rappresenta la porta su cui il container ingress rimane in ascolto delle richieste in entrata. A differenza di un servizio a contenitore singolo, per un servizio contenente sidecar, non esiste una porta predefinita per il contenitore di ingresso. Devi configurare esplicitamente la porta del container per il container di ingresso e solo un container può avere la porta esposta.