study.

Init Container와 공유 볼륨 · CKAD

애플리케이션이 시작하기 전에 필요한 파일을 준비해봅니다.

← CKAD

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

Init Container의 순서

일반 init container는 완료돼야 다음 컨테이너가 진행됩니다. 초기화가 실패하면 앱이 아직 시작되지 않은 원인을 init 로그에서 찾아야 합니다.

공유 emptyDir

init container가 쓴 파일을 앱 컨테이너가 읽도록 같은 볼륨을 서로 다른 경로에 마운트할 수 있습니다. emptyDir은 Pod 수명에 연결됩니다.

여러 컨테이너의 로그

컨테이너가 여러 개면 logs -c로 대상을 명시합니다. 일반 init container와 계속 실행되는 sidecar는 수명과 역할이 다릅니다.

왜 필요한가요?

앱 실행 전에 준비 파일을 만들고 싶을 때 일반 init container가 순서를 담당할 수 있습니다. 앱과 init container가 데이터를 공유하려면 같은 volume을 연결해야 합니다.

차례대로 이해하기

순서 확인

일반 init container는 성공적으로 끝난 뒤 다음 단계로 넘어갑니다. 앱이 기다린다면 앱 로그만 보지 말고 initContainerStatuses와 init 컨테이너의 로그를 확인합니다.

쓰기와 읽기 경로 연결

init의 mountPath와 앱의 mountPath가 달라도 같은 volume name을 참조하면 데이터를 공유할 수 있습니다. 경로뿐 아니라 파일 소유자와 권한도 읽는 쪽에서 접근 가능한지 확인하세요.

직접 실행하며 익혀보세요.

kubectl, 개인 실습용 Kubernetes 클러스터와 POSIX 셸이 필요합니다. 실습마다 전용 namespace를 사용하며 Secret에는 예제 값만 넣습니다. 정리 명령은 해당 실습 namespace 전체를 삭제합니다.

초기화 컨테이너가 index.html을 만들고 nginx가 그 파일을 제공하게 구성하세요. 이 실습은 일반 init container를 사용하며 native sidecar 기능을 요구하지 않습니다.

kubectl config current-context
kubectl create namespace study-ckad-init --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-ckad-init -f - <<'YAML'
apiVersion: v1
kind: Pod
metadata:
  name: site
spec:
  initContainers:
  - name: prepare
    image: busybox:1.36
    command: ["sh", "-c", "echo init-ready > /work/index.html; echo prepared"]
    volumeMounts:
    - {name: shared, mountPath: /work}
  containers:
  - name: web
    image: nginx:stable-alpine
    volumeMounts:
    - {name: shared, mountPath: /usr/share/nginx/html, readOnly: true}
  volumes:
  - name: shared
    emptyDir: {}
YAML
kubectl wait --for=condition=Ready pod/site -n study-ckad-init --timeout=120s
kubectl logs site -n study-ckad-init -c prepare
kubectl exec site -n study-ckad-init -c web -- wget -qO- http://127.0.0.1

이렇게 확인하세요

init 로그에 prepared, 앱 내부 HTTP 응답에 init-ready가 출력돼야 합니다. Pod가 Init 상태에 머물면 prepare 컨테이너 로그와 Events를 읽으세요. Pod 삭제 시 emptyDir 데이터도 제거됩니다.

실습 리소스 정리

결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.

kubectl delete namespace study-ckad-init

응용해보기

init은 성공했는데 앱에서 준비 파일을 찾지 못합니다. 무엇을 비교할까요?

생각해본 뒤 풀이 보기

두 volumeMounts의 name과 실제 파일 상대 경로, 앱의 읽기 경로를 비교합니다. 같은 volume을 참조하는지와 소유자·권한을 확인합니다. init 성공은 앱이 올바른 경로를 읽는 것까지 보장하지 않습니다.

잠깐, 이해했는지 확인해볼까요?

일반 init container가 아직 성공적으로 완료되지 않았다면?

  1. 앱은 항상 먼저 시작함
  2. 해당 초기화 이후 앱 시작을 기다림
  3. Service가 초기화를 대신함
  4. 볼륨이 자동으로 PV가 됨
생각해본 뒤 풀이 보기

해당 초기화 이후 앱 시작을 기다림

일반 init container는 순서대로 성공적으로 완료돼야 앱 컨테이너가 시작됩니다. 계속 실행되는 sidecar와 구분하세요.

공식 문서 · Init Container와 공유 볼륨