Configura i container

Questa pagina descrive come configurare il comando e gli argomenti del punto di ingresso per Cloud Run di lavoro.

Quando Cloud Run avvia un container, esegue lo stato predefinito dell'immagine il comando entrypoint e gli argomenti predefiniti dei comandi. Se vuoi sostituire il punto di ingresso predefinito dell'immagine e gli argomenti del comando, puoi utilizzare command e args nella configurazione del contenitore. Il campo command specifica il comando effettivamente eseguito dal container. Il campo args specifica gli argomenti passati a quel comando.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti seguenti ruoli IAM:

Per un elenco di ruoli e autorizzazioni IAM associati Cloud Run, consulta Ruoli IAM di Cloud Run e le autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run si interfaccia con Le API Google Cloud, come le librerie client di Cloud, consultano guida alla configurazione dell'identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta autorizzazioni di deployment e gestire l'accesso.

Configura il punto di ingresso e gli argomenti

Per configurare il punto di ingresso del comando e gli argomenti per i job:

Console

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

    Vai a Cloud Run

  2. Se stai configurando un nuovo job, fai clic sulla scheda Job e compila il la pagina iniziale delle impostazioni del job, se preferisci. Se stai configurando un'istanza job esistente, fai clic sul job e poi su Modifica.

  3. Fai clic su Contenitore, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.

  4. Fai clic sulla scheda Generale.

    immagine

    • Specifica il comando che deve essere eseguito dal container. se non è il comando definito nel container e, facoltativamente, specificare al comando del punto di ingresso.

  5. Fai clic su Crea o Aggiorna.

gcloud

  1. Per impostare il comando e gli argomenti di avvio per un nuovo lavoro:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N

    Sostituisci

    • JOB_NAME con il nome del tuo job.
    • COMMAND con il comando che indica di avviare il container se non usi il comando predefinito.
    • ARG1 con l'argomento che stai inviando al container oppure utilizza un elenco delimitato da virgole per più di un argomento.
    • Sostituisci IMAGE_URL con un riferimento all'immagine container, per ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.

Per aggiornare il comando e gli argomenti per un job esistente:

gcloud run jobs update JOB_NAME --command COMMAND --args ARG1,ARG-N

YAML

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

    gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. Aggiorna gli attributi args: e command:

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - args:
            - 'ARG1'
            - 'ARG-N'
            command:
            - COMMAND
            image: IMAGE

    Sostituisci

    • COMMAND con il comando che indica di avviare il container se non usi il comando predefinito.
    • ARG1 con l'argomento che stai inviando al container . Facoltativamente, puoi specificare argomenti aggiuntivi in un dalla riga di comando.

    Puoi anche specificare altre configurazioni, ad esempio le variabili di ambiente limiti di memoria.

  3. Aggiorna la configurazione del job esistente:

    gcloud run jobs replace job.yaml

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

gcloud run jobs update JOB_NAME --command "" --args ""

Utilizza i segni di uguale o le virgole negli argomenti

Se utilizzi i segni di uguale negli argomenti, forniscili utilizzando quanto segue: formato:

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

Se gli argomenti utilizzano le virgole, fai riferimento a configurando le variabili di ambiente per i dettagli sull'interpretazione letterale.

Visualizza le impostazioni del contenitore

Per visualizzare le impostazioni del contenitore correnti per Job Cloud Run:

Console

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

    Vai ai job Cloud Run

  2. Fai clic sul lavoro che ti interessa per aprire la pagina Dettagli offerta di lavoro.

  3. Fai clic sulla scheda Configuration (Configurazione).

  4. Individua l'impostazione del contenitore nella configurazione i dettagli.

gcloud

  1. Utilizza questo comando:

    gcloud run jobs describe JOB_NAME

  2. Individua l'impostazione del contenitore nel modulo restituito configurazione.