13장. Job [batch/v1]

activeDeadlineSeconds

integer

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

backoffLimit

integer

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

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) 형식을 사용합니다.

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

완료

integer

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

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

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에 미치는 영향을 설명합니다.

선택기

LabelSelector

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

일시 중단

boolean

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

템플릿

PodTemplateSpec

작업을 실행할 때 생성할 Pod를 설명합니다. 자세한 내용은 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가 종료되었음을 나타냅니다. - Ignore: 는 .backoffLimit를 향하는 카운터가 증가되지 않고 교체 Pod가 생성됨을 나타냅니다. - Count:는 Pod가 기본적으로 처리됨을 나타냅니다(.backLimit에 대한 카운터가 증가됨을 나타냅니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 규칙을 건너뛰어 알 수 없는 작업에 응답해야 합니다.

가능한 enum 값: - "Count" 는 Pod 실패에서 수행할 수 있는 작업입니다. Pod 오류는 기본적으로 처리됩니다. 즉, 작업의 .status.failed 필드에 표시되는 .backoffLimit를 가리키는 카운터는 증가되어 있습니다. - "FailJob" 은 작업입니다. Pod 실패 시 수행할 수 있는 항목 - Pod 작업을 실패로 표시하고 실행 중인 모든 Pod를 종료합니다. - "Ignore" Pod 실패 시 수행할 수 있는 작업 - .backoffLimit를 향하는 카운터 작업의 .status.failed 필드로 표시되는 이 증가되지 않으며 대체 Pod가 생성됩니다.

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

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

값

배열(정수)

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

status

string

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

type

string

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

활성 상태

integer

보류 중 Pod 및 실행 중인 Pod 수입니다.

completedIndexes

string

CompletedIndexes는 텍스트 형식으로 .spec.completionMode = "Indexed"인 경우 완료된 인덱스를 보유합니다. 인덱스는 쉼표로 구분된 10진수 정수로 표시됩니다. 숫자가 늘어나는 순서로 나열됩니다. 세 개 이상의 연속 숫자가 압축되고 시리즈의 첫 번째 요소와 마지막 요소로 표현되며 하이픈으로 구분됩니다. 예를 들어 완료된 인덱스가 1, 3, 4, 5 및 7인 경우 해당 인덱스가 "1,3-5,7"으로 표시됩니다.

completionTime

시간

작업이 완료된 시간을 나타냅니다. 별도의 작업에 대해 수행 순서에 따라 설정되는 것은 보장되지 않습니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. 완료 시간은 작업이 성공적으로 완료된 경우에만 설정됩니다.

conditions

array

오브젝트의 현재 상태에 대한 사용 가능한 최신 관찰입니다. 작업이 실패하면 조건 중 하나에 "Failed" 및 status true가 있습니다. 작업이 일시 중지되면 조건 중 하나에 "Suspended" 및 status true가 있습니다. 작업이 다시 시작되면 이 조건의 상태는 false가 됩니다. 작업이 완료되면 조건 중 하나에 "Complete" 및 status true가 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/

conditions[]

object

JobCondition은 작업의 현재 상태를 설명합니다.

failed

integer

실패한 Pod 수입니다.

Ready

integer

Ready 조건이 있는 Pod 수입니다.

이 필드는 베타 수준입니다. 기능 게이트 JobReadyPods가 활성화된 경우 작업 컨트롤러에서 필드를 채웁니다(기본적으로 활성화).

startTime

시간

작업 컨트롤러가 작업 처리를 시작한 시간을 나타냅니다. 작업이 일시 중지된 상태에서 생성되면 이 필드는 처음 다시 시작할 때까지 설정되지 않습니다. 이 필드는 일시 중지에서 작업을 다시 시작할 때마다 재설정됩니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

succeeded

integer

성공 단계에 도달한 Pod 수입니다.

uncountedTerminatedPods

object

UncountedTerminatedPods는 종료되었지만 작업 상태 카운터에서 고려하지 않은 Pod의 UID를 보유하고 있습니다.

lastProbeTime

시간

조건을 마지막으로 확인한 시간입니다.

lastTransitionTime

시간

상태가 다른 상태에서 다른 상태로 전환되는 마지막 시간입니다.

message

string

마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

조건의 마지막 전환 이유

status

string

조건의 상태, True, False, 알 수 없음.

type

string

작업 조건 유형, 완료 또는 실패.

failed

배열(문자열)

failed에는 실패한 Pod의 UID가 포함되어 있습니다.

succeeded

배열(문자열)

succeeded에는 성공한 Pod의 UID가 있습니다.