Questa pagina descrive come configurare il comando e gli argomenti entrypoint per un job 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 dell'entry point e degli argomenti dei comandi predefiniti dell'immagine, puoi utilizzare i campi command
e args
nella configurazione del contenitore. Il campo command
specifica il comando effettivo eseguito dal contenitore. Il campo args
specifica
gli argomenti passati al comando.
Tieni presente che puoi avere un massimo di 1000 argomenti per contenitore per ogni job.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:
-
Cloud Run Developer (
roles/run.developer
) nel job Cloud Run -
Utente account di servizio (
roles/iam.serviceAccountUser
) nell'identità del servizio
Per un elenco dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run si interfaccia con le API Google Cloud, come le librerie client Cloud, consulta la guida alla configurazione dell'identità di servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci l'accesso.
Configura punto di contatto e argomenti
Per configurare il punto di contatto e gli argomenti dei comandi per i job:
Console
Nella console Google Cloud, vai alla pagina dei job Cloud Run:
Fai clic su Esegui il deployment del contenitore e seleziona Job per compilare la pagina delle impostazioni iniziali del job. Se stai configurando un job esistente, selezionalo e fai clic su Modifica.
Fai clic su Contenitore, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.
Fai clic sulla scheda Generale.
- Specifica il comando che vuoi che venga eseguito dal container, se non è il comando definito nel container, e facoltativamente specifica gli argomenti del comando dell'entry point.
Fai clic su Crea o Aggiorna.
gcloud
Per impostare il comando di avvio e gli argomenti per un nuovo job:
gcloud run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N
Sostituisci
- JOB_NAME con il nome del job.
- COMMAND con il comando con cui deve essere avviato il contenitore se non utilizzi il comando predefinito.
- ARG1 con l'argomento che invii al comando del contenitore o utilizza un elenco delimitato da virgole per più di un argomento.
- Sostituisci IMAGE_URL con un riferimento all'immagine del container, 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
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
Aggiorna gli attributi
args:
ecommand
: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 con cui deve essere avviato il contenitore se non utilizzi il comando predefinito.
- ARG1 con l'argomento che stai inviando al comando del contenitore. Se vuoi, specifica altri argomenti, ognuno in una riga distinta.
Puoi anche specificare ulteriori configurazioni, ad esempio variabili di ambiente o limiti di memoria.
Aggiorna la configurazione del job esistente:
gcloud run jobs replace job.yaml
Per cancellare eventuali comandi e argomenti di punto di contatto impostati (ripristina i valori predefiniti del contenitore), fornisci stringhe vuote come segue:
gcloud run jobs update JOB_NAME --command "" --args ""
Utilizzare i segni di uguale o le virgole negli argomenti
Se utilizzi i segni 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 sulla configurazione delle variabili di ambiente per informazioni su come applicare la sequenza di escape.
Visualizza le impostazioni del contenitore
Per visualizzare le impostazioni correnti del contenitore per il job Cloud Run:
Console
Nella console Google Cloud, vai alla pagina dei job Cloud Run:
Fai clic sul job che ti interessa per aprire la pagina Dettagli job.
Fai clic sulla scheda Configuration (Configurazione).
Individua l'impostazione del contenitore nei dettagli della configurazione.
gcloud
Utilizza il seguente comando:
gcloud run jobs describe JOB_NAME
Individua l'impostazione del contenitore nella configurazione restituita.