kubectl set env: Usage, Options & Common CI Errors

Add, change, or strip environment variables without editing YAML.

kubectl set env edits the environment variables of a Deployment's containers. It can set literals, source whole ConfigMaps or Secrets, or remove a variable - each change triggers a rolling update.

What it does

kubectl set env deploy/NAME KEY=VALUE sets a literal; KEY- removes it; --from=configmap/NAME or --from=secret/NAME imports every key as env vars. -c selects a container in a multi-container pod, and --list prints current env without changing anything.

Common usage

Terminal

kubectl set env deploy/web LOG_LEVEL=debug
kubectl set env deploy/web LOG_LEVEL-                 # remove the var
kubectl set env deploy/web --from=configmap/app-cfg
kubectl set env deploy/web --from=secret/db-creds --prefix=DB_
kubectl set env deploy/web --list                     # show, do not change

Common errors in CI

Each set env change rolls the Deployment, so scripting several separate calls causes several rollouts - batch them in one invocation (or wrap with rollout pause/resume) to ship one rollout. Setting a var to the value it already has is a no-op with no rollout, so a "config change" that did not actually differ never reaches pods. Importing --from=secret base64-decodes for you at runtime, so do not pre-decode. And removing a var the container relies on can crash-loop the new pods - gate on kubectl rollout status so the pipeline catches it.

Related guides

kubectl Cheat Sheet: Commands for Everyday KubernetesA kubectl cheat sheet - get, describe, logs, apply, rollout, debug, and context commands for daily Kubernetes… kubectl set image: Usage, Options & Common CI Errorskubectl set image promotes a Deployment to a new image tag and triggers a rollout. The CI deploy step, contai… kubectl create configmap: Usage, Options & Common CI Errorskubectl create configmap builds a ConfigMap from literals, files, or env files. The apply-pipe idempotency pa… kubectl rollout pause: Usage, Options & Common CI Errorskubectl rollout pause freezes a Deployment so multiple edits batch into one rollout. Canary staging in CI, an…