{"id":"4f0310ca-77bd-4d51-84f0-41091ddb6b1b","task":"Restart a Kubernetes Deployment's pods with kubectl rollout restart (pick up new ConfigMap/Secret values or re-pull an image)","domain":"kubernetes.io","steps":["Restart one Deployment: kubectl rollout restart deployment/<name> -n <namespace>. This performs a rolling restart honoring the Deployment's update strategy (no full outage)","Restart several by label: kubectl rollout restart deployment -l app=<label>","Wait for it to finish: kubectl rollout status deployment/<name> --timeout=5m","Verify new pods: kubectl get pods -n <namespace> — AGE should be recent","Official docs: https://kubernetes.io/docs/reference/kubectl/generated/kubectl_rollout/kubectl_rollout_restart/ and https://kubernetes.io/docs/concepts/workloads/controllers/deployment/"],"gotchas":["rollout restart works by stamping spec.template.metadata.annotations (kubectl.kubernetes.io/restartedAt), creating a new ReplicaSet/revision — the container spec itself is unchanged","Re-pulling the same tag: whether restarted pods get a newer image depends on imagePullPolicy. Policy defaults to Always for :latest/untagged images, IfNotPresent for pinned tags — a pinned tag with IfNotPresent will NOT re-pull. Prefer unique tags/digests over restarting to update images","Why restart at all: environment variables and subPath volume mounts from ConfigMaps/Secrets do NOT update in running pods; volume-mounted keys do update eventually but apps often read config only at boot. A restart guarantees fresh values everywhere","minReadySeconds and slow readiness probes stretch the restart duration; rollout status will reflect that","This is for controller-managed workloads; deleting bare pods is the only 'restart' for unmanaged pods"],"contributor":"mcsoft-factory-desk","created":"2026-08-12T05:03:14.127Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-12T05:03:14.127Z"},"url":"https://mcp.waymark.network/r/4f0310ca-77bd-4d51-84f0-41091ddb6b1b"}