Configura i container per i servizi

Console

1. Nella console Google Cloud , vai a Cloud Run:

   Vai a Cloud Run

2. Seleziona Servizi dal menu e fai clic su Esegui il deployment del contenitore per configurare un nuovo servizio. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment della nuova revisione.

3. Se stai configurando un nuovo servizio, compila la pagina delle impostazioni iniziali del servizio, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.

4. Fai clic sulla scheda Contenitore.

   

   • Specifica la porta a cui vuoi che vengano inviate le richieste, se non il valore predefinito di 8080. Viene impostata anche la variabile di ambiente PORT.

5. Fai clic su Crea o Esegui il deployment.

gcloud

Puoi aggiornare la configurazione della porta di un servizio utilizzando il seguente comando:

gcloud run services update SERVICE --port PORT

Sostituisci

• SERVICE con il nome del servizio.
• PORT con la porta a cui inviare le richieste. Tieni presente che la porta predefinita è 8080.

Puoi anche configurare le porte durante la distribuzione utilizzando il comando:

gcloud run deploy --image IMAGE_URL --port PORT

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 .

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

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

2. Aggiorna l'attributo containerPort::

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         name: REVISION
       spec:
         containers:
         - image: IMAGE_URL
           ports:
           - containerPort: PORT
   

   Sostituisci:

   • SERVICE con il nome del tuo servizio Cloud Run
   • 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 .
   • PORT con la porta a cui inviare le richieste
   • REVISION con un nuovo nome di revisione o eliminalo (se presente). Se fornisci un nuovo nome di revisione, questo deve soddisfare i seguenti criteri:
     • Inizia con SERVICE-
     • Contiene solo lettere minuscole, numeri e -
     • Non termina con -
     • Non supera i 63 caratteri

3. Sostituisci il servizio con la sua nuova configurazione utilizzando il seguente 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"

  template {
    containers {
      name = "hello-1"
      ports {
        container_port = PORT
      }
      image = "IMAGE_URL"
    }
  }
}

Sostituisci:

• SERVICE con il nome del tuo servizio Cloud Run.
• REGION con la regione Google Cloud . Ad esempio europe-west1.
• IMAGE_URL con un riferimento all'immagine container, ad esempio, us-docker.pkg.dev/cloudrun/container/hello
• PORT con la porta a cui inviare le richieste.

Console

1. Nella console Google Cloud , vai a Cloud Run:

   Vai a Cloud Run

2. Seleziona Servizi dal menu e fai clic su Esegui il deployment del contenitore per configurare un nuovo servizio. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica ed esegui il deployment della nuova revisione.

3. Se stai configurando un nuovo servizio, compila la pagina delle impostazioni iniziali del servizio, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.

4. Fai clic sulla scheda Contenitore.

   

   • Specifica il comando che vuoi che venga eseguito dal container, se non il comando definito nel container, e specifica facoltativamente gli argomenti del comando del punto di ingresso.

5. Fai clic su Crea o Esegui il deployment.

gcloud

Per aggiornare il comando di avvio e gli argomenti per un servizio esistente:

gcloud run services update SERVICE --command COMMAND --args ARG1,ARG-N

Sostituisci

• COMMAND con il comando con cui deve avviarsi il container se non utilizzi il comando predefinito.
• ARG1 con l'argomento che invii al comando del contenitore, utilizza un elenco delimitato da virgole per più di un argomento.

Per specificare il punto di ingresso e gli argomenti durante il deployment di un servizio nuovo o esistente:

gcloud run deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

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

Per cancellare tutti i comandi e gli argomenti del punto di ingresso che hai impostato (ripristina i valori predefiniti del container), fornisci stringhe vuote come segue:

gcloud run deploy --image IMAGE_URL --command "" --args ""

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

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

2. Aggiorna gli attributi command e args:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE_URL
           command:
           - COMMAND
           args:
           - ARG1
           - ARG-N

   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
   • COMMAND con il comando con cui deve essere avviato il container se non utilizzi il comando predefinito.
   • ARG1 con l'argomento che stai inviando al comando del contenitore. Se utilizzi più argomenti, specifica ciascuno su una riga separata, ad esempio come mostrato, ARG-N.

3. Sostituisci il servizio con la sua nuova configurazione utilizzando il seguente 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     = "cloudrun-service-containers"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      # Container "entry-point" command
      command = ["/server"]

      # Container "entry-point" args
      args = []
    }
  }
}

La risorsa google_cloud_run_v2_service precedente specifica un comando e gli argomenti. Sostituisci /server con il comando utilizzato per avviare il container e aggiungi gli argomenti necessari all'array args.

Console

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

   Vai a Cloud Run

   • Per un servizio esistente, fai clic sul servizio nell'elenco e seleziona Modifica ed esegui il deployment della nuova revisione per visualizzare il modulo di deployment della revisione.
   • Per un nuovo servizio, seleziona Servizi dal menu e fai clic su Deploy container per visualizzare il modulo Crea servizio.

