The Chart Best Practices Guide

This guide covers the Helm Team’s considered best practices for creating charts. It focuses on how charts should be structured.

We focus primarily on best practices for charts that may be publicly deployed. We know that many charts are for internal-use only, and authors of such charts may find that their internal interests override our suggestions here.

Quicklinks

• General Conventions General conventions for charts.
• Values Focuses on how you should structure and use your values.
• Templates A closer look at best practices surrounding templates.
• Dependencies Covers best practices for Chart dependencies.
• Labels and Annotations Covers best practices for using labels and annotations in your Chart.
• Pods and PodTemplates Discusses formatting the Pod and PodTemplate portions in Chart manifests.
• Custom Resource Definitions How to handle creating and using CRDs.
• Role-Based Access Control Discusses the creation and formatting of RBAC resources in Chart manifests.