6장. CronJob [batch/v1]

concurrencyPolicy

string

작업의 동시 실행을 처리하는 방법을 지정합니다. 유효한 값은 다음과 같습니다.

- "허용"(기본값): CronJobs를 동시에 실행할 수 있습니다. - "Forbid": 동시 실행을 금지하고 이전 실행이 완료되지 않은 경우 다음 실행을 건너뜁니다. - "Replace": 현재 실행 중인 작업을 취소하고 새 작업으로 교체합니다.

가능한 enum 값: - "Allow" 를 사용하면 CronJobs를 동시에 실행할 수 있습니다. - "Forbid" 는 동시 실행을 금지하고 이전이 완료되지 않은 경우 다음 실행을 건너뜁니다. - "Replace" 는 현재 실행 중인 작업을 취소하고 새 작업으로 교체합니다.

failedJobsHistoryLimit

integer

유지해야 하는 실패한 작업 수입니다. 값은 음수가 아닌 정수여야 합니다. 기본값은 1입니다.

jobTemplate

object

JobTemplateSpec은 템플릿에서 만들 때 작업이 수행해야 하는 데이터를 설명합니다.

스케줄

string

Cron 형식의 스케줄입니다. https://en.wikipedia.org/wiki/Cron 을 참조하십시오.

startingDeadlineSeconds

integer

어떤 이유로든 예약된 시간을 놓치는 경우 작업을 시작하는 선택적 데드라인(초)입니다. 누락된 작업 실행은 실패한 작업으로 간주됩니다.

successfulJobsHistoryLimit

integer

유지해야 하는 성공한 작업 수입니다. 값은 음수가 아닌 정수여야 합니다. 기본값은 3입니다.

일시 중단

boolean

이 플래그는 컨트롤러에 후속 실행을 일시 중지하도록 지시합니다. 이미 시작된 실행에는 적용되지 않습니다. 기본값은 false입니다.

timeZone

string

지정된 스케줄의 시간대 이름, https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 을 참조하십시오. 지정하지 않으면 기본적으로 kube-controller-manager 프로세스의 시간대로 설정됩니다. 유효한 시간대 이름 세트와 시간대 오프셋은 CronJob 검증 중에 API 서버에 의해 시스템 전체 시간대 데이터베이스에서 로드되고 실행 중에 컨트롤러 관리자입니다. 시스템 전체 시간대 데이터베이스를 찾을 수 없는 경우 번들 버전의 데이터베이스가 대신 사용됩니다. CronJob의 수명 동안 또는 호스트 구성 변경으로 인해 시간대 이름이 유효하지 않게 되면 컨트롤러는 새 작업 생성을 중지하고 UnknownTimeZone 이유와 함께 시스템 이벤트를 생성합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones에서 확인할 수 있습니다.

메타데이터

ObjectMeta

이 템플릿에서 생성된 작업의 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다.

activeDeadlineSeconds

integer

작업을 종료하기 전에 작업이 지속적으로 활성화될 수 있는 startTime에 대한 시간(초)을 지정합니다. value는 양의 정수여야 합니다. 작업이 일시 중지된 경우(생성 또는 업데이트를 통해) 작업을 다시 시작할 때 이 타이머는 효과적으로 중지되고 재설정됩니다.

backoffLimit

integer

이 작업을 실패로 표시하기 전에 재시도 횟수를 지정합니다. 기본값은 6입니다.

backoffLimitPerIndex

integer

이 인덱스를 실패로 표시하기 전에 인덱스 내의 재시도 횟수에 대한 제한을 지정합니다. 활성화된 경우 인덱스당 실패 수가 Pod의 batch.kubernetes.io/job-index-failure-count 주석에 유지됩니다. 작업의 completionMode=Indexed만 설정할 수 있으며 Pod의 재시작 정책은 Never입니다. 이 필드는 변경할 수 없습니다. 이 필드는 베타 수준입니다. JobBackoffLimitPerIndex 기능 게이트가 활성화되어 있을 때 사용할 수 있습니다(기본적으로 사용 가능).

completionMode

string