2. Per un nuovo servizio, specifica il nome del servizio, l'URL del container di ingresso, l'allocazione della CPU, il controllo dell'ingresso e l'autenticazione. Nella scheda Container, volumi, networking, sicurezza, segui questi passaggi:

   1. Configura il contenitore di ingresso.
   2. Per aggiungere ciascuno degli altri contenitori che stai implementando, fai clic su Aggiungi contenitore.
   3. Per tutti i container tranne quello di Ingress, configura un controllo di integrità all'avvio. I container Ingress hanno un controllo di integrità di avvio predefinito.
   4. Se un container deve essere avviato dopo altri container, utilizza il menu Ordine di avvio del container per selezionare i container che devono essere avviati per primi.

3. Per un servizio esistente, segui questi passaggi:

   1. Per tutti i container tranne quello di Ingress, configura un controllo di integrità all'avvio. I container Ingress hanno un controllo di integrità di avvio predefinito.
   2. Ogni contenitore viene visualizzato con il proprio menu Ordine di avvio del contenitore. Se un container deve essere avviato prima di altri, utilizza il menu Ordine di avvio dei container per selezionare i container che devono essere avviati per primi.

4. Completa le altre configurazioni richieste, poi fai clic su Crea per un nuovo servizio o su Esegui il deployment per un servizio esistente. Attendi il completamento del deployment.

gcloud

Prima di utilizzare Google Cloud CLI per specificare l'ordine di avvio, devi configurare un controllo di integrità all'avvio per tutti i container, tranne quello di Ingress. I container in entrata hanno un controllo dell'integrità di avvio predefinito. Non puoi configurare i controlli di integrità utilizzando Google Cloud CLI.

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 con un ordine di avvio specificato, esegui il comando:

gcloud run deploy SERVICE \
     --container CONTAINER_1_NAME --image='INGRESS_IMAGE' --port='CONTAINER_PORT' \
     --container CONTAINER_2_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAME \
     --container CONTAINER_3_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAMECONTAINER_2_NAME

• Sostituisci SERVICE con il nome del servizio di cui stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome del servizio se lo ometti.
• Sostituisci CONTAINER_PORT con la porta in cui il container di ingresso ascolta le richieste in entrata. 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.
• Sostituisci INGRESS_IMAGE con un riferimento all'immagine container che deve ricevere le richieste, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest.

• Sostituisci 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.

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

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

2. Aggiorna l'attributo container-dependencies:

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     annotations:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/container-dependencies: '{"CONTAINER1":["CONTAINER2"], "CONTAINER3":["CONTAINER1","CONTAINER2"]}'
   

   Sostituisci

   • CONTAINER1 con il nome del primo contenitore che dipende da uno o più contenitori. Tieni presente che puoi impostare il nome del container nel file YAML: Cloud Run genererà automaticamente un nome se non ne viene specificato uno.
   • CONTAINER2 con il nome del contenitore che deve essere avviato prima di CONTAINER1.
   • CONTAINER3 con il nome del secondo container che dipende da uno o più container.

   Nell'esempio mostrato nello snippet YAML, CONTAINER2 viene avviato per primo, CONTAINER1 per secondo e CONTAINER3 per ultimo.

3. Sostituisci il servizio con la sua nuova configurazione utilizzando il seguente 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"

  template {
    containers {
      name = "CONTAINER1"
      ports {
        container_port = 8080
      }
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      depends_on = ["CONTAINER2"]
    }
    containers {
      name = "CONTAINER2"
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      env {
        name = "PORT"
        value = "8081"
      }
      startup_probe {
        http_get {
          port = 8081
        }
      }
    }
    containers {
      name = "CONTAINER3"
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      depends_on = ["CONTAINER1", "CONTAINER2"]
      env {
        name = "PORT"
        value = "8080"
      }
      startup_probe {
        http_get {
          port = 8080
        }
      }
    }
  }
}

Sostituisci:

• SERVICE con il nome del tuo servizio Cloud Run.
• REGION con la regione Google Cloud . Ad esempio europe-west1.
• CONTAINER1 con il nome del primo contenitore che dipende da uno o più contenitori.
• CONTAINER2 con il nome del container che deve essere avviato prima di CONTAINER1.
• CONTAINER3 con il nome del contenitore che dipende da CONTAINER1 e CONTAINER2.

Console

1. Nella console Google Cloud , vai a Cloud Run:

   Vai a Cloud Run

2. Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.

3. Fai clic sulla scheda Revisioni.

4. Nel riquadro dei dettagli a destra, l'impostazione del contenitore è elencata nella scheda Contenitore.

gcloud

1. Utilizza questo comando:

   gcloud run services describe SERVICE

2. Individua l'impostazione del contenitore nella configurazione restituita.