Etichetta i repository

Utilizza le etichette per identificare e raggruppare i repository correlati. Puoi specificare più etichette per un repository.

Raggruppare repository e altre risorse in Google Cloud per il reporting, l'auditing e il controllo dell'accesso nella tua organizzazione Google Cloud, utilizzare i tag. Tag ed etichette funzionano in modo indipendente l'uno dall'altro e tu e possono applicarli entrambi allo stesso repository.

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare ai repository Google Cloud. Aiutano a organizzare queste risorse e a gestire i costi su larga scala, con la granularità di cui hai bisogno. Puoi collegare un'etichetta a ogni risorsa, quindi filtrare a risorse in base alle loro etichette. Le informazioni relative alle etichette vengono inoltrate al sistema di fatturazione, che consente di suddividere gli addebiti fatturati per etichetta. Grazie ai report sulla fatturazione integrati, puoi filtrare e raggruppare i costi per etichette delle risorse. Puoi utilizzare le etichette anche 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 lunghezza massima di 63 e non può essere vuoto. 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 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 per ciascuna etichetta e al alle singole risorse Google Cloud con 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 del team o del centro di costo: aggiungi etichette in base al team o di costo per distinguere i repository di proprietà team (ad es. team:research e team:analytics). Puoi utilizzare questo tipo di etichetta per la contabilizzazione dei costi o la definizione del budget.

  • Etichette dei componenti: ad esempio, component:redis, component:frontend, component:ingest e component:dashboard.

  • Etichette di ambiente o fase: ad esempio, environment:production e environment:test.

  • Etichette degli stati: ad esempio state:active, state:readytodelete e state:archive.

  • Etichette di proprietà: utilizzate per identificare i team che sono responsabile delle operazioni, ad esempio: team:shopping-cart.

Sconsigliamo di creare un numero elevato di etichette univoche, ad esempio: per timestamp o singoli valori per ogni chiamata API. Il problema di questo approccio è che quando i valori cambiano spesso o con che ingombrano il catalogo, rendendo difficile l'applicazione di filtri e e creare report sulle risorse.

Etichette e tag

Le etichette possono essere utilizzate come annotazioni interrogabili per le risorse, ma non possono essere utilizzate per impostare delle condizioni sui criteri. I tag offrono un modo per consentire o di negare i criteri in base al fatto che una risorsa abbia un tag specifico, fornendo controllo sui criteri. Per ulteriori informazioni, consulta la panoramica dei tag.

Aggiunta e aggiornamento di etichette

Puoi aggiungere una o più etichette a un repository. Puoi anche modificare il valore un'etichetta esistente.

Per etichettare un repository:

Console

  1. Apri la pagina Repository nella console Google Cloud.

    Apri la pagina Repository

  2. Seleziona un repository.

  3. Se il riquadro informazioni accanto all'elenco dei repository non è aperto, fai clic su Mostra riquadro informazioni.

  4. Nel riquadro informativo, fai clic sulla scheda Etichette.

  5. Aggiungi o modifica le etichette:

    1. Per aggiungere un'etichetta, fai clic su Aggiungi etichetta. Specifica la coppia chiave e valore per l'etichetta e poi fai clic su Salva.
    2. Per modificare un'etichetta esistente, cambia il valore dell'etichetta: 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 non esiste un'etichetta, viene creata.
  • Se il comando include anche il flag --clear-labels, 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,..."

Dove

  • REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.
  • PROJECT è l'ID del progetto Google Cloud. Se questo flag viene omesso, in uso il progetto corrente o quello predefinito.
  • LOCATION è un una o più regioni località. Utilizza questo flag per visualizzare i repository in una posizione specifica. Se configurato una località predefinita puoi omettere questo flag per usare 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 maggiori informazioni sul comando, esegui questo comando:

gcloud artifacts repositories update --help

Filtro dei repository per etichetta

Puoi filtrare gli elenchi di repository per etichetta nella console Google Cloud oppure utilizzando Google Cloud CLI.

Console

  1. Apri la pagina Repository nella console Google Cloud.

    Apri la pagina Repository

  2. Nel campo Filtro, seleziona Etichette come criterio di filtro, quindi inserisci la chiave, il valore o la coppia chiave-valore.

    Ad esempio, per mostrare solo i repository con l'etichetta env:dev, puoi inserire uno dei seguenti valori:

    • Inserisci la chiave: env
    • Inserisci il valore: dev
    • Inserisci la coppia chiave-valore: env:dev

gcloud

Per filtrare in base alle etichette, utilizza il flag --filter con il simbolo gcloud artefatti repository list .

Il valore del flag --filter deve essere nell'intervallo labels.KEY=VALUE formato. Ad esempio, se vuoi filtrare i repository nella categoria progetto su 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 in gcloud CLI, vedi il Documentazione di gcloud topic filters.

Eliminazione delle etichette

Per eliminare le etichette:

Console

  1. Apri la pagina Repository nella console Google Cloud.

    Apri la pagina Repository

  2. Fai clic su Seleziona un repository.

  3. Se il riquadro delle informazioni accanto all'elenco di repository non è aperto, fai clic su Mostra riquadro informazioni.

  4. Nel riquadro delle informazioni, fai clic sulla scheda Etichette.

  5. 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 questo comando:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

Per rimuovere tutte le etichette, esegui questo comando:

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

Dove

  • REPOSITORY è il nome del repository. Se hai configurato predefinito, puoi omettere questo flag per usare il valore predefinito.
  • PROJECT è l'ID del progetto Google Cloud. Se questo flag viene omesso, viene utilizzato il progetto corrente o predefinito.
  • LOCATION è un una o più regioni località. Utilizza questo flag per visualizzare i repository in una posizione specifica. Se configurato una località predefinita puoi omettere questo flag per usare quello predefinito.
  • LABEL,... è un elenco di etichette separate da virgole, le chiavi di ogni coppia di KEY=VALUE. Ad esempio: team,product.

Per ulteriori informazioni sul comando, esegui il seguente comando:

   gcloud artifacts repositories update --help