Le etichette Cloud Run sono coppie chiave/valore applicate ai job Cloud Run. Questa pagina mostra come impostare, modificare ed eliminare le etichette nei job Cloud Run.
I possibili utilizzi includono:
- Da utilizzare per l'allocazione dei costi e la suddivisione della fatturazione.
- Identifica le risorse utilizzate dai singoli team o centri di costo.
- Distingui gli ambienti di deployment (produzione, gestione temporanea, QA o test).
- Identifica i proprietari, le etichette dello stato.
- Filtra i log in Logging.
Regole di utilizzo delle etichette
La seguente regola si applica all'utilizzo delle etichette impostate su un compito Cloud Run:
In Cloud Run è consentito l'utilizzo solo di etichette Google Cloud valide.
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à di 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 APIGoogle Cloud , ad esempio le librerie client di 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.
Impostare o modificare le etichette
Puoi utilizzare Google Cloud CLI o YAML per impostare un'etichetta su un job Cloud Run.
gcloud
Per impostare un'etichetta su un nuovo job:
gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE
Sostituisci
- JOB_NAME con il nome del job.
- KEY con il nome della chiave dell'etichetta
- VALUE con il valore della chiave
- Sostituisci IMAGE_URL con un riferimento all'immagine del container, ad esempio
us-docker.pkg.dev/cloudrun/container/job:latest
.
Per impostare un'etichetta su un job esistente:
gcloud run jobs update JOB_NAME --labels KEY=VALUE
Per creare più di un'etichetta, fornisci un elenco di coppie chiave/valore separate da virgole.
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2
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
labels
in due posizioni:apiVersion: run.googleapis.com/v1 kind: Job metadata: labels: LABEL: VALUE spec: template: metadata: labels: LABEL: VALUE
Sostituisci
- LABEL con il nome dell'etichetta
- VALUE con il valore desiderato
Puoi anche specificare ulteriori configurazioni, come variabili di ambiente o limiti di memoria.
Aggiorna la configurazione del job esistente:
gcloud run jobs replace job.yaml
Elenco job per etichetta
Puoi elencare i job in base all'etichetta utilizzando un filtro Google Cloud CLI:
gcloud run jobs list --filter metadata.labels.LABEL=VALUE
Sostituisci:
- LABEL con il nome dell'etichetta
- VALUE con il valore da includere nell'elenco filtrato
Eliminare un'etichetta in un job
Per cancellare tutte le etichette da un job:
gcloud run jobs update JOB --clear-labels
Per eliminare etichette specifiche da un servizio, fornisci un elenco di chiavi separate da virgole:
gcloud run jobs update JOB --remove-labels LABEL
Sostituisci
- JOB con il nome del job Cloud Run
- LABEL con il nome dell'etichetta