Conventions

Bare resource keys

deployments, cronJobs, and jobs all support bare keys (null value) and produce a working resource out of the box:

deployments:
  myapp:        # one container named "myapp", global image settings applied

cronJobs:
  backup:       # schedule: "@daily", restartPolicy: Never, one container named "backup"

jobs:
  migrate:      # restartPolicy: Never, one container named "migrate"

The container is named after the key and inherits all global defaults (image.*, replicaCount, imagePullPolicy, configure.*, etc.). This is the minimal way to define a resource and is equivalent to explicitly naming the container:

deployments:
  myapp:
    containers:
      myapp:

Note: services and ingresses do not follow this convention — a bare service has no ports, and a bare ingress renders nothing (hosts are required).

Disabling resources with enabled: false

Every named resource — Deployments, Services, Ingresses, CronJobs, Jobs, and HPAs — supports an enabled flag. Setting it to false skips rendering that resource entirely without removing it from values:

deployments:
  api:
    containers:
      api:
        image: myorg/api:latest
  worker:
    enabled: false    # exists in values, renders nothing — useful for feature flags or environment overrides
    containers:
      worker:
        image: myorg/worker:latest

services:
  api:
  debug:
    enabled: false    # disable a service without deleting its configuration

ingresses:
  public:
    hosts: [myapp.example.com]
  internal:
    enabled: false

This is particularly useful in multi-environment setups where a resource is needed in production but not in preview deployments:

# values.production.yaml
deployments:
  worker:
    enabled: true

# values.preview.yaml
deployments:
  worker:
    enabled: false

Clearing inherited values with [] and {}

At the pod level, volumeMounts and other list/dict fields cascade down to containers. A container can opt out of inherited values entirely by setting the field to an empty list or dict:

deployments:
  app:
    volumeMounts:
      - name: data
        mountPath: /data
    containers:
      main:
        # inherits volumeMounts from pod level → gets /data mount
      sidecar:
        volumeMounts: []    # explicitly clears pod-level volumeMounts — sidecar gets nothing

The same pattern applies to configure flags — set configure.persistence: false on a container to disable auto-mounting even when persistence is enabled at the pod level:

deployments:
  app:
    configure:
      persistence: true
    containers:
      main:
        # inherits configure.persistence: true → gets PVC mount
      cache:
        configure:
          persistence: false    # opt out — cache container gets no PVC mount

{} and [] are standard YAML for an empty map and empty list. Use [] to clear any inherited list, {} to clear any inherited map.