completionMode는 Pod 완료 방법을 지정합니다. NonIndexed (기본값) 또는 인덱스일 수 있습니다.

인덱싱되지 않음은 .spec.completions가 Pod를 성공적으로 완료했을 때 작업이 완료된 것으로 간주됨을 의미합니다. 각 Pod 완료는 서로 동성애적입니다.

인덱싱된 것은 작업의 Pod가 주석 batch.kubernetes.io/job-completion-index에서 사용할 수 있는 0에서 (.spec.completions - 1)까지 연결된 완료 인덱스를 가져오는 것을 의미합니다. 각 인덱스에 대해 성공적으로 완료된 Pod가 있으면 작업이 완료된 것으로 간주됩니다. 값이 인덱싱 되면 .spec.completions를 지정해야 하며 .spec.parallelism 은 10^5보다 작거나 같아야 합니다. 또한 Pod 이름은 $(job-name)-$(index)-$(random-string) 형식을 사용합니다. Pod 호스트 이름은 $(job-name)-$(index) 형식을 사용합니다.

나중에 더 많은 완료 모드를 추가할 수 있습니다. 작업 컨트롤러에서 인식하지 못하는 모드를 관찰하는 경우 버전 스큐로 인해 업그레이드 중에 가능한 경우 컨트롤러는 작업에 대한 업데이트를 건너뜁니다.

가능한 enum 값: - "Indexed" 는 작업 완료 모드입니다. 이 모드에서 작업의 Pod는 0에서 (.spec.completions - 1)까지 연결된 완료 인덱스를 가져옵니다. Pod가 각 완료 인덱스에 대해 완료되면 작업이 완료된 것으로 간주됩니다. - "NonIndexed" 는 작업 완료 모드입니다. 이 모드에서 .spec.completions Pod가 성공적으로 완료되면 작업이 완료된 것으로 간주됩니다. Pod 완료는 서로 동화됩니다.

완료

integer

작업을 실행해야 하는 성공적으로 완료된 Pod 수를 지정합니다. null로 설정하면 Pod의 성공이 모든 Pod의 성공 신호를 보내고 병렬 처리가 양수 값을 갖도록 허용합니다. 1로 설정하면 병렬 처리가 1로 제한되고 해당 Pod의 성공이 작업이 성공했음을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/

managedBy

string

managedBy 필드는 작업을 관리하는 컨트롤러를 나타냅니다. k8s 작업 컨트롤러는 이 필드가 전혀 없거나 필드 값이 예약된 문자열 kubernetes.io/job-controller 인 작업을 조정하지만 이 필드의 사용자 지정 값으로 작업 조정은 건너뜁니다. 값은 유효한 도메인 접두사 경로(예: acme.io/foo)여야 합니다. 첫 번째 "/" 앞에 있는 모든 문자는 RFC 1123에서 정의한 유효한 하위 도메인이어야 합니다. 첫 번째 "/" 뒤에 나오는 모든 문자는 RFC 3986에서 정의한 유효한 HTTP 경로 문자여야 합니다. 값은 64자를 초과할 수 없습니다.

이 필드는 알파 수준입니다. 기능 게이트 JobManagedBy가 활성화된 경우 작업 컨트롤러에서 필드 설정을 허용합니다(기본적으로 비활성화됨).

manualSelector

boolean

manualSelector는 Pod 라벨 및 Pod 선택기 생성을 제어합니다. 수행 중인 작업을 확신하지 않는 한 manualSelector 를 설정되지 않은 상태로 두십시오. false 또는 unset인 경우 시스템은 이 작업에 고유한 레이블을 선택하고 해당 레이블을 Pod 템플릿에 추가합니다. true인 경우 사용자는 고유한 라벨을 선택하고 선택기를 지정합니다. 고유한 레이블을 선택하지 않으면 이 작업과 다른 작업이 제대로 작동하지 않을 수 있습니다. 그러나 이전 extensions/v1beta1 API로 생성된 작업에 manualSelector=true 가 표시될 수 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/#specifying-your-own-pod-selector

maxFailedIndexes

integer

