Gestire i grafici Helm

Questa pagina spiega come gestire i grafici Helm 3 salvati come immagini container OCI, inclusi il push (caricamento), il pull (download), l'elenco, l'assegnazione di tag e l'eliminazione dei grafici.

Prima di iniziare

  1. Se il repository di destinazione non esiste, creane uno nuovo. Scegli Docker come formato del repository.
  2. Verifica di disporre delle autorizzazioni richieste per il repository.
  3. (Facoltativo) Configura i valori predefiniti per i comandi di Google Cloud CLI.

  4. Installa Helm 3.8.0 o versioni successive. Nelle versioni precedenti di Helm, il supporto per i grafici in formato OCI è una funzionalità sperimentale.

    Esegui helm version per verificare la versione.

  5. Configura Helm per l'autenticazione con Artifact Registry.

Creare o ottenere un grafico

Questa documentazione si concentra sulla gestione delle immagini dei grafici e presuppone che tu abbia già dei grafici o che tu abbia familiarità con la creazione di grafici. Per scoprire di più sulla creazione di grafici o sull'ottenimento di grafici disponibili pubblicamente in Artifact Hub, consulta le seguenti informazioni nella documentazione di Helm.

Creare un pacchetto di un grafico

Prima di poter eseguire il push di un grafico in Artifact Registry, devi creare un pacchetto come archivio di grafici.

  1. Passa alla directory che contiene il grafico.

  2. Crea il pacchetto del grafico.

    helm package CHART-PATH

    Sostituisci CHART-PATH con il percorso della directory che contiene il tuo Chart.yaml file.

Helm utilizza il nome e la versione del grafico per il nome file dell'archivio. Ad esempio, se hai un grafico con il nome my-chart e il numero di versione 0.1.0, il nome del pacchetto è my-chart-0.1.0.tgz.

Ora puoi eseguire il push del grafico in Artifact Registry.

Eseguire il push di un grafico

Dopo aver creato il pacchetto del grafico, puoi eseguirne il push in Artifact Registry.

Per eseguire il push del grafico, esegui il comando seguente:

helm push my-chart-0.1.0.tgz oci://LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

Sostituisci i seguenti valori:

Helm utilizza le informazioni di Chart.yaml per il nome e il tag dell'immagine container OCI. Considera il seguente comando di esempio:

helm push my-chart-0.1.0.tgz oci://us-west1-docker.pkg.dev/my-project/my-repo

Helm carica l'archivio del grafico come immagine my-chart con il tag 0.1.0.

Per verificare che l'operazione di push sia andata a buon fine, elenca le immagini nel repository.

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

Eseguire il pull dei grafici

Per eseguire il pull di un grafico:

  1. Esegui il comando seguente per eseguire il pull dell'archivio del grafico:

    helm pull oci://LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
    --version VERSION

    Se vuoi eseguire il pull dell'archivio del grafico ed estrarne i contenuti, aggiungi il flag --untar.

    helm pull oci://LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
    --version VERSION \
    --untar

    Sostituisci i seguenti valori:

  • LOCATION è la località regionale o multiregionale del repository.
  • PROJECT è il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:), consulta Progetti basati sul dominio.
  • REPOSITORY è il nome del repository in cui è archiviata l'immagine.
  • IMAGE è il nome dell'immagine nel repository.
  • VERSION è la versione semantica del grafico. Questo flag è obbligatorio. Helm non supporta il pull di un grafico utilizzando un tag.

Installare un grafico

Installa un grafico archiviato in Artifact Registry con il helm install comando.

helm install RELEASE \
    oci://LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
    --version VERSION

L'esempio seguente installa una release denominata release1 utilizzando la versione 0.1.0 del grafico us-west1-docker.pkg.dev/nyap-test/helm-repo/my-chart:

helm install release1 oci://us-west1-docker.pkg.dev/nyap-test/helm-repo/my-chart --version 0.1.0

Elencare i grafici

Puoi elencare i grafici utilizzando la Google Cloud console o la riga di comando. Se archivi immagini container e grafici nello stesso repository Docker, entrambi i tipi di artefatti vengono visualizzati nell'elenco.

Console

