ConfigMap 변경과 환경변수 갱신 · Kubernetes
설정을 바꾸었는데 애플리케이션 값은 왜 그대로일까요?
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
설정과 이미지 분리
ConfigMap은 비민감 설정을 이미지와 분리합니다. 같은 이미지를 여러 환경에서 쓰면서 배포별로 다른 값을 주입할 수 있습니다.
환경변수의 시점
ConfigMap을 환경변수로 읽은 값은 컨테이너 시작 시 결정됩니다. ConfigMap만 수정해도 실행 중인 프로세스의 환경이 자동 갱신되지는 않습니다.
명시적인 새 실행
Deployment의 rollout restart는 새 Pod를 만들어 변경된 값을 읽게 합니다. 볼륨으로 마운트한 설정의 갱신 방식은 환경변수와 다르므로 구분합니다.
왜 필요한가요?
설정을 바꾸는 일과 프로세스가 그 값을 다시 읽는 일은 별개입니다. 환경변수는 컨테이너 시작 시 결정되므로 기존 실행을 그대로 두면 이전 값이 보일 수 있습니다.
차례대로 이해하기
실험의 세 시점
처음 MODE=first인 실행을 확인합니다. ConfigMap을 second로 변경한 뒤 같은 실행을 조회하면 first입니다. Deployment를 재시작하고 새 Pod에서 조회하면 second로 바뀝니다. 각 시점의 Pod 이름을 기록하세요.
파일 마운트와 비교
ConfigMap 볼륨 파일은 갱신이 전파될 수 있지만 즉시는 아니며 앱이 파일을 다시 읽어야 합니다. subPath 마운트에는 자동 갱신이 적용되지 않습니다. 전달 방식과 앱의 재읽기 동작을 함께 설계합니다.
직접 실행하며 익혀보세요.
kubectl과 개인 실습용 Kubernetes 클러스터, POSIX 셸이 필요합니다. 매 실습에서 context를 확인하고 전용 namespace를 사용하세요. 실습별 정리는 해당 namespace의 모든 리소스를 삭제합니다.
MODE=first를 읽는 Deployment를 만든 뒤 ConfigMap을 second로 바꾸세요. 재시작 전후 값을 비교합니다.
kubectl config current-context
kubectl create namespace study-k8s-config --dry-run=client -o yaml | kubectl apply -f -
kubectl create configmap settings --from-literal=MODE=first -n study-k8s-config --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-k8s-config -f - <<'YAML'
apiVersion: apps/v1
kind: Deployment
metadata:
name: reader
spec:
replicas: 1
selector:
matchLabels: {app: reader}
template:
metadata:
labels: {app: reader}
spec:
containers:
- name: reader
image: busybox:1.36
command: ["sleep", "3600"]
envFrom:
- configMapRef: {name: settings}
YAML
kubectl rollout status deployment/reader -n study-k8s-config --timeout=120s
kubectl exec deployment/reader -n study-k8s-config -- printenv MODE
kubectl create configmap settings --from-literal=MODE=second -n study-k8s-config --dry-run=client -o yaml | kubectl apply -f -
kubectl exec deployment/reader -n study-k8s-config -- printenv MODE
kubectl rollout restart deployment/reader -n study-k8s-config
kubectl rollout status deployment/reader -n study-k8s-config --timeout=120s
kubectl exec deployment/reader -n study-k8s-config -- printenv MODE이렇게 확인하세요
처음과 ConfigMap 변경 직후에는 first, rollout restart 후에는 second가 출력돼야 합니다. 값이 없으면 envFrom의 참조 이름과 namespace를 확인하세요.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
kubectl delete namespace study-k8s-config응용해보기
앱이 시작할 때만 설정 파일을 읽습니다. 마운트 파일의 값이 바뀌면 앱 설정도 즉시 바뀔까요?
생각해본 뒤 풀이 보기
아닙니다. 앱의 reload 기능이나 새 실행이 필요할 수 있습니다. 파일 내용, 프로세스가 사용 중인 값, 새 Pod의 준비 상태를 별도로 확인해 설정 반영을 판단합니다.
잠깐, 이해했는지 확인해볼까요?
ConfigMap 환경변수 변경을 기존 프로세스에 반영하려면 보통 무엇이 필요한가요?
- ConfigMap 조회만 수행
- 새 컨테이너 실행
- Service 삭제
- Pod label 제거
생각해본 뒤 풀이 보기
새 컨테이너 실행
환경변수는 시작할 때 읽습니다. 새 Pod 또는 컨테이너가 변경된 설정을 읽어야 합니다.