backoffLimitPerIndex가 설정된 경우 작업을 실패로 표시하기 전에 실패한 최대 인덱스 수를 지정합니다. 실패한 인덱스 수가 이 수를 초과하면 전체 작업이 Failed로 표시되고 실행이 종료됩니다. null로 남아 있으면 작업은 모든 인덱스를 계속 실행하고 Complete Job condition으로 표시됩니다. backoffLimitPerIndex가 설정된 경우에만 지정할 수 있습니다. null이거나 완료까지 가능합니다. 10^5보다 큰 경우 필수이며 10^4보다 작거나 같아야 합니다. 이 필드는 베타 수준입니다. JobBackoffLimitPerIndex 기능 게이트가 활성화되어 있을 때 사용할 수 있습니다(기본적으로 사용 가능).

parallelism

integer

작업이 지정된 시간에 실행해야 하는 최대 Pod 수를 지정합니다. steady 상태에서 실행되는 실제 Pod 수는 (.spec.completions - .status.successful) < .spec.parallelism)인 경우, 즉, 수행할 작업이 최대 병렬 처리보다 적을 때 이 수보다 적습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/

podFailurePolicy

object

PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다.

podReplacementPolicy

string

podReplacementPolicy는 교체 Pod를 생성할 시기를 지정합니다. 가능한 값은 다음과 같습니다. - TerminatingOrFailed는 Pod를 종료할 때( metadata.deletionTimestamp가 있는 경우) 또는 failed를 다시 생성한다는 것을 의미합니다. - 이전에 생성된 Pod가 완전히 종료될 때까지 기다리는 것은 대체 Pod를 생성하기 전에 실패 또는 Succeeded를 의미합니다.

podFailurePolicy를 사용하는 경우 Failed가 허용된 유일한 값입니다. podFailurePolicy를 사용하지 않는 경우 TerminatingOrFailed 및 Failed는 허용됩니다. 베타 필드입니다. 이를 사용하려면 JobPodReplacementPolicy 기능 토글을 활성화합니다. 기본적으로 활성화되어 있습니다.

가능한 enum 값: - "Failed" 는 대체 Pod를 생성하기 전에 이전에 생성된 Pod가 완전히 종료될 때까지 기다립니다(단계 실패 또는 성공). - "TerminatingOrFailed" 는 종료 시 Pod를 다시 생성하는 것을 의미합니다(Metadata.deletionTimestamp가 있는 경우).

선택기

LabelSelector

Pod 수와 일치해야 하는 Pod에 대한 라벨 쿼리입니다. 일반적으로 시스템은 이 필드를 설정합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

successPolicy

object

SuccessPolicy는 일부 인덱스의 성공 여부에 따라 작업을 성공으로 선언할 수 있는 시기를 설명합니다.

일시 중단

boolean

suspend는 작업 컨트롤러에서 Pod를 생성해야 하는지 여부를 지정합니다. suspend를 true로 설정하여 작업이 생성되면 작업 컨트롤러에서 Pod를 생성하지 않습니다. 생성 후 작업이 일시 중지되면(즉, 플래그가 false에서 true로 전환됨) 작업 컨트롤러에서 이 작업과 연결된 활성 Pod를 모두 삭제합니다. 사용자는 이를 정상적으로 처리하도록 워크로드를 설계해야 합니다. 작업을 일시 중지하면 작업의 StartTime 필드가 재설정되고 ActiveDeadlineSeconds 타이머도 효과적으로 재설정됩니다. 기본값은 false입니다.

템플릿

PodTemplateSpec

작업을 실행할 때 생성할 Pod를 설명합니다. 허용된 유일한 template.spec.restartPolicy 값은 "Never" 또는 "OnFailure"입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/

ttlSecondsAfterFinished

integer

ttlSecondsAfterFinished는 완료된 작업(완료 또는 실패)의 수명을 제한합니다. 작업이 완료된 후 ttlSecondsAfterFinished 필드가 설정되면 자동으로 삭제할 수 있습니다. 작업이 삭제되면 해당 라이프사이클 보장(예: 종료자)이 적용됩니다. 이 필드가 설정되지 않으면 작업이 자동으로 삭제되지 않습니다. 이 필드를 0으로 설정하면 작업이 완료된 직후에 삭제할 수 있습니다.

