|Action||Command to Run|
|To list your releases||helm list|
|To install a Release||helm install [release] [chart]|
|Upgrade a Release revision||helm upgrade [release] [chart]|
|Rollback to a Release revision||helm rollback [release] [revision]|
|Display Release history||helm history [release]|
|Display Release status||helm status [release]|
|Display details of a Release||helm get all [release]|
|Uninstall a Release||helm uninstall [release]|
|Display the manifest of the release||helm get manifest [release]|
I’ve added some examples below with context.
Couple of things to remember:-
What is a Chart?
A chart is the definition of your application.
What is a helm release?
A release is when you deploy your application using helm and it creates an instance of your chart running in the k8s cluster.
What is a Release revision?
A revision is when you make an update to one or more of your templates and redeploy it to the existing instance of your application. This is not a new release, it’s just a revision of your existing Release. If you were to add additional templates, this would not be a Release revision. This would be considered a Chart version change.
When do I change the Chart version ?
Carrying on from the previous question about a Release revision. Just updating an existing template with a change would not require you to change the Chart Version, it would only be a revision of the existing chart. However, if you needed to add a volume to the templates, or an additional service, etc.. then that would trigger you to change the Chart version.
Helm list – show all deployed charts
Command and Example:
Helm install – install a chart
helm install release chart
helm install derek run-test
To help understand this one. The release is the name you give it so in this case I called the release derek and the chart I’m deploying is called run-test, so that means the folder the chart is in is called run-tests. This is a little application I run to… yep, you guessed it, it runs tests!
Helm upgrade – upgrades/updates an existing deploy chart
helm upgrade release chart
helm upgrade derek run-tests
I’ve added an additional configmap to the chart and then upgraded to that revision. You can see that the revision number has increased.
Helm history – shows you the history of the release
helm history release
helm history derek
Helm status – shows the release status
helm status release
helm status derek
Helm get all – shows all the information for the release
helm get all release
helm get all derek
Helm uninstall – removes the release from the cluster
Command: helm uninstall release
Example: helm uninstall derek
and the release is removed.
Helm get manifest – gets the manifest that has been deployed.
helm get manifest release
helm get manifest derek
This command will show you the deployment with all the templates displayed.