Helm: Comandi Utili (Cheat Sheet)¶
Questa guida organizza in modo strutturato i comandi fondamentali di Helm per la gestione del ciclo di vita dei pacchetti (Chart) e delle istanze applicative (Release) all'interno di cluster Kubernetes.
Gestione dei Repository¶
I comandi per configurare, aggiornare e rimuovere i cataloghi remoti di Helm Chart.
| Comando | Descrizione |
|---|---|
helm repo add <nome> <url> |
Aggiunge un repository di chart remoto alla configurazione locale. |
helm repo list |
Elenca tutti i repository configurati localmente. |
helm repo update |
Sincronizza e aggiorna le informazioni locali sui chart disponibili dai repository. |
helm repo remove <nome> |
Rimuove un repository configurato dall'elenco locale. |
Ricerca e Ispezione dei Chart¶
I comandi per localizzare i pacchetti ed esaminare le configurazioni interne prima del deployment.
| Comando | Descrizione |
|---|---|
helm search repo <keyword> |
Cerca chart all'interno dei repository aggiunti localmente. |
helm search hub <keyword> |
Cerca chart all'interno dell'Artifact Hub pubblico globale. |
helm show chart <chart> |
Mostra il contenuto del file Chart.yaml (metadati del pacchetto). |
helm show values <chart> |
Ispeziona e stampa tutti i valori predefiniti definiti nel file values.yaml. |
helm show all <chart> |
Mostra cumulativamente tutte le informazioni del chart (info, valori e file README). |
helm pull <chart> --untar |
Scarica il pacchetto del chart e lo decomprime in una directory locale. |
Installazione, Upgrade e Rimozione (Install & Upgrade)¶
Operazioni per istanziare i chart nel cluster e aggiornare lo stato delle applicazioni.
| Comando | Descrizione |
|---|---|
helm install <release> <chart> |
Installa un chart generando una nuova istanza (release) nel cluster. |
helm install <release> <chart> -f values.yaml -n <ns> --create-namespace |
Installa un chart applicando un file di valori custom, in uno specifico namespace (creandolo se assente). |
helm upgrade <release> <chart> |
Aggiorna una release esistente applicando le modifiche del chart o dei valori. |
helm upgrade --install <release> <chart> |
Esegue l'upgrade della release o la installa direttamente se non è presente nel cluster. |
helm template <release> <chart> |
Esegue il rendering locale dei template dei manifesti Kubernetes senza inviarli al cluster (utile per debug). |
helm uninstall <release> |
Rimuove la release dal cluster, eliminando tutte le risorse Kubernetes correlate. |
Gestione dello Stato delle Release¶
Comandi per verificare, monitorare e recuperare informazioni sulle applicazioni in esecuzione.
| Comando | Descrizione |
|---|---|
helm list |
Elenca le release attive all'interno del namespace corrente. |
helm list -A |
Elenca tutte le release installate in tutti i namespace del cluster. |
helm status <release> |
Visualizza lo stato dettagliato e le note di una release installata. |
helm get values <release> |
Mostra esclusivamente i valori sovrascritti o forniti dall'utente per quella release. |
helm get values <release> --all |
Mostra la totalità dei valori applicati alla release (inclusi i default calcolati). |
helm get manifest <release> |
Estrae i file YAML Kubernetes effettivi generati e iniettati all'interno del cluster. |
helm get all <release> |
Mostra l'intera documentazione della release (note, valori applicati e manifesti generati). |
Cronologia e Gestione delle Revisioni (History & Rollback)¶
Gestione delle versioni storiche delle release per il tracciamento delle modifiche e il disaster recovery.
| Comando | Descrizione |
|---|---|
helm history <release> |
Mostra la cronologia completa delle revisioni e degli aggiornamenti della release. |
helm rollback <release> <rev> |
Ripristina istantaneamente la release a una specifica revisione numerica passata. |
helm get manifest <release> --revision <rev> |
Ispeziona i manifesti Kubernetes relativi a una specifica revisione passata. |
Gestione Dinamica dei Parametri (Flag --set)¶
Questa tabella mappa le configurazioni atomiche per modificare i parametri di runtime, i tag delle immagini e le logiche di sovrascrittura dei valori durante le fasi di installazione o upgrade.
| Operazione | Parametro / Flag | Esempio di Comando | Descrizione Tecnica |
|---|---|---|---|
| Cambio Immagine | --set image.tag=<tag> |
helm upgrade apigw . --set image.tag=1.2.3 |
Sovrascrive il tag dell'immagine nel deployment. |
| Cambio App Version | --set app.version=<v> |
helm upgrade apigw . --set app.version=v1.2 |
Modifica la versione dell'applicazione (se mappata). |
| Cambio Chart Version | --version <semver> |
helm upgrade apigw repo/chart --version 0.5.0 |
Installa una versione specifica del pacchetto Chart. |
| Iniezione Multipla | --set var1=x,var2=y |
--set image.tag=v2,app.version=v2,replicaCount=2 |
Aggiorna contemporaneamente più parametri atomici. |
| Reset Stato | --reset-values |
helm upgrade apigw . --reset-values |
Elimina i vecchi --set e torna ai default del file. |
| Mantenimento | --reuse-values |
helm upgrade apigw . --reuse-values --set image.tag=v3 |
Tiene i valori attuali e cambia solo quelli dichiarati. |