규칙

array

Pod 실패 정책 규칙 목록입니다. 규칙은 순서대로 평가됩니다. 규칙이 Pod 실패와 일치하면 나머지 규칙은 무시됩니다. Pod 실패와 일치하는 규칙이 없으면 기본 처리가 적용됩니다. Pod 실패 카운터가 증가되고 backoffLimit에 대해 확인됩니다. 최대 20개의 요소가 허용됩니다.

rules[]

object

PodFailurePolicyRule는 요구사항이 충족될 때 Pod 실패를 처리하는 방법을 설명합니다. onExitCodes 및 onPodConditions 중 하나는 각 규칙에서 사용할 수 있지만 둘 다 사용할 수 없습니다.

작업

string

요구 사항이 충족되면 Pod 실패 시 수행된 작업을 지정합니다. 가능한 값은 다음과 같습니다.

- FailJob: Pod의 작업이 Failed로 표시되고 실행 중인 모든 Pod가 종료됩니다. - FailIndex:는 Pod의 인덱스가 Failed로 표시되고 재시작되지 않음을 나타냅니다. 이 값은 베타 수준입니다. JobBackoffLimitPerIndex 기능 게이트가 활성화되어 있을 때 사용할 수 있습니다(기본적으로 사용 가능). - Ignore:는 .backoffLimit를 향하는 카운터가 증가되지 않고 교체 Pod가 생성됨을 나타냅니다. - Count:는 Pod가 기본 방식으로 처리됨 - .backoffLimit를 향하는 카운터가 증가됨을 나타냅니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 규칙을 건너뛰어 알 수 없는 작업에 응답해야 합니다.

가능한 enum 값: - "Count" - Pod 실패에서 수행할 수 있는 작업입니다. Pod 실패는 기본적으로 처리됩니다. 즉, 작업의 .status.failed 필드에 표시되는 .backoffLimit로의 카운터가 증가됩니다. - "FailIndex" 는 Pod 실패에서 수행할 수 있는 작업입니다 - 이 인덱스를 다시 시작할 수 있는 작업입니다. 이 작업은 backoffLimitPerIndex가 설정된 경우에만 사용할 수 있습니다. 이 값은 베타 수준입니다. - "FailJob" Pod 실패 시 수행할 수 있는 작업입니다. Pod의 작업을 실패로 표시하고 실행 중인 모든 Pod를 종료합니다. - "Ignore" 이는 작업의 .status.failed 필드에 표시되는 .backoffLimit로의 카운터 - 작업의 .status.failed 필드에 표시되는 .backoffLimit로의 카운터입니다.

onExitCodes

object

PodFailurePolicyOnExitCodesRequirement는 컨테이너 종료 코드를 기반으로 실패한 Pod를 처리하기 위한 요구 사항을 설명합니다. 특히 Pod 상태의 .status.containerStatuses 및 .status.initContainerStatuses 필드에 각각 표시되는 각 앱 컨테이너 및 init 컨테이너 상태에 대해 .state.terminated.exitCode를 조회합니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다.

onPodConditions

array

Pod 조건에 대한 요구 사항을 나타냅니다. 요구 사항은 Pod 상태 패턴 목록으로 표시됩니다. 하나 이상의 패턴이 실제 Pod 조건과 일치하는 경우 요구 사항이 충족됩니다. 최대 20개의 요소가 허용됩니다.

onPodConditions[]

object

PodFailurePolicyOnPodConditionsPattern은 실제 Pod 상태 유형과 일치하는 패턴을 설명합니다.

containerName

string

지정된 이름으로 컨테이너의 종료 코드를 검사를 제한합니다. null인 경우 규칙이 모든 컨테이너에 적용됩니다. 지정하면 Pod 템플릿의 컨테이너 또는 initContainer 이름과 일치해야 합니다.

operator

string

컨테이너 종료 코드와 지정된 값 간의 관계를 나타냅니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. 가능한 값은 다음과 같습니다.

- in: 하나 이상의 컨테이너 종료 코드( 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개 있음)가 지정된 값 세트에 있는 경우 여러 컨테이너가 충족됩니다. - NotIn: 컨테이너 종료 코드가 하나 이상 있는 경우 요구 사항이 충족됩니다('containerName' 필드에 의해 제한되지 않은 여러 컨테이너가 있는 경우). 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 요구 사항이 충족되지 않았음을 가정하여 알 수 없는 Operator에 반응해야 합니다.

가능한 열거 값: - "In" - "NotIn"

값

배열(정수)

값 집합을 지정합니다. 반환된 각 컨테이너 종료 코드(여러 컨테이너의 경우 여러 개)가 Operator와 관련하여 이 값 집합에 대해 확인됩니다. 값 목록을 정렬해야 하며 중복을 포함하지 않아야 합니다. '0' 값은 In 연산자에 사용할 수 없습니다. 하나 이상의 요소가 필요합니다. 최대 255개의 요소가 허용됩니다.

status

string

필요한 Pod 상태 상태를 지정합니다. Pod 조건과 일치하려면 지정된 상태가 Pod 조건 상태와 같아야 합니다. 기본값은 True입니다.

type

string

필요한 Pod 조건 유형을 지정합니다. Pod 조건과 일치하려면 지정된 유형이 Pod 조건 유형과 같아야 합니다.

규칙

array

규칙은 .status.succeeded >= .spec.completions .spec.completions 이전의 작업 선언에 대한 대체 규칙 목록을 나타냅니다. 규칙이 충족되면 "SucceedededCriteriaMet" 조건이 추가되고 lingering Pod가 제거됩니다. 이러한 작업의 터미널 상태에는 "완료" 조건이 있습니다. 또한 이러한 규칙은 순서대로 평가됩니다. 작업이 규칙 중 하나를 충족하면 다른 규칙은 무시됩니다. 최대 20개의 요소가 허용됩니다.

rules[]

object

SuccessPolicyRule은 작업을 성공으로 선언하는 규칙을 설명합니다. 각 규칙에는 "succeededIndexes" 또는 "succeededCount" 중 하나가 지정되어야 합니다.

succeededCount

integer

succeededCount는 작업에 대해 성공한 인덱스 집합의 실제 필요한 최소 크기를 지정합니다. succeededCount가 succeededIndexes와 함께 사용하면 검사가 succeededIndexes에 의해 지정된 인덱스 세트로만 제한됩니다. 예를 들어, succeededIndexes가 "1-4"이고, succeededCount는 "3"이고, 완료된 인덱스는 "1", "3" 및 "5"인 경우, "1" 및 "3" 인덱스만 해당 규칙에서 고려되기 때문에 작업이 성공으로 선언되지 않습니다. 이 필드가 null이면 기본값을 설정하지 않으며 언제든지 평가되지 않습니다. 이 값을 지정하면 양의 정수여야 합니다.

succeededIndexes

string

succeededIndexes는 작업에 대해 성공한 인덱스의 실제 집합에 포함되어야 하는 인덱스 집합을 지정합니다. 인덱스 목록은 0에서 ".spec.completions-1" 사이여야 하며 중복을 포함하지 않아야 합니다. 하나 이상의 요소가 필요합니다. 인덱스는 쉼표로 구분된 간격으로 표시됩니다. 간격은 10진수 정수 또는 하이픈으로 구분된 10진수 정수 쌍일 수 있습니다. 숫자는 하이픈으로 구분된 시리즈의 첫 번째 및 마지막 요소로 표시되는 에 나열됩니다. 예를 들어 완료된 인덱스가 1, 3, 4, 5 및 7인 경우 해당 인덱스가 "1,3-5,7"으로 표시됩니다. 이 필드가 null이면 이 필드는 기본값으로 설정되지 않으며 언제든지 평가되지 않습니다.

활성 상태

배열(ObjectReference)

현재 실행 중인 작업에 대한 포인터 목록입니다.

lastScheduleTime

시간

작업이 성공적으로 예약된 마지막 시간이었습니다.

lastSuccessfulTime

시간

작업이 마지막으로 완료된 시점의 정보입니다.