Aggiornare le impostazioni del repository

Puoi aggiornare le seguenti impostazioni del repository:

  • Descrizione del repository.
  • Dettagli di autenticazione upstream del repository remoto.
  • Tag immagine immutabili per i repository Docker. Se attivi questa impostazione, un tag immagine rimanda sempre allo stesso digest immagine, incluso il tag latest predefinito.

    Per scoprire di più sui tag immagine, sui digest di immagini e sui tag immagine immutabili, consulta Versioni delle immagini container.

  • Etichette del repository.
  • Impostazioni di analisi delle vulnerabilità.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per aggiornare le impostazioni del repository, chiedi all'amministratore di concederti il ruolo IAM Amministratore del registry di elementi (roles/artifactregistry.admin) nel progetto Google Cloud . Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Aggiorna impostazioni

Puoi aggiornare le impostazioni utilizzando la console Google Cloud o Google Cloud CLI.

Console

  1. Apri la pagina Repository nella console Google Cloud .

    Apri la pagina Repository

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Modifica le impostazioni che vuoi modificare:

    • Modifica la descrizione del repository.
    • Aggiorna i dettagli di autenticazione upstream del repository remoto.
    • Attiva o disattiva i tag immagine immutabili nella sezione Tag immagine immutabili. Se attivi questa impostazione, le seguenti azioni non sono consentite:
      • Eliminare un'immagine taggata.
      • Rimuovi un tag da un'immagine.
      • Esegui il push di un'immagine con un tag già utilizzato da un'altra versione dell'immagine nel repository.
      • Aggiungere, rimuovere o aggiornare le etichette.
    • Attiva o disattiva l'analisi delle vulnerabilità.

  4. Fai clic su Salva.

gcloud

Per modificare la descrizione del repository, esegui il seguente comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

Per aggiornare i dettagli di autenticazione upstream del repository remoto, esegui il seguente comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION

Per modificare la mutabilità del tag immagine, esegui uno dei seguenti comandi:

Per impostare i tag immagine come immutabili:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --immutable-tags

Per impostare i tag immagine come modificabili:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --no-immutable-tags

Per aggiornare le etichette, esegui il comando seguente:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --update-labels="KEY=VALUE,..."

Per modificare le impostazioni di analisi delle vulnerabilità, esegui uno dei seguenti comandi:

Per disattivare l'analisi nel repository:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --disable-vulnerability-scanning

Per consentire l'analisi nel repository:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --allow-vulnerability-scanning

Sostituisci i seguenti valori:

  • REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.
  • PROJECT-ID è l'ID progetto Google Cloud . Se questo flag 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 posizione predefinita, puoi omettere questo flag per utilizzare quella predefinita.
  • DESCRIPTION è una descrizione del repository.
  • USERNAME è il nome utente del repository upstream.
  • SECRET_ID è il nome del secret.
  • SECRET_VERSION è la versione del secret che vuoi utilizzare.
  • I due flag di impostazione dei tag, --no-immutable-tags o --immutable-tags, indicano in che modo i tag vengono associati alle versioni delle immagini.
    • --no-immutable-tags: la versione dell'immagine a cui fa riferimento il tag può cambiare. Sono consentite l'eliminazione delle immagini, la rimozione dei tag e la modifica della versione di un'immagine a cui rimanda un tag.
    • --immutable-tags: nel repository, un tag rimanda sempre alla stessa versione di un'immagine. Le seguenti azioni non sono consentite:
      • Eliminare un'immagine taggata.
      • Rimuovi un tag da un'immagine.
      • Eseguire il push di un'immagine con un tag già utilizzato da un'altra versione dell'immagine nel repository.

  • 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 saperne di più sull'utilizzo delle etichette, consulta Repository di etichette.

Passaggi successivi