Bundle a Release Archive with helm package
Producing a versioned chart tgz.
Bundle a Release Archive with helm package is a free Helm Academy lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Helm Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Sharing Means Packaging
A chart directory is fine on your laptop, but to share it you need a single, versioned file. That is what helm package produces.
The package Command
Point helm package at a chart directory and it bundles everything into one compressed archive ready to distribute.
helm package ./mychartThe .tgz Output
The result is a gzipped tarball named after the chart and its version. This single .tgz file is the unit Helm installs and repos serve.
mychart-0.1.0.tgzVersion Comes From Chart.yaml
The number in the filename is the version field in Chart.yaml, not appVersion. Helm reads it to name and sort the archive.
version: 0.1.0Bump the Version Each Time
Two archives must never share a version. Bump version in Chart.yaml before every package, following semantic versioning so consumers can compare releases.
version: 0.2.0Choosing the Output Folder
By default the .tgz lands in your current directory. Use --destination to drop packaged charts into a dedicated folder.
helm package ./mychart --destination ./distPackage Validates First
Before archiving, helm package loads and checks the chart. A broken Chart.yaml or missing field stops packaging, so errors surface early.
Updating Dependencies Before Packaging
If your chart has subcharts, run helm dependency update first so they are vendored into charts/ and travel inside the archive.
helm dependency update ./mychart
helm package ./mychartPin the appVersion Too
Set appVersion to the image tag of the app you ship. It documents which software the packaged chart actually deploys.
appVersion: "1.25.0"Install Straight From a .tgz
You do not need a repo to test the archive. helm install accepts a local .tgz path directly, just like installing from a repo.
helm install demo ./dist/mychart-0.2.0.tgzWhat the Archive Excludes
A .helmignore file keeps junk like .git and editor backups out of the package, so your published archive stays clean and small.
.git/
*.swp
*.tmpQuick Check
You ran helm package on your chart. What controls the version in the output filename?
Recap: Packaging Charts
You used helm package to turn a chart directory into a versioned .tgz, bumping the Chart.yaml version each time. That archive is ready to share. 📦
Frequently asked questions
Is the “Bundle a Release Archive with helm package” lesson free?
Yes — the full text of “Bundle a Release Archive with helm package” is free to read here on the web, and the Helm Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Helm Academy course, upgrade to CoddyKit PRO.
What will I learn in “Bundle a Release Archive with helm package”?
Producing a versioned chart tgz. You practise Helm Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Helm Academy?
No prior experience is required. Helm Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Bundle a Release Archive with helm package” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Helm Academy lesson?
Yes. Every Helm Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Bundle a Release Archive with helm package
- Build a Repo Index with helm repo index
- Hosting a Chart Repository
- Pushing Charts to an OCI Registry