Archivia i grafici Helm in Artifact Registry
Helm è il gestore di pacchetti per Kubernetes. Utilizza grafici che definiscono un set di risorse Kubernetes di cui eseguire il deployment.
Questa guida rapida illustra come:
- Crea un repository privato in Artifact Registry
- Crea un grafico di esempio
- Esegui l'autenticazione con il repository
- Esegui il push del grafico nel repository
- Esegui il deployment del grafico
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Artifact Registry, Google Kubernetes Engine.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Artifact Registry, Google Kubernetes Engine.
Scegli una shell
Per completare questa guida rapida, utilizza Cloud Shell o la tua shell locale.
- Cloud Shell
- Cloud Shell è un ambiente shell per la gestione delle risorse ospitate su Google Cloud. Sono preinstallati Docker, Helm e Google Cloud CLI, l'interfaccia a riga di comando principale per Google Cloud.
- Shell locale
- Se preferisci utilizzare la tua shell locale, devi installare Docker e gcloud CLI nel tuo ambiente.
Avviare Cloud Shell
Per avviare Cloud Shell, segui questi passaggi:
Vai alla console Google Cloud.
Fai clic sul pulsante Attiva Cloud Shell:
.
Si apre una sessione di Cloud Shell all'interno di un frame più in basso nella console. Utilizzerai questa shell per eseguire i comandi
gcloud
.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 tua versione.
Configurazione di una shell locale
Per installare gcloud CLI e Helm, segui questi passaggi:
Installa gcloud CLI. Per aggiornare un'installazione esistente, esegui il comando
gcloud components update
.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 tua versione.
Crea un repository
Crea un repository Docker in cui archiviare il grafico di esempio per questa guida rapida.
Console
Apri la pagina Repository nella console Google Cloud.
Fai clic su Crea repository.
Specifica
quickstart-helm-repo
come nome del repository.Scegli Docker come formato.
In Tipo di località, seleziona Regione, quindi scegli la località
us-west1
.Fai clic su Crea.
Il repository viene aggiunto all'elenco di repository.
gcloud
Esegui questo comando per creare un nuovo repository Docker denominato
quickstart-helm-repo
nella localitàus-west1
con la descrizione "docker repository".gcloud artifacts repositories create quickstart-helm-repo --repository-format=docker \ --location=us-west1 --description="Helm repository"
Esegui questo comando per verificare che il repository sia stato creato.
gcloud artifacts repositories list
Per ulteriori informazioni sui comandi di Artifact Registry, esegui il comando gcloud artifacts
.
Creare un grafico
Per questa guida rapida, creerai un grafico di esempio denominato hello-chart
.
- Passa alla directory in cui vuoi creare il grafico.
Esegui questo comando per creare il grafico:
helm create hello-chart
Helm crea una directory denominata
hello-chart
con un insieme predefinito di file del grafico. Uno dei file è Chart.yaml, che include informazioni sul grafico.Pacchettizza il grafico in un archivio.
helm package hello-chart/
Helm crea un archivio denominato
hello-chart-0.1.0.tgz
utilizzando il nome e il numero di versione del grafico inChart.yaml
.
Esegui l'autenticazione con il repository
Prima di poter eseguire il push o installare le immagini, Helm deve eseguire l'autenticazione in Artifact Registry.
Helm può usare le impostazioni del Registro di sistema esistenti in un file di configurazione Docker. Se non hai già configurato Docker per l'utilizzo con Artifact Registry, puoi eseguire l'autenticazione con un token di accesso per questa guida rapida.
Consulta Configurazione dell'autenticazione per Helm per ulteriori informazioni sull'autenticazione.
Esegui l'autenticazione con la tua configurazione Docker
Per impostazione predefinita, Helm supporta le impostazioni del Registro di sistema nel file di configurazione Docker config.json. Helm trova le impostazioni del Registro di sistema nel percorso predefinito o in quello specificato dalla variabile di ambiente DOCKER_CONFIG.
Se hai configurato Docker con un assistente per le credenziali per l'autenticazione con Artifact Registry, Helm utilizza la tua configurazione esistente per i repository Docker di Artifact Registry.
Autenticazione con un token di accesso
Per eseguire l'autenticazione con un token di accesso:
Ottieni un token di accesso come credenziali quando esegui l'autenticazione in Artifact Registry con Helm.
Linux / MacOS
Esegui questo comando:
gcloud auth print-access-token | helm registry login -u oauth2accesstoken \ --password-stdin https://us-west1-docker.pkg.dev
Windows
Esegui questo comando:
gcloud auth print-access-token ya29.8QEQIfY_... helm registry login -u oauth2accesstoken -p "ya29.8QEQIfY_..." \ https://us-west1-docker.pkg.dev/PROJECT-ID/REPOSITORY
Dove
oauth2accesstoken
è il nome utente da utilizzare durante l'autenticazione con un token di accesso.gcloud auth print-access-token
è il comando gcloud per ottenere il token di accesso. Il token di accesso è la password per l'autenticazione.
Helm è ora autenticato con Artifact Registry. Ora puoi eseguire il push del grafico nel repository.
Esegui il push del grafico in Artifact Registry
Dopo aver creato l'archivio dei grafici e aver eseguito l'autenticazione nel repository Artifact Registry, puoi eseguire il push del grafico al repository.
Per eseguire il push del grafico, esegui questo comando:
helm push hello-chart-0.1.0.tgz oci://us-west1-docker.pkg.dev/PROJECT/quickstart-helm-repo
Sostituisci PROJECT con il tuo ID progetto Google Cloud.
Helm utilizza i valori di Chart.yaml
per l'immagine:
- Il nome del grafico è il nome dell'immagine:
hello-chart
- La versione del grafico è il tag immagine:
0.1.0
Helm restituisce un output simile all'esempio seguente:
Login Succeeded
Pushed: us-west1-docker.pkg.dev/my-project/quickstart-helm-repo/hello-chart:0.1.0
Digest: sha256:67a72...
Esegui questo comando per verificare che il grafico sia ora archiviato nel repository:
gcloud artifacts docker images list us-west1-docker.pkg.dev/PROJECT/quickstart-helm-repo
L'output comando è simile all'esempio seguente:
Listing items under project my-project, location us-west1, repository quickstart-helm-repo.
IMAGE: us-west1-docker.pkg.dev/my-project/quickstart-helm-repo/hello-chart
DIGEST: sha256:67a72...
CREATE_TIME: 2021-11-08T22:59:57
UPDATE_TIME: 2021-11-08T22:59:57
Ora puoi eseguire il deployment di una release utilizzando il grafico archiviato in Artifact Registry.
Esegui il deployment del grafico
In Helm, un'istanza della tua applicazione di cui è stato eseguito il deployment viene chiamata release. Dopo aver aggiunto il repository alla configurazione Helm, puoi eseguire il deployment di una release del grafico.
Crea un cluster denominato
chart-cluster
per il tuo deployment con il comando:gcloud container clusters create --zone us-west1-a chart-cluster
Una volta creato il cluster, il comando restituisce un riepilogo simile all'esempio seguente:
kubeconfig entry generated for chart-cluster. NAME: chart-cluster LOCATION: us-west1-a MASTER_VERSION: 1.20.10-gke.1600 MASTER_IP: 34.66.36.211 MACHINE_TYPE: e2-medium NODE_VERSION: 1.20.10-gke.1600 NUM_NODES: 3 STATUS: RUNNING
Ottieni le credenziali del cluster in modo che
kubectl
possa accedere al cluster:gcloud container clusters get-credentials --zone us-west1-a chart-cluster
Esegui questo comando per eseguire il deployment di una release di
hello-chart
utilizzando i file dei grafici estratti localmente:helm install hello-chart oci://us-west1-docker.pkg.dev/PROJECT/quickstart-helm-repo/hello-chart --version 0.1.0
Il comando restituisce un riepilogo del deployment:
NAME: hello-chart LAST DEPLOYED: Mon Nov 8 23:15:13 2021 NAMESPACE: default STATUS: deployed REVISION: 1
Hai eseguito il deployment di una release utilizzando il grafico che hai creato e di cui hai eseguito il push ad Artifact Registry.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
Elimina il repository che hai creato con il comando seguente:
gcloud artifacts repositories delete quickstart-helm-repo --location=us-west1
Elimina il cluster che hai creato:
gcloud container clusters delete --zone=us-west1-a chart-cluster
Passaggi successivi
- Scopri di più sull'utilizzo dei grafici.
- Scopri di più su Helm.
- Leggi le nostre risorse su DevOps ed esplora il nostro programma di ricerca.