Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare i container

Questa pagina descrive come configurare la porta del container, il comando del punto di ingresso e gli argomenti per i servizi Cloud Run.

Quando Cloud Run avvia un container, esegue il comando entrypoint predefinito dell'immagine e gli argomenti del comando predefiniti. Se vuoi eseguire l'override degli argomenti del comando e del punto di ingresso predefiniti dell'immagine, puoi utilizzare i campi command e args nella configurazione del container. Il campo command specifica il comando effettivo eseguito dal container. Il campo args specifica gli argomenti passati al comando.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment dei servizi Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Sviluppatore Cloud Run (roles/run.developer) sul servizio Cloud Run
Utente account di servizio (roles/iam.serviceAccountUser) sull'identità del servizio

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il servizio Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestione dell'accesso.

Configura la porta del container

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche per le revisioni successive verrà applicata automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.

Per i servizi Cloud Run, Cloud Run inserisce la variabile di ambiente PORT nel container. Se esegui il deployment di più container in un servizio, questo sarà il container in entrata. Il container rimane in ascolto sulla porta definita dalla variabile di ambiente PORT, anziché su una porta specifica con hardcoded. Se questo non è possibile, configura l'ascolto in modo che venga eseguito sulla porta che invia le richieste al container. Tieni presente che le impostazioni della porta non si applicano ai job Cloud Run.

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio e poi su Modifica ed esegui il deployment di nuova revisione.
Se stai configurando un nuovo servizio, compila la pagina iniziale delle impostazioni del servizio in base alle tue esigenze, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.
Fai clic sulla scheda Contenitore.
- Specifica la porta a cui vuoi che vengano inviate le richieste, se non il valore predefinito di 8080. Imposta anche la variabile di ambiente PORT.
Fai clic su Crea o Esegui il deployment.

Riga di comando

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 il deployment 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, è necessario già creare il repository REPO_NAME. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

