DevOps Bootcamp · Lesson

Release Metadata via .Release

Name, namespace, revision, and install flags.

Lesson 2 of 413 steps

Release Metadata via .Release is a free DevOps Bootcamp lesson on CoddyKit. This is lesson 2 of 4. Any 3 lessons of this learning path are free to read in full — after that, CoddyKit PRO unlocks every lesson, plus hands-on practice with a built-in code editor and a 24/7 AI tutor. It is part of the DevOps Bootcamp learning path, and your progress syncs across the web and the CoddyKit app. The DevOps Bootcamp course includes 4 lessons in total.

Meet the Release Object

While .Values holds config, .Release holds facts about this specific install: who it is, where it lives, and which revision it is.

The Release Name

.Release.Name is the name you gave the install. It is the most common way to prefix resource names so they stay unique. 🏷️

# helm install web ./mychart
name: {{ .Release.Name }}-config

The Target Namespace

.Release.Namespace is the namespace the release deploys into. Use it when a template needs to reference its own namespace explicitly.

namespace: {{ .Release.Namespace }}

The Revision Number

.Release.Revision counts how many times this release has been installed or upgraded. A fresh install is revision 1.

IsInstall and IsUpgrade

Two booleans tell you the operation: .Release.IsInstall is true on first install, and .Release.IsUpgrade is true on every upgrade.

{{ if .Release.IsUpgrade }}upgrading{{ end }}

Why Prefix With the Release Name

Installing one chart twice in a namespace would collide. Prefixing names with .Release.Name keeps each release's resources distinct.

The Service Field

.Release.Service reports the engine doing the render. For normal Helm runs its value is simply Helm.

Release Fields Are Read-Only

You cannot set .Release values from a chart; Helm fills them at render time. Treat the whole .Release object as read-only input.

A Common Naming Pattern

Many charts combine the release name and chart name for a unique fullname. .Release.Name is the half that makes it install-specific.

{{ .Release.Name }}-{{ .Chart.Name }}

Capitalize the Field Names

Built-in object fields use leading capitals: .Release.Name, not .release.name. Lowercasing them yields an empty render.

Conditioning on Install vs Upgrade

A hook can run only the first time by guarding it with .Release.IsInstall. This is how charts seed data only on first install.

{{ if .Release.IsInstall }}# seed once{{ end }}

Quick Check

You want each resource name to be unique to this particular install.

Recap: Release Metadata

You met .Release: Name, Namespace, Revision, and the IsInstall and IsUpgrade flags. These read-only facts make templates install-aware.

Free to start

Learn DevOps Bootcamp with an AI tutor — free

Write and run real code in your browser, get instant help from a 24/7 AI tutor, and pick up where you left off on the web or in the app.

Courses
142
Lessons
568

Frequently Asked Questions

Is the “Release Metadata via .Release” lesson free?

Yes — any 3 lessons of the DevOps Bootcamp learning path, including “Release Metadata via .Release”, are free to read in full here on the web. After that, CoddyKit PRO unlocks every lesson, plus interactive practice with a built-in code editor and a 24/7 AI tutor. The DevOps Bootcamp course includes 4 lessons in total.

What will I learn in “Release Metadata via .Release”?

Name, namespace, revision, and install flags. You practise DevOps Bootcamp 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 DevOps Bootcamp?

No prior experience is required. DevOps Bootcamp on CoddyKit is structured for beginners through advanced learners, so you can start here or from the beginning and move at your own pace. This is lesson 2 of 4.

How long does the “Release Metadata via .Release” 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 DevOps Bootcamp lesson?

Yes. Every DevOps Bootcamp 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

  1. The Values Object and Nested Access
  2. Release Metadata via .Release
  3. Chart and Capabilities Objects
  4. Files, Template, and the Root Context
← Back to DevOps Bootcamp