ConfigMap과 Secret을 애플리케이션에 주입하기 · CKAD
설정 값을 이미지에 굽지 않고 실행 시 연결합니다.
진도·퀴즈와 함께 학습하기먼저, 개념을 잡아볼게요.
설정의 구분
ConfigMap에는 비민감 설정을, Secret에는 비밀 값에 대한 접근을 구분해 관리합니다. Secret의 base64 표현은 암호화가 아니며 RBAC와 저장 암호화 등 별도 보호가 필요합니다.
참조 방식
환경변수는 시작 시 값을 읽고, 볼륨은 파일로 제공합니다. 키 이름과 마운트 경로가 실제 애플리케이션이 읽는 위치와 맞아야 합니다.
노출 최소화
실제 토큰을 로그나 화면에 출력하지 마세요. 이 예제는 가짜 토큰 파일의 존재만 확인하며 내용은 출력하지 않습니다.
왜 필요한가요?
이미지는 여러 환경에서 재사용하고 설정은 환경별로 주입하면 배포 차이를 줄일 수 있습니다. ConfigMap과 Secret은 모두 참조할 키 이름과 전달 방식이 앱 기대와 맞아야 합니다.
차례대로 이해하기
참조 경로 읽기
env의 valueFrom에서 name과 key를 따라가 실제 객체에 해당 키가 있는지 확인합니다. 객체는 소비 Pod와 같은 namespace에서 찾아야 합니다. 이름 오타와 키 오타는 서로 다른 지점입니다.
민감한 값의 수명
Secret의 base64 표현은 암호화가 아닙니다. 조회 권한과 저장 시 암호화, 로그 노출을 따로 고려합니다. 실습에는 더미 값만 쓰고 값 자체 대신 존재 여부로 주입을 확인합니다.
직접 실행하며 익혀보세요.
kubectl, 개인 실습용 Kubernetes 클러스터와 POSIX 셸이 필요합니다. 실습마다 전용 namespace를 사용하며 Secret에는 예제 값만 넣습니다. 정리 명령은 해당 실습 namespace 전체를 삭제합니다.
MODE는 ConfigMap 환경변수로, 예제 토큰은 Secret 파일로 주입하세요. 실제 인증정보 대신 demo-only를 사용합니다.
kubectl config current-context
kubectl create namespace study-ckad-config --dry-run=client -o yaml | kubectl apply -f -
kubectl create configmap app-settings --from-literal=MODE=practice -n study-ckad-config --dry-run=client -o yaml | kubectl apply -f -
kubectl create secret generic app-token --from-literal=token=demo-only -n study-ckad-config --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-ckad-config -f - <<'YAML'
apiVersion: v1
kind: Pod
metadata:
name: reader
spec:
containers:
- name: reader
image: busybox:1.36
command: ["sleep", "3600"]
env:
- name: MODE
valueFrom:
configMapKeyRef: {name: app-settings, key: MODE}
volumeMounts:
- {name: token, mountPath: /run/demo-secret, readOnly: true}
volumes:
- name: token
secret: {secretName: app-token}
YAML
kubectl wait --for=condition=Ready pod/reader -n study-ckad-config --timeout=120s
kubectl exec reader -n study-ckad-config -- printenv MODE
kubectl exec reader -n study-ckad-config -- sh -c 'test -s /run/demo-secret/token && echo secret-present'이렇게 확인하세요
출력에서 practice와 secret-present를 확인하세요. Secret 값 자체는 출력하지 않습니다. FailedMount 또는 CreateContainerConfigError이면 참조 이름, 키, namespace부터 확인합니다.
실습 리소스 정리
결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.
kubectl delete namespace study-ckad-config응용해보기
ConfigMap은 존재하는데 CreateContainerConfigError입니다. 무엇을 더 확인할까요?
생각해본 뒤 풀이 보기
Pod의 namespace와 참조 name, key를 대조하고 Events를 확인합니다. 객체가 존재해도 필요한 키가 없을 수 있습니다. 원인 확인을 위해 Secret 값을 화면이나 공유 로그에 출력할 필요는 없습니다.
잠깐, 이해했는지 확인해볼까요?
Secret의 base64 표현에 대한 올바른 설명은?
- 강한 암호화로 접근 제어가 필요 없음
- 표현 방식이며 별도 접근 제어가 필요함
- 어떤 사용자도 복호화 불가능
- 컨테이너 실행 시 항상 자동 삭제
생각해본 뒤 풀이 보기
표현 방식이며 별도 접근 제어가 필요함
base64는 인코딩입니다. Secret 객체를 읽을 수 있는 권한과 저장 시 보호를 별도로 관리해야 합니다.