YAML

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
```
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, è necessario già creare il repository REPO_NAME. 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 oppure eliminala (se presente). Se specifichi un nuovo nome, la revisione deve soddisfare i seguenti criteri:
  - Inizia con SERVICE-
  - Contiene solo lettere minuscole, numeri e -
  - Non termina con -
  - Non supera i 63 caratteri
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Configura punto di ingresso e argomenti

Il comando e gli argomenti del container specificati sostituiscono l'immagine predefinita ENTRYPOINT e CMD.

Puoi impostare il comando e gli argomenti del punto di ingresso utilizzando la console Google Cloud, Google Cloud CLI o un file YAML quando crei un nuovo servizio o esegui il deployment di una nuova revisione:

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio e poi su Modifica ed esegui il deployment di nuova revisione.
Se stai configurando un nuovo servizio, compila la pagina iniziale delle impostazioni del servizio in base alle tue esigenze, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.
Fai clic sulla scheda Contenitore.
- Specifica il comando che deve essere eseguito dal container, se non è quello definito nel container, e, facoltativamente, specifica gli argomenti per il comando del punto di ingresso.
Fai clic su Crea o Esegui il deployment.

Riga di comando

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

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

Sostituisci

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 container, 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

Per cancellare eventuali comandi e argomenti del punto di ingresso che hai impostato (ripristino alle impostazioni predefinite del container), fornisci stringhe vuote come segue:

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

YAML

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
```
Aggiorna gli attributi command e args:
```
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, è necessario già creare il repository REPO_NAME. 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 usi il comando predefinito.
- ARG1 con l'argomento che stai inviando al comando container. Se utilizzi più argomenti, specifica ciascuno su una riga separata, ad esempio, come mostrato, ARG-N.
Sostituisci il servizio con la 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.

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

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-containers"
  location = "us-central1"

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

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

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

Utilizza i segni di uguale o le virgole negli argomenti

Se utilizzi simboli di uguale negli argomenti, forniscili utilizzando il seguente formato:

gcloud run deploy  \
  --args="--repo-allowlist=github.com/example/example_demo"

Se gli argomenti utilizzano le virgole, consulta la sezione Configurazione delle variabili di ambiente per maggiori dettagli sull'escape.

Configura l'ordine di avvio dei container per i deployment collaterali

Per specificare l'ordine di avvio dei container in un deployment collaterale, utilizza la funzionalità delle dipendenze dei container. Specifica i container che hanno dipendenze ed elenca i container da cui dipendono. Questi container vengono avviati per primi. I container senza dipendenze vengono sempre avviati per primi e contemporaneamente.

Devi utilizzare probe di controllo di integrità all'avvio se vuoi utilizzare correttamente questa funzionalità. Il probe di avvio consente a Cloud Run di ispezionare l'integrità di un container dipendente, assicurandosi che venga superato prima di avviare il container successivo. Se non utilizzi i controlli di integrità, i container vengono avviati nell'ordine specificato anche se i container da cui dipendono non si avviano.

Tieni presente che i container in entrata hanno un probe di controllo di integrità all'avvio predefinito.

Puoi utilizzare la console Google Cloud, Google Cloud CLI o YAML per specificare l'ordine di avvio:

Console

Vai a Cloud Run
- Per un servizio esistente, fai clic sul servizio nell'elenco e seleziona Modifica ed esegui il deployment di nuova revisione per visualizzare il modulo di deployment della revisione.
- Per un nuovo servizio, fai clic su Crea servizio.
Per un nuovo servizio, specifica il nome del servizio, l'URL del container in entrata, l'allocazione della CPU, il controllo in entrata e l'autenticazione, quindi fai clic su Container, volumi, networking, sicurezza.
Per un nuovo servizio, nella scheda Container, volumi, networking, sicurezza, segui questi passaggi:
1. Configura il container in entrata.
2. Per aggiungere ogni altro container di cui stai eseguendo il deployment, fai clic su Aggiungi container.
3. Per tutti i container tranne il container in entrata, configura un controllo di integrità dell'avvio. I container in entrata hanno un controllo di integrità predefinito dell'avvio.
4. Se un container ha bisogno che altri container vengano avviati prima di poter essere avviato, utilizza il menu Ordine di avvio del container per selezionare i container che devono essere avviati per primi.
Per un servizio esistente, segui questi passaggi:
1. Per tutti i container tranne il container in entrata, configura un controllo di integrità dell'avvio. I container in entrata hanno un controllo di integrità predefinito dell'avvio.
2. Ogni container è visualizzato con il proprio menu Ordine di avvio del container. Se un container ha bisogno che altri container vengano avviati prima di poter essere avviato, utilizza il menu Ordine di avvio del container per selezionare i container che devono essere avviati per primi.
Completa le eventuali altre configurazioni richieste, quindi fai clic su Crea per un nuovo servizio o su Esegui il deployment per un servizio esistente. Attendi il completamento del deployment.

Riga di comando

I parametri container in Google Cloud CLI sono in anteprima.

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

Nella console Google Cloud, attiva Cloud Shell.

Attiva Cloud Shell

Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
Per eseguire il deployment di più container in un servizio con un ordine di avvio specificato, esegui questo comando:

gcloud run deploy SERVICE \
     --container CONTAINER_1_NAME --image='INGRESS_IMAGE' \
     --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 in cui stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma se lo ometti ti verrà richiesto il nome del servizio.
Sostituisci INGRESS_IMAGE con un riferimento all'immagine container che dovrebbe ricevere le richieste, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest.
Sostituisci SIDECAR_IMAGE con un riferimento all'immagine del container collaterale

Se vuoi configurare ogni container nel comando di deployment, fornisci la configurazione di ogni container dopo i parametri container.

YAML

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
```
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 container che dipende da uno o più container. Tieni presente che puoi impostare il nome del container in YAML: Cloud Run genererà automaticamente un nome se non è specificato.
- CONTAINER2 con il nome del container che deve essere avviato prima del giorno 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 viene avviato per secondo e CONTAINER3 viene avviato per ultimo.
Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Visualizza impostazioni contenitore

Per visualizzare le impostazioni attuali del container per il tuo servizio Cloud Run:

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.
Fai clic sulla scheda Revisioni.
Nel riquadro dei dettagli a destra, l'impostazione del contenitore è elencata nella scheda Contenitore.

Riga di comando

Utilizza il seguente comando:
```
gcloud run services describe SERVICE
```
Individua l'impostazione del container nella configurazione restituita.