Etichettare i repository

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

Cosa sono le etichette?

Un'etichetta è una coppia chiave-valore che puoi assegnare ai repository Cloud de Confiance by S3NS. Ti 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 le risorse in base alle etichette.

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 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
  • Chiavi e valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8; sono consentiti i 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 Cloud de Confiance 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 basate su team o centro di costo per distinguere i repository di proprietà di team diversi (ad esempio, team:research e team: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:ingest e component:dashboard.

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

  • Etichette di stato: ad esempio, state:active, state:readytodelete e state: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 uniche, ad esempio per timestamp o valori individuali per ogni chiamata API. Il problema di questo approccio è che quando i valori cambiano frequentemente o con chiavi che ingombrano il catalogo, è difficile filtrare e generare report in modo efficace sulle risorse.

Aggiunta e aggiornamento di etichette

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

Per etichettare un repository:

Console

  1. Apri la pagina Repository nella console Cloud de Confiance .

    Apri la pagina Repositori

  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 informazioni, fai clic sulla scheda Etichette.

  5. Aggiungere o modificare le etichette:

    1. Per aggiungere un'etichetta, fai clic su Aggiungi etichetta. Specifica la coppia chiave-valore per l'etichetta, poi fai clic su Salva.
    2. Per modificare un'etichetta esistente, cambia il valore dell'etichetta 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 aggiungere nuove etichette.

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 progetto Cloud de Confiance by S3NS . Se questo flag viene omesso, viene utilizzato il progetto corrente o predefinito.
  • LOCATION è la posizione regionale del repository. Puoi omettere il flag `--location` per utilizzare il valore 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 questo comando:

gcloud artifacts repositories update --help

Filtrare i repository per etichetta

Puoi filtrare gli elenchi di repository per etichetta nella console Cloud de Confiance o utilizzando Google Cloud CLI.

Console

  1. Apri la pagina Repository nella console Cloud de Confiance .

    Apri la pagina Repositori

  2. Nel campo Filtro, seleziona Etichette come criteri 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 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 saperne di più sulla sintassi dei filtri in gcloud CLI, consulta la documentazione di gcloud topic filters.

Eliminazione delle etichette

Per eliminare le etichette:

Console

  1. Apri la pagina Repository nella console Cloud de Confiance .

    Apri la pagina Repositori

  2. Fai clic su Seleziona un repository.

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

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

  5. Fai clic su Elimina elemento accanto all'etichetta che vuoi 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

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 progetto Cloud de Confiance by S3NS . Se questo flag viene omesso, viene utilizzato il progetto corrente o predefinito.
  • LOCATION è la posizione regionale 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 coppia KEY=VALUE. Ad esempio: team,product.

Per ulteriori informazioni sul comando, esegui questo comando:

   gcloud artifacts repositories update --help