한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
개발·오픈소스 · 판정 관망
그림을 글로 풀면
예약 시각과 시간대 함께 확인
시간대를 생략한 CronJob은 컨트롤러의 현지 시간대를 기준으로 일정을 해석합니다.
- 대상
- Kubernetes에서 AI 배치를 예약하는 운영자
- 무엇이 바뀜
- spec.timeZone으로 일정의 시간대 기준을 지정할 수 있습니다.
- 왜 중요한가
- 시각만 같아도 기준 시간대가 다르면 의도한 때와 어긋납니다.
- 지금 할 일
- schedule과 timeZone을 함께 검토하고 생성된 Job을 확인하세요.
- 한계·미확인
- 개념 비유. 예약 생성·실행·시각 측정·사람 검수 없음.
- 공식 출처
- kubernetes.io
- 확인일
- 2026-10-28
시각만 적힌 일정에서 빠지는 질문
가상의 AI 문서 정리 작업을 매일 같은 현지 시각에 실행하려고 합니다. 일정 표현식만 기록하면 운영 환경을 옮긴 뒤 어떤 시간대를 기준으로 삼았는지 놓치기 쉽습니다. AINOW는 예약 검토표에 일정, 시간대, 대상 작업을 함께 적도록 제안합니다. 그림의 서울 표찰은 선택한 지역의 예시이며 현재 사이트의 예약 설정을 변경했다는 뜻이 아닙니다.
시간대는 전용 필드에서 지정하기
Kubernetes 공식 문서에 따르면 .spec.timeZone을 생략하면 kube-controller-manager의 현지 시간대를 사용합니다. 명시적으로 지정하려면 이 필드에 유효한 시간대 이름을 넣습니다. 시간대 기능은 v1.27부터 stable입니다. .spec.schedule 문자열 안에 TZ 또는 CRON_TZ를 끼워 넣는 방식은 지원되지 않으며 리소스 생성·수정 시 검증 오류가 발생한다고 안내합니다.
시간대가 맞아도 실제 실행 기록은 남기기
명시한 시간대는 일정 해석의 기준입니다. 공식 문서는 CronJob의 Job 생성이 근사적으로 이루어져 중복되거나 누락되는 상황도 있다고 설명합니다. 따라서 생성된 Job과 처리 결과를 대조하고 같은 입력을 재처리해도 문제가 없도록 설계하세요. 이번 글에서는 CronJob을 생성하거나 예약 시각·중복 실행을 시험하지 않았습니다. 기존 운영 일정도 변경하지 않았습니다.
참고 원문: Kubernetes 공식 CronJob 문서 — 시간대와 제약 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-28
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- 2026-10-28 상시 문서 확인. spec.timeZone은 Kubernetes v1.27부터 stable. 예약 생성·실행 시험 없음
- 확인일
- 2026-10-28
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. 예약 생성·실행·시각 측정·사람 검수 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.