Per visualizzare le immagini in un repository:

  1. Apri la pagina Repository nella Google Cloud console.

    Apri la pagina Repositori

  2. Fai clic sul repository con l'immagine container.

  3. Fai clic su un'immagine per visualizzarne le versioni.

gcloud

Per elencare tutte le immagini nel progetto, nel repository e nella località predefiniti quando i valori predefiniti sono configurati:

gcloud artifacts docker images list

Per elencare le immagini in un repository in una località specifica, esegui il comando:

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

Per elencare tutti i digest e i tag di un'immagine specifica, esegui il comando:

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags

Sostituisci i seguenti valori:

  • LOCATION è la località regionale o multiregionale del repository.
  • PROJECT è il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:), consulta Progetti basati sul dominio.
  • REPOSITORY è il nome del repository in cui è archiviata l'immagine.
  • IMAGE è il nome dell'immagine nel repository.
  • --include-tags mostra tutte le versioni delle immagini, inclusi digest e tag. Se questo flag viene omesso, l'elenco restituito include solo le immagini container di primo livello.

Ad esempio, considera un'immagine con le seguenti caratteristiche:

  • Località del repository: us-west1
  • Nome del repository: my-repo
  • ID progetto: my-project
  • Nome immagine: my-image

Il nome completo del repository è:

us-west1-docker.pkg.dev/my-project/my-repo

Il nome completo dell'immagine è:

us-west1-docker.pkg.dev/my-project/my-repo/my-image

Per informazioni dettagliate sul formato del nome dell'immagine, consulta Nomi di repository e immagini.

Elencare i file

Puoi elencare i file in un repository, i file in tutte le versioni di un'immagine container specificata o i file in una versione specifica di un'immagine.

Per tutti i comandi seguenti, puoi impostare un numero massimo di file da restituire aggiungendo il flag --limit al comando.

Per elencare tutti i file nel progetto, nel repository e nella località predefiniti quando i valori predefiniti sono configurati:

gcloud artifacts files list

Per elencare i file in un progetto, un repository e una località specifici, esegui il comando:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Per elencare i file per tutte le versioni di un'immagine container specifica:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Per elencare i file per una versione specifica dell'immagine container:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION
Per elencare i file per un tag specifico:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --tag=TAG

Sostituisci i seguenti valori:

Eliminare le immagini

In un repository Artifact Registry, puoi eliminare un'intera immagine container o una versione specifica dell'immagine associata a un tag o a un digest. Una volta eliminata un'immagine, non puoi annullare l'azione.

Per eliminare un'immagine archiviata in Artifact Registry:

Console

  1. Apri la pagina Repository nella Google Cloud console.

    Apri la pagina Repositori

  2. Fai clic sul nome dell'immagine per visualizzarne le versioni.

  3. Seleziona le versioni che vuoi eliminare.

  4. Fai clic su ELIMINA.

  5. Nella finestra di dialogo di conferma, fai clic su ELIMINA.

gcloud

Per eliminare un'immagine e tutti i relativi tag, esegui il comando:

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags

Per eliminare una versione specifica dell'immagine, utilizza uno dei seguenti comandi.

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]

o

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]

Dove

  • LOCATION è la località regionale o multiregionale del repository.
  • PROJECT è il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:), consulta Progetti basati sul dominio.
  • REPOSITORY è il nome del repository in cui è archiviata l'immagine.
  • IMAGE è il nome dell'immagine nel repository.
  • TAG è il tag della versione che vuoi eliminare. Se alla stessa versione dell'immagine sono associati più tag, devi includere --delete-tags per eliminare la versione dell'immagine senza rimuovere prima i tag.
  • IMAGE-DIGEST è il valore hash sha256 della versione che vuoi eliminare. Se un tag è associato al digest dell'immagine, devi includere --delete-tags per eliminare la versione dell'immagine senza rimuovere prima il tag.
  • --delete-tags rimuove tutti i tag applicati alla versione dell'immagine. Questo flag ti consente di forzare l'eliminazione di una versione dell'immagine quando:
    • Hai specificato un tag, ma alla versione dell'immagine sono associati altri tag.
    • Hai specificato un digest dell'immagine che ha almeno un tag.

Passaggi successivi