Le etichette sono coppie chiave-valore che puoi utilizzare per identificare e raggruppare flussi di lavoro correlati e archiviare i metadati relativi a un flusso di lavoro. Puoi specificare più etichette per un flusso di lavoro.
Questa pagina spiega come utilizzare le etichette con i flussi di lavoro. Descrive inoltre come aggiungere, aggiornare e rimuovere le etichette per un flusso di lavoro.
Per raggruppare flussi di lavoro e altre risorse Google Cloud per report, controlli e controllo dell'accesso nella tua Google Cloud organizzazione, utilizza i tag. I tag e le etichette funzionano indipendentemente tra loro e puoi applicarli entrambi allo stesso flusso di lavoro.
Cosa sono le etichette?
Un'etichetta è una coppia chiave-valore che puoi assegnare ai Google Cloud workflow. Ti aiutano a organizzare queste risorse e a gestire i costi su larga scala, con la granularità di cui hai bisogno. Puoi associare un'etichetta a ogni risorsa e poi filtrare le risorse in base alle etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione, che consente di suddividere gli addebiti fatturati per etichetta. Con i report di fatturazione integrati, puoi filtrare e raggruppare i costi in base alle etichette delle risorse. Puoi anche utilizzare le etichette per eseguire query sulle esportazioni dei dati di fatturazione.
Requisiti per le etichette
Le etichette applicate a una risorsa devono soddisfare i seguenti requisiti:
- Ogni risorsa può avere fino a 64 etichette.
- Ogni etichetta deve essere una coppia chiave-valore.
- Le chiavi hanno una lunghezza minima di 1 carattere e una massima di 63 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
- Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti caratteri internazionali. Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.
- La parte della chiave di un'etichetta deve essere univoca all'interno di una singola risorsa. Tuttavia, puoi utilizzare la stessa chiave con più risorse.
Questi limiti si applicano alla chiave e al valore di ogni etichetta e alle singole Google Cloud risorse che hanno etichette. Non esiste un limite al numero di etichette che puoi applicare a tutte le risorse all'interno di un progetto.
Utilizzi comuni delle etichette
Ecco alcuni casi d'uso comuni per le etichette:
Etichette di team o centro di costo: aggiungi etichette in base al team o al centro di costo per distinguere i flussi di lavoro di proprietà di team diversi (ad esempio
team:researcheteam:analytics). Puoi utilizzare questo tipo di etichetta per la contabilità dei costi o la definizione del budget.Etichette dei componenti: ad esempio
component:redis,component:frontend,component:ingestecomponent:dashboard.Etichette di ambiente o fase: ad esempio,
environment:productioneenvironment:test.Etichette di stato: ad esempio
state:active,state:readytodeleteestate:archive.Etichette di proprietà: utilizzate per identificare i team responsabili delle operazioni, ad esempio:
team:shopping-cart.
Non è consigliabile creare un numero elevato di etichette univoche, ad esempio per i timestamp o i singoli valori per ogni chiamata API. Il problema di questo approccio è che, quando i valori cambiano di frequente o con chiavi che ingombrano il catalogo, diventa difficile filtrare e generare report sulle risorse in modo efficace.
Etichette e tag
Le etichette possono essere utilizzate come annotazioni interrogabili per le risorse, ma non possono essere utilizzate per impostare condizioni sui criteri. I tag forniscono un modo per consentire o negare in modo condizionale i criteri a seconda che una risorsa abbia un tag specifico, offrendo un controllo granulare sui criteri. Per ulteriori informazioni, consulta la panoramica dei tag.
Aggiungere o aggiornare le etichette
Puoi aggiungere una o più etichette a un flusso di lavoro quando lo crei. Puoi anche aggiungere o modificare le etichette quando aggiorni un flusso di lavoro.
Se aggiorni un'etichetta esistente o ne aggiungi una nuova, l'applicazione della nuova etichetta può richiedere fino a 10 minuti.
Filtrare i flussi di lavoro per etichetta
Puoi cercare ed elencare flussi di lavoro specifici filtrandoli per etichetta.
Console
Nella console Google Cloud, vai alla pagina Flussi di lavoro:
Nel campo Filtro, seleziona Etichette come criteri di filtro e, nell'elenco Valori, seleziona una coppia chiave-valore.
gcloud
Utilizza il flag --filter con il comando
gcloud workflows list:
gcloud workflows list \
--filter labels.KEY=VALUE
Sostituisci KEY e VALUE con
una coppia chiave-valore dell'etichetta.
Per ulteriori informazioni sulla sintassi dei filtri in Google Cloud CLI, consulta gcloud topic filters.
Le etichette dei workflow vengono ereditate dalle esecuzioni del workflow. Per visualizzare le etichette di esecuzione, utilizza il metodo workflows.executions.list per elencare e filtrare le esecuzioni dei workflow.
Elimina le etichette
Puoi eliminare un'etichetta specifica utilizzando la console Google Cloud oppure puoi utilizzare la riga di comando gcloud per eliminare tutte le etichette da un workflow.
Console
Nella console Google Cloud, vai alla pagina Flussi di lavoro:
Fai clic sul nome del flusso di lavoro da aggiornare.
Viene visualizzata la pagina Dettagli flusso di lavoro.
Fai clic su Modifica.
Viene visualizzata la pagina Modifica flusso di lavoro.
Accanto all'etichetta che vuoi rimuovere, fai clic su Elimina elemento.
Fai clic su Avanti.
Per eseguire nuovamente il deployment del flusso di lavoro, fai clic su Esegui il deployment.
gcloud
Utilizza il flag --labels con un valore vuoto e il comando gcloud workflows deploy:
gcloud workflows deploy WORKFLOW_NAME \ --labels="" \ --source=YAML_OR_JSON_SOURCE_FILE
Sostituisci quanto segue:
WORKFLOW_NAME: il nome del flusso di lavoro.YAML_OR_JSON_SOURCE_FILE: il file di origine per il workflow in formato YAML o JSON. Ad esempio:myFirstWorkflow.yaml.