Aggiorna le impostazioni del repository

Puoi aggiornare le seguenti impostazioni del repository:

  • Descrizione del repository.

  • Dettagli dell'autenticazione upstream del repository remoto.

  • Tag immagine immutabili per i repository Docker. Se abiliti questa impostazione, un tag immagine rimanda sempre allo stesso digest immagine, incluso il tag latest predefinito.

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

  • Etichette del repository:

Ruoli obbligatori

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

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 cambiare:

    • Modifica la descrizione del repository.
    • Aggiorna i dettagli di autenticazione upstream del repository remoto.

    • Abilita o disabilita i tag immagine immutabili nella sezione Tag immagine immutabili. Se attivi questa impostazione, non sono consentite le seguenti azioni:

      • 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.

  4. Fai clic su Salva.

gcloud

Per modificare la descrizione del repository, esegui questo comando:

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

Per aggiornare i dettagli di autenticazione upstream del repository remoto, esegui questo 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 questo comando:

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

Sostituisci i seguenti valori:

  • REPOSITORY con il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare il repository predefinito.
  • PROJECT-ID con l'ID progetto Google Cloud. Se questo flag viene omesso, viene usato il progetto attuale o predefinito.
  • LOCATION con la regione a livello di regione o multiregionale località. Utilizza questo flag per visualizzare i repository in una posizione specifica. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare la località predefinita.
  • DESCRIPTION con una descrizione per il repository.
  • USERNAME con il nome utente del repository upstream.
  • SECRET_ID con il nome del tuo secret.
  • SECRET_VERSION con la versione del secret che vuoi utilizzare.
  • TAG-SETTING indica in che modo i tag vengono associati alle versioni delle immagini.
  • --no-immutable-tags: la versione dell'immagine a cui rimanda il tag può cambiare. È consentito eliminare immagini, rimuovere tag e cambiare la versione di un'immagine a cui rimanda un tag.
  • --immutable-tags: nel repository, un tag rimanda sempre alla stessa versione di un'immagine. Non sono consentite le seguenti azioni:
    • 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.
  • KEY=VALUE,... con 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 sull'utilizzo delle etichette, consulta Etichettare i repository.