study.

Job과 CronJob의 완료 확인 · CKAD

계속 실행되는 서버와 끝나야 하는 작업은 다른 컨트롤러로 관리합니다.

← CKAD

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

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

Job

Job은 정해진 완료 조건에 도달하도록 Pod 실행을 관리합니다. 실패한 실행을 재시도할 수 있으므로 외부 데이터를 바꾸는 작업은 중복 실행에 대비해야 합니다.

CronJob

CronJob은 일정에 따라 Job을 만듭니다. 이 실습에서는 suspend로 자동 예약을 멈추고 수동 Job 하나만 만들어 결과를 확인합니다.

성공 판정

Pod가 Running인지만 보면 배치 작업의 성공을 알 수 없습니다. Job의 Complete 조건과 로그, 실패 횟수를 함께 확인합니다.

왜 필요한가요?

완료되는 작업을 계속 살아 있어야 하는 서버처럼 관리하면 정상 종료를 장애로 오해하기 쉽습니다. Job은 완료를, CronJob은 정해진 시각의 Job 생성을 다룹니다.

차례대로 이해하기

완료 조건과 재시도

Pod의 Succeeded와 Job의 Complete 조건을 함께 확인합니다. backoffLimit은 실패 재시도의 한계를 정하고 completions와 parallelism은 완료 목표와 동시 실행 수를 구분합니다.

일정과 겹침

CronJob의 schedule은 실행 시각을 정하지만 매번 정확히 한 번만 처리한다는 보장은 아닙니다. 오래 걸리는 작업의 concurrencyPolicy와 중복 실행에도 안전한 데이터 처리를 함께 검토합니다.

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

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

중지된 CronJob을 만들고 그 템플릿으로 Job을 한 번 실행하세요. 자동 반복 실행 없이 배치 작업의 완료를 관찰합니다.

kubectl config current-context
kubectl create namespace study-ckad-batch --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-ckad-batch -f - <<'YAML'
apiVersion: batch/v1
kind: CronJob
metadata:
  name: report
spec:
  schedule: "*/10 * * * *"
  suspend: true
  jobTemplate:
    spec:
      backoffLimit: 1
      template:
        spec:
          restartPolicy: Never
          containers:
          - name: report
            image: busybox:1.36
            command: ["sh", "-c", "echo batch-ok; date -u"]
YAML
kubectl create job report-once --from=cronjob/report -n study-ckad-batch
kubectl wait --for=condition=Complete job/report-once -n study-ckad-batch --timeout=120s
kubectl logs job/report-once -n study-ckad-batch
kubectl get cronjob report -n study-ckad-batch

이렇게 확인하세요

Job의 Complete가 true이고 로그에 batch-ok가 나와야 합니다. CronJob의 suspend가 true인지 확인하세요. 실패 시 describe job과 실행된 Pod 로그에서 명령·이미지 문제를 구분합니다.

실습 리소스 정리

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

kubectl delete namespace study-ckad-batch

응용해보기

매분 실행하는 작업이 3분 걸립니다. 중복 처리가 위험하다면 무엇을 검토할까요?

생각해본 뒤 풀이 보기

겹치는 실행을 어떻게 다룰지 concurrencyPolicy를 검토하고, 업무 처리에는 고유 작업 키나 중복 방지 로직을 설계합니다. Forbid로 같은 CronJob의 겹침을 줄여도 정확히 한 번 처리를 보장한다고 설명해서는 안 됩니다.

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

Job의 성공적인 작업 완료를 확인할 조건은?

  1. Service의 ClusterIP
  2. Job의 Complete 조건
  3. Pod 이름의 길이
  4. Deployment replicas
생각해본 뒤 풀이 보기

Job의 Complete 조건

배치 작업은 정상 종료를 목표로 하므로 Job의 Complete 조건과 로그로 확인합니다. Running은 완료를 뜻하지 않습니다.

공식 문서 · Job과 CronJob의 완료 확인