Utilizza le etichette per identificare e raggruppare i repository correlati. Puoi specificare più etichette per un repository.
Per raggruppare i repository e altre risorse Google Cloud per report, controllo e controllo dell'accesso nella tua Google Cloud organizzazione, utilizza i tag. I tag e le etichette funzionano indipendentemente l'uno dall'altro e puoi applicarli entrambi allo stesso repository.Cosa sono le etichette?
Un'etichetta è una coppia chiave-valore che puoi assegnare ai Google Cloud repository. 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 per team o centro di costo: aggiungi etichette in base al team o al centro di costo per distinguere i repository 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.
Aggiunta e aggiornamento delle etichette
Puoi aggiungere una o più etichette a un repository. Puoi anche modificare il valore di un'etichetta esistente.
Per etichettare un repository:
Console
Apri la pagina Repository nella Google Cloud console.
Seleziona un repository.
Se il riquadro informazioni accanto all'elenco dei repository non è aperto, fai clic su Mostra riquadro informazioni.
Nel riquadro delle informazioni, fai clic sulla scheda Etichette.
Aggiungi o modifica le etichette:
- Per aggiungere un'etichetta, fai clic su Aggiungi etichetta. Specifica la coppia chiave e valore per l'etichetta e poi fai clic su Salva.
- Per modificare un'etichetta esistente, modifica il relativo valore e poi fai clic su Salva.
gcloud
Puoi specificare una o più etichette da aggiungere o modificare.
- Se esiste un'etichetta, il valore corrispondente viene aggiornato.
- Se un'etichetta non esiste, viene creata.
- Se il comando include anche il flag
--clear-labels, tutte le etichette esistenti vengono rimosse prima di aggiungerne di nuove.
Esegui questo comando:
gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."
Sostituisci quanto segue:
REPOSITORYè il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.PROJECTè l'ID Google Cloud progetto. Se questo indicatore viene omesso, viene utilizzato il progetto corrente o predefinito.-
LOCATIONè la posizione regionale o multiregionale del repository. Puoi omettere il flag `--location` per utilizzare quello predefinito. KEY=VALUE,...è un elenco di etichette separate da virgole specificate come coppie chiave-valore. Ad esempio:team=team-1,product=example_product,stage=development.
Per ulteriori informazioni sul comando, esegui il seguente comando:
gcloud artifacts repositories update --help
Filtrare i repository per etichetta
Puoi filtrare gli elenchi dei repository in base all'etichetta nella Google Cloud console o utilizzando Google Cloud CLI.
Console
Apri la pagina Repository nella Google Cloud console.
Nel campo Filtro, seleziona Etichette come criteri di filtro, quindi inserisci la chiave, il valore o la coppia chiave-valore.
Ad esempio, per visualizzare solo i repository con l'etichetta
env:dev, puoi inserire una delle seguenti opzioni:- Inserisci la chiave:
env - Inserisci il valore:
dev - Inserisci la coppia chiave-valore:
env:dev
- Inserisci la chiave:
gcloud
Per filtrare in base alle etichette, utilizza il flag --filter con il comando
gcloud artifacts repositories list.
Il valore del flag --filter deve essere nel formato labels.KEY=VALUE. Ad esempio, se vuoi filtrare i repository nel progetto attivo in base a un'etichetta con env come chiave e dev come valore, puoi eseguire questo comando:
gcloud artifacts repositories list --filter labels.env=dev
Per ulteriori informazioni sulla sintassi dei filtri nell'interfaccia a riga di comando gcloud, consulta la documentazione di gcloud topic filters.
Eliminazione delle etichette
Per eliminare le etichette:
Console
Apri la pagina Repository nella Google Cloud console.
Fai clic su Seleziona un repository.
Se il riquadro delle informazioni accanto all'elenco dei repository non è aperto, fai clic su Mostra riquadro informazioni.
Nel riquadro delle informazioni, fai clic sulla scheda Etichette.
Fai clic su Elimina elemento accanto all'etichetta da rimuovere.
gcloud
Puoi eliminare etichette specifiche o rimuovere tutte le etichette per un repository.
Per rimuovere etichette specifiche, esegui il seguente comando:
gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."
Per rimuovere tutte le etichette, esegui il seguente comando:
gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels
Sostituisci quanto segue:
REPOSITORYè il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.PROJECTè l'ID Google Cloud progetto. Se questo indicatore viene omesso, viene utilizzato il progetto corrente o predefinito.-
LOCATIONè la posizione regionale o multiregionale del repository. Utilizza questo flag per visualizzare i repository in una posizione specifica. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare quella predefinita. LABEL,… è un elenco di etichette separate da virgole, le chiavi di ogni coppiaKEY=VALUE. Ad esempio:team,product.
Per ulteriori informazioni sul comando, esegui il seguente comando:
gcloud artifacts repositories update --help