워크로드 API


OpenShift Container Platform 4.12

워크로드 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

이 문서에서는 OpenShift Container Platform 워크로드 API 오브젝트 및 세부 사양에 대해 설명합니다.

1장. 워크로드 API

1.1. BuildConfig [build.openshift.io/v1]

설명

빌드 구성은 새 컨테이너 이미지에 대한 빌드 프로세스를 정의합니다. 세 가지 유형의 빌드가 가능합니다. 즉 Dockerfile을 사용하는 컨테이너 이미지 빌드, 실행할 수 있는 소스 코드를 허용하는 특별히 준비된 기본 이미지를 사용하는 S2I(Source-to-Image) 빌드, // 임의의 컨테이너 이미지를 기반으로 실행하고 빌드 매개변수를 허용할 수 있는 사용자 정의 빌드입니다. 빌드는 클러스터에서 실행되며 완료 시 "output" 섹션에 지정된 컨테이너 이미지 레지스트리로 푸시됩니다. 빌드는 Webhook를 통해 기본 이미지가 변경될 때 또는 사용자가 새 빌드를 수동으로 생성할 때 트리거할 수 있습니다.

빌드 구성에 의해 생성된 각 빌드에는 번호가 매겨지고 상위 구성을 다시 참조합니다. 여러 빌드를 한 번에 트리거할 수 있습니다. "output" 세트가 없는 빌드를 사용하여 코드를 테스트하거나 확인 빌드를 실행할 수 있습니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.2. Build [build.openshift.io/v1]

설명

빌드에서는 새 배포 가능 이미지를 생성하는 데 필요한 입력과 실행 상태 및 빌드를 실행한 Pod에 대한 참조를 캡슐화합니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.3. BuildLog [build.openshift.io/v1]

설명

BuildLog는 빌드 로그 리디렉션과 연결된 (사용되지 않음) 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.4. BuildRequest [build.openshift.io/v1]

설명

BuildRequest는 빌드 생성기에 매개변수를 전달하는 데 사용되는 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.5. CronJob [batch/v1]

설명
CronJob은 단일 cron 작업의 구성을 나타냅니다.
유형
object

1.6. DaemonSet [apps/v1]

설명
DaemonSet은 데몬 세트의 구성을 나타냅니다.
유형
object

1.7. 배포 [apps/v1]

설명
배포를 사용하면 Pod 및 ReplicaSet에 대한 선언적 업데이트가 활성화됩니다.
유형
object

1.8. DeploymentConfig [apps.openshift.io/v1]

설명

배포 구성은 Pod에 대한 템플릿을 정의하고 새 이미지 또는 구성 변경 배포를 관리합니다. 단일 배포 구성은 일반적으로 단일 마이크로 서비스와 유사합니다. 전체 재시작, 사용자 정의 롤링 업데이트, 완전히 사용자 지정 동작, 사전 및 배포 후 후크를 비롯한 다양한 배포 패턴을 지원할 수 있습니다. 각 개별 배포는 복제 컨트롤러로 표시됩니다.

구성이 변경되거나 이미지 스트림의 태그가 변경되면 배포가 "triggered"됩니다. 배포를 수동으로 제어할 수 있도록 트리거를 비활성화할 수 있습니다. "전략"은 배포 수행 방법을 결정하고 언제든지 변경될 수 있습니다. latestVersion 필드는 새로운 배포가 어떤 수단에 의해 트리거될 때 업데이트됩니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.9. DeploymentConfigRollback [apps.openshift.io/v1]

설명

DeploymentConfigRollback은 롤백 생성에 대한 입력을 제공합니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.10. DeploymentLog [apps.openshift.io/v1]

설명

DeploymentLog는 배포 로그를 나타냅니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.11. DeploymentRequest [apps.openshift.io/v1]

설명

DeploymentRequest는 새 배포에 대한 배포 구성에 대한 요청입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

1.12. 작업 [batch/v1]

설명
job은 단일 작업의 구성을 나타냅니다.
유형
object

1.13. 포드 [v1]

설명
Pod는 호스트에서 실행할 수 있는 컨테이너 컬렉션입니다. 이 리소스는 클라이언트에서 생성하며 호스트에 예약됩니다.
유형
object

1.14. ReplicationController [v1]

설명
복제 컨트롤러의 구성을 나타냅니다.
유형
object

1.15. PersistentVolume [v1]

설명
PV(PersistentVolume)는 관리자가 프로비저닝한 스토리지 리소스입니다. 이는 노드와 유사합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes
유형
object

1.16. ReplicaSet [apps/v1]

설명
ReplicaSet은 지정된 수의 Pod 복제본이 지정된 시간에 실행되도록 합니다.
유형
object

1.17. StatefulSet [apps/v1]

설명

StatefulSet은 일관된 ID가 있는 Pod 세트를 나타냅니다. ID는 다음과 같이 정의됩니다. - 네트워크: 단일 안정적인 DNS 및 호스트 이름. - 스토리지: 요청된 만큼 많은 VolumeClaims입니다.

StatefulSet은 지정된 네트워크 ID가 항상 동일한 스토리지 ID에 매핑되도록 합니다.

유형
object

2장. BuildConfig [build.openshift.io/v1]

설명

빌드 구성은 새 컨테이너 이미지에 대한 빌드 프로세스를 정의합니다. 세 가지 유형의 빌드가 가능합니다. 즉 Dockerfile을 사용하는 컨테이너 이미지 빌드, 실행할 수 있는 소스 코드를 허용하는 특별히 준비된 기본 이미지를 사용하는 S2I(Source-to-Image) 빌드, // 임의의 컨테이너 이미지를 기반으로 실행하고 빌드 매개변수를 허용할 수 있는 사용자 정의 빌드입니다. 빌드는 클러스터에서 실행되며 완료 시 "output" 섹션에 지정된 컨테이너 이미지 레지스트리로 푸시됩니다. 빌드는 Webhook를 통해 기본 이미지가 변경될 때 또는 사용자가 새 빌드를 수동으로 생성할 때 트리거할 수 있습니다.

빌드 구성에 의해 생성된 각 빌드에는 번호가 매겨지고 상위 구성을 다시 참조합니다. 여러 빌드를 한 번에 트리거할 수 있습니다. "output" 세트가 없는 빌드를 사용하여 코드를 테스트하거나 확인 빌드를 실행할 수 있습니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • spec

2.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

 

spec

object

BuildConfigSpec에서는 빌드 생성 시기와 방법을 설명합니다.

status

object

BuildConfigStatus에는 빌드 구성 오브젝트의 현재 상태가 포함됩니다.

2.1.1. .spec

설명
BuildConfigSpec에서는 빌드 생성 시기와 방법을 설명합니다.
유형
object
필수 항목
  • 전략
속성유형설명

completionDeadlineSeconds

integer

completionDeadlineSeconds는 시스템에서 빌드 Pod가 예약되는 시점부터 계산되는 선택적 기간(초)입니다. 시스템이 빌드를 적극적으로 종료하려고 시도하기 전에 빌드가 노드에서 활성화될 수 있습니다. 값은 양의 정수여야 합니다.

failedBuildsHistoryLimit

integer

failedBuildsHistoryLimit은 유지할 수 없는 이전 빌드 수입니다. BuildConfig가 생성되면 이 값을 설정하지 않으면 가장 최근 실패한 빌드 5개가 유지됩니다. BuildConfig가 생성된 후 제거된 경우 실패한 모든 빌드가 유지됩니다.

mountTrustedCA

boolean

mountTrustedCA 바인딩은 클러스터의 프록시 구성에 정의된 대로 클러스터의 신뢰할 수 있는 인증 기관을 빌드에 마운트합니다. 이를 통해 개인 아티팩트 리포지토리 및 HTTPS 프록시와 같은 사용자 정의 PKI 인증 기관에서 서명한 빌드 신뢰 구성 요소 내의 프로세스를 수행할 수 있습니다.

이 필드가 true로 설정되면 빌드 내의 /etc/pki/ca-trust 의 콘텐츠가 빌드 컨테이너에 의해 관리되고 이 디렉터리 또는 해당 하위 디렉터리(예: Dockerfile RUN 명령 내)에 대한 변경 사항은 빌드의 출력 이미지에 유지되지 않습니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 빌드 Pod가 노드에 적합한 경우 클러스터의 기본 빌드 노드 선택기 값으로 재정의할 수 있는 선택기입니다. 빈 맵 또는 값이 있는 맵으로 설정하면 기본 빌드 노드 선택기 값이 무시됩니다.

출력

object

BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.

postCommit

object

BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.

후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.

후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 rake test --verbose 를 실행합니다.

1. 쉘 스크립트:

"postCommit": { "script": "rake test --verbose", }

위의 형식은 다음과 같은 편리한 형식입니다.

"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }

2. 이미지 진입점으로서의 명령:

"postCommit": { "commit": ["rake", "test", "--verbose"] }

명령은 Docker: https://docs.docker.com/engine/reference/builder/#entrypoint 에 설명된 대로 exec 형식의 이미지 진입점을 재정의합니다.

3. 기본 진입점에 인수를 전달합니다.

"postCommit": { "args": ["rake", "test", "--verbose"] }

이 형식은 이미지 진입점에서 인수를 처리할 수 있는 경우에만 유용합니다.

4. 인수가 있는 쉘 스크립트:

"postCommit": { "script": "rake test $ 1", "args": ["-verbose"] }

이 양식은 쉘 스크립트에서 올바르게 인용하기 어려울 인수를 전달해야 하는 경우에 유용합니다. 스크립트에서 "/bin/sh"와 $ 1, 2 등은 Args의 위치 인수입니다.

5. 인수가 있는 명령:

"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }

이 양식은 Command 슬라이스에 인수를 추가하는 것과 동일합니다.

스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.

resources

resourceRequirements

리소스는 빌드를 실행하기 위해 리소스 요구 사항을 계산합니다.

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

runPolicy

string

runPolicy는 이 빌드 구성에서 생성된 새 빌드가 실행을 위해 예약되는 방법을 설명합니다. 지정하지 않으면 선택 사항입니다. 기본값은 "Serial"입니다.

serviceAccount

string

ServiceAccount는 이 빌드에서 생성한 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. Pod는 ServiceAccount에서 참조하는 시크릿을 사용할 수 있습니다.

소스

object

BuildSource는 빌드에 사용되는 SCM입니다.

전략

object

BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.

successfulBuildsHistoryLimit

integer

successfulBuildsHistoryLimit은 유지할 이전 빌드 수입니다. BuildConfig가 생성되면 이 값을 설정하지 않으면 가장 최근의 빌드 5개가 유지됩니다. BuildConfig가 생성된 후 제거된 경우 모든 성공적인 빌드가 유지됩니다.

Trigger

array

트리거는 BuildConfig에서 새 빌드를 시작하는 방법을 결정합니다. 트리거가 정의되지 않은 경우 명시적 클라이언트 빌드 생성으로 인해 새 빌드가 발생할 수 있습니다.

triggers[]

object

BuildTriggerPolicy는 새 Build를 생성하는 단일 트리거에 대한 정책을 설명합니다.

2.1.2. .spec.output

설명
BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.
유형
object
속성유형설명

imageLabels

array

imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.

imageLabels[]

object

ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.

pushSecret

LocalObjectReference

pushSecret은 사용 가능한 인증 Docker Registry(또는 Docker Hub)에 대한 Docker 푸시를 실행하는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

다음으로 변경

ObjectReference

이 빌드의 출력을 내보낼 선택적 위치를 정의하려면 다음을 수행합니다. kind는 'ImageStreamTag' 또는 'DockerImage' 중 하나여야 합니다. 이 값은 내보낼 컨테이너 이미지 리포지토리를 찾는 데 사용됩니다. ImageStreamTag의 경우 Namespace를 지정하지 않는 한 ImageStreamTag는 빌드의 네임스페이스에서 검색됩니다.

2.1.3. .spec.output.imageLabels

설명
imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.
유형
array

2.1.4. .spec.output.imageLabels[]

설명
ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다.

value

string

value는 레이블의 리터럴 값을 정의합니다.

2.1.5. .spec.postCommit

설명

BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.

후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.

후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 rake test --verbose 를 실행합니다.

  1. 쉘 스크립트:

    "postCommit": {
      "script": "rake test --verbose",
    }
    The above is a convenient form which is equivalent to:
    "postCommit": {
      "command": ["/bin/sh", "-ic"],
      "args":    ["rake test --verbose"]
    }
  2. 이미지 진입점으로서의 명령:

    "postCommit": {
      "commit": ["rake", "test", "--verbose"]
    }
    Command overrides the image entrypoint in the exec form, as documented in
    Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
  3. 기본 진입점에 인수를 전달합니다.

    "postCommit": {
     "args": ["rake", "test", "--verbose"]
    }
    This form is only useful if the image entrypoint can handle arguments.
  4. 인수가 있는 쉘 스크립트:

    "postCommit": {
      "script": "rake test $1",
      "args":   ["--verbose"]
    }
    This form is useful if you need to pass arguments that would otherwise be
    hard to quote properly in the shell script. In the script, $0 will be
    "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
  5. 인수가 있는 명령:

    "postCommit": {
      "command": ["rake", "test"],
      "args":    ["--verbose"]
    }
    This form is equivalent to appending the arguments to the Command slice.

스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.

유형
object
속성유형설명

args

배열(문자열)

인수는 Command, Script 또는 컨테이너 이미지의 기본 진입점에 제공되는 인수 목록입니다. 인수는 명령을 실행한 직후에 배치됩니다.

command

배열(문자열)

명령은 실행할 명령입니다. 스크립트로 지정할 수 없습니다. 이미지에 /bin/sh 가 없거나 쉘을 사용하지 않는 경우 이 작업이 필요할 수 있습니다. 다른 모든 경우에는 스크립트를 사용하는 것이 더 편리할 수 있습니다.

script

string

script는 /bin/sh -ic 를 사용하여 실행할 쉘 스크립트입니다. command를 사용하여 지정할 수 없습니다. 스크립트를 사용하여 스크립트를 사용하여 빌드 후 후크를 실행합니다(예: rake test 로 단위 테스트를 실행하는 경우). 이미지 진입점을 제어해야 하거나 이미지에 /bin/sh 가 없는 경우 명령 및/또는 Args를 사용합니다. 쉘에 적절한 컬렉션을 활성화하려면 -i 플래그는 소프트웨어 컬렉션(SCL)을 사용하는 CentOS 및 RHEL 이미지를 지원하는 데 필요합니다. 예를 들어 Ruby 이미지에서 이 값은 PATH에서 ruby,bundle 및 기타 바이너리를 사용할 수 있도록 하는 데 필요합니다.

2.1.6. .spec.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

2.1.7. .spec.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

2.1.8. .spec.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

2.1.9. .spec.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

2.1.10. .spec.source

설명
BuildSource는 빌드에 사용되는 SCM입니다.
유형
object
속성유형설명

바이너리

object

BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.

configMaps

array

ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.

configMaps[]

object

ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.

contextDir

string

contextDir은 애플리케이션의 소스 코드가 있는 하위 디렉터리를 지정합니다. 그러면 리포지토리의 root가 아닌 다른 디렉터리에 빌드 가능한 소스가 있을 수 있습니다.

dockerfile

string

Dockerfile은 빌드해야 하는 Dockerfile의 원시 콘텐츠입니다. 이 옵션을 지정하면 전략 기본 이미지를 기반으로 FROM을 수정하고 전략 환경의 추가 ENV 스탠자가 FROM 뒤에 추가되지만 나머지 Dockerfile 스탠자 전에 추가됩니다. Dockerfile 소스 유형은 git과 같은 다른 옵션과 함께 사용할 수 있습니다. 이 경우 Git 리포지터리에 컨텍스트 dir에서 대체된 모든 Dockerfile이 있습니다.

git

object

GitBuildSource는 Git SCM의 매개변수를 정의합니다.

이미지

array

이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.

images[]

object

ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).

secrets

array

보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.

secrets[]

object

SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.

sourceSecret

LocalObjectReference

sourceSecret은 프라이빗 리포지토리 복제를 위한 인증을 설정하는 데 사용되는 보안의 이름입니다. 보안에는 원격 리포지토리에 대한 유효한 인증 정보가 포함되어 있습니다. 여기서 데이터의 키는 사용할 인증 방법을 나타내며 value는 base64로 인코딩된 인증 정보입니다. 지원되는 인증 방법은 ssh-privatekey입니다.

type

string

허용할 빌드 입력 유형

2.1.11. .spec.source.binary

설명
BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.
유형
object
속성유형설명

asFile

string

Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 /webapp.war 로 배치됩니다. 비어 있는 경우 Docker 및 Source 빌드 전략에서는 이 파일이 zip, tar 또는 tar.gz 파일이라고 가정하고 소스로 추출합니다. 사용자 지정 전략은 이 바이너리를 표준 입력으로 수신합니다. 이 파일 이름은 슬래시를 포함하거나 '..' 또는 '.'일 수 없습니다.

2.1.12. .spec.source.configMaps

설명
ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.
유형
array

2.1.13. .spec.source.configMaps[]

설명
ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
유형
object
필수 항목
  • configMap
속성유형설명

configMap

LocalObjectReference

ConfigMap은 빌드에서 사용하려는 기존 구성 맵에 대한 참조입니다.

destinationDir

string

destinationDir은 configmap의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다.

2.1.14. .spec.source.git

설명
GitBuildSource는 Git SCM의 매개변수를 정의합니다.
유형
object
필수 항목
  • URI
속성유형설명

httpProxy

string

httpProxy는 http를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다.

httpsProxy

string

httpsProxy는 https를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다.

noProxy

string

noProxy는 프록시를 사용하지 않아야 하는 도메인 목록입니다.

ref

string

ref는 빌드할 분기/태그/참조입니다.

URI

string

URI는 빌드될 소스를 가리킵니다. 소스 구조는 실행할 빌드 유형에 따라 달라집니다.

2.1.15. .spec.source.images

설명
이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.
유형
array

2.1.16. .spec.source.images[]

설명
ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).
유형
object
필수 항목
  • from
속성유형설명

as

배열(문자열)

다중 단계 컨테이너 이미지 빌드 중에 이 소스를 사용할 이미지 이름 목록입니다. 예를 들어 "COPY --from=nginx:latest"를 사용하는 Dockerfile은 먼저 이 필드에 "nginx:latest"가 있는 이미지 소스를 직접 가져오기 전에 확인합니다. Dockerfile에서 이미지 소스를 참조하지 않으면 무시됩니다. 이 필드와 경로는 모두 설정될 수 있으며, 이 경우 콘텐츠가 두 번 사용됩니다.

from

ObjectReference

에서 소스를 복사할 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 참조입니다.

경로

array

경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.

paths[]

object

ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.

pullSecret

LocalObjectReference

pullSecret은 레지스트리에서 이미지를 가져오는 데 사용할 보안에 대한 참조로, OpenShift 레지스트리에서 이미지를 가져오는 경우 이 필드를 설정할 필요가 없습니다.

2.1.17. .spec.source.images[].paths

설명
경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.
유형
array

2.1.18. .spec.source.images[].paths[]

설명
ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.
유형
object
필수 항목
  • sourcePath
  • destinationDir
속성유형설명

destinationDir

string

destinationDir은 이미지에서 복사한 파일이 배치되는 빌드 디렉터리 내의 상대 디렉터리입니다.

sourcePath

string

SourcePath는 빌드 디렉터리에 복사할 이미지 내부의 파일 또는 디렉터리의 절대 경로입니다. 소스 경로가 /.로 종료되면 디렉터리의 콘텐츠가 복사되지만 디렉터리 자체는 대상에 생성되지 않습니다.

2.1.19. .spec.source.secrets

설명
보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.
유형
array

2.1.20. .spec.source.secrets[]

설명
SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
유형
object
필수 항목
  • Secret
속성유형설명

destinationDir

string

destinationDir은 시크릿의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 나중에 스크립트가 완료되면 삽입된 모든 파일이 0 길이로 잘립니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다.

Secret

LocalObjectReference

Secret은 빌드에서 사용하려는 기존 보안에 대한 참조입니다.

2.1.21. .spec.strategy

설명
BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.
유형
object
속성유형설명

customStrategy

object

CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.

dockerStrategy

object

DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.

jenkinsPipelineStrategy

object

JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용

sourceStrategy

object

SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.

type

string

유형은 빌드 전략의 종류입니다.

2.1.22. .spec.strategy.customStrategy

설명
CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.
유형
object
필수 항목
  • from
속성유형설명

buildAPIVersion

string

buildAPIVersion은 Build 오브젝트 직렬화 및 사용자 정의 빌더에 대해 요청된 API 버전입니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

exposeDockerSocket

boolean

exposeDockerSocket을 사용하면 컨테이너 내부에서 Docker 명령(및 컨테이너 이미지 빌드)을 실행할 수 있습니다.

forcePull

boolean

forcePull은 컨트롤러가 항상 빌더의 이미지를 가져오도록 빌드 Pod를 구성해야 하는지 또는 로컬에 없는 경우에만 가져오기를 수행해야 하는지 설명합니다.

from

ObjectReference

에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

secrets

array

보안은 빌드 Pod에 포함될 추가 보안 목록입니다.

secrets[]

object

SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.

2.1.23. .spec.strategy.customStrategy.secrets

설명
보안은 빌드 Pod에 포함될 추가 보안 목록입니다.
유형
array

2.1.24. .spec.strategy.customStrategy.secrets[]

설명
SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.
유형
object
필수 항목
  • secretSource
  • mountPath
속성유형설명

mountPath

string

mountPath는 시크릿을 마운트할 경로입니다.

secretSource

LocalObjectReference

secretSource는 보안에 대한 참조입니다.

2.1.25. .spec.strategy.dockerStrategy

설명
DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.
유형
object
속성유형설명

buildArgs

array(EnvVar)

buildArgs에는 Dockerfile에서 해결할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 을 참조하십시오. 참고: 'name' 및 '값' 필드만 지원됩니다. 'valueFrom' 필드의 설정은 모두 무시됩니다.

dockerfilePath

string

dockerfilePath는 컨텍스트 루트(contextDir)를 기준으로 컨테이너 이미지를 빌드하는 데 사용할 Dockerfile의 경로입니다. 설정되지 않은 경우 기본값은 Dockerfile 입니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

forcePull

boolean

forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다.

from

ObjectReference

에서 빌드의 Dockerfile의 FROM 이미지를 재정의하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. Dockerfile에서 다중 단계 빌드를 사용하는 경우 파일의 마지막 FROM 지시문에 있는 이미지를 대체합니다.

imageOptimizationPolicy

string

imageOptimizationPolicy는 이미지 빌드에 소요되는 최종 크기 또는 시간을 줄이기 위해 이미지를 빌드할 때 사용할 수 있는 최적화를 설명합니다. 기본 정책은 '없음'으로, 최종 빌드 이미지가 컨테이너 이미지 빌드 API에서 생성한 이미지와 동일합니다. 실험적 정책 'SkipLayers'는 각 이미지 단계 사이에 새 계층을 커밋하지 않으며 Dockerfile에서 '없음' 정책과의 호환성을 제공할 수 없는 경우 실패합니다. 추가 실험 정책 'SkipLayersAndWarn'은 'SkipLayers'와 동일하지만 호환성을 유지할 수 없는 경우 경고합니다.

noCache

boolean

noCache true로 설정하면 --no-cache=true 플래그를 사용하여 컨테이너 이미지 빌드를 실행해야 함을 나타냅니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

volumes

array

volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.

2.1.26. .spec.strategy.dockerStrategy.volumes

설명
volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
유형
array

2.1.27. .spec.strategy.dockerStrategy.volumes[]

설명
BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.
유형
object
필수 항목
  • name
  • 소스
  • mounts
속성유형설명

mounts

array

mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.

mounts[]

object

BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.

name

string

name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

소스

object

BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.

2.1.28. .spec.strategy.dockerStrategy.volumes[].mounts

설명
mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
유형
array

2.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[]

설명
BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • destinationPath
속성유형설명

destinationPath

string

destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다.

2.1.30. .spec.strategy.dockerStrategy.volumes[].source

설명
BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
유형
object
필수 항목
  • type
속성유형설명

configMap

ConfigMapVolumeSource

ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다.

csi

CSIVolumeSource

CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다.

Secret

SecretVolumeSource

secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

type

string

type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap

2.1.31. .spec.strategy.jenkinsPipelineStrategy

설명
JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용
유형
object
속성유형설명

env

array(EnvVar)

env에는 빌드 파이프라인에 전달할 추가 환경 변수가 포함되어 있습니다.

Jenkinsfile

string

Jenkinsfile은 Jenkins 파이프라인 빌드를 정의하는 Jenkinsfile의 선택적 원시 콘텐츠를 정의합니다.

jenkinsfilePath

string

jenkinsfilePath는 컨텍스트 루트(contextDir)를 기준으로 파이프라인을 구성하는 데 사용할 Jenkinsfile의 선택적 경로입니다. JenkinsfilePath 및 Jenkinsfile 둘 다 지정되지 않은 경우 기본값은 지정된 contextDir의 루트에서 Jenkinsfile으로 설정됩니다.

2.1.32. .spec.strategy.sourceStrategy

설명
SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.
유형
object
필수 항목
  • from
속성유형설명

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

forcePull

boolean

forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다.

from

ObjectReference

에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다.

증분

boolean

증분 플래그는 true인 경우 소스 빌드가 증분 빌드를 수행하도록 강제 적용합니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

스크립트

string

스크립트는 소스 스크립트의 위치입니다.

volumes

array

volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.

2.1.33. .spec.strategy.sourceStrategy.volumes

설명
volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
유형
array

2.1.34. .spec.strategy.sourceStrategy.volumes[]

설명
BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.
유형
object
필수 항목
  • name
  • 소스
  • mounts
속성유형설명

mounts

array

mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.

mounts[]

object

BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.

name

string

name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

소스

object

BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.

2.1.35. .spec.strategy.sourceStrategy.volumes[].mounts

설명
mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
유형
array

2.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[]

설명
BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • destinationPath
속성유형설명

destinationPath

string

destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다.

2.1.37. .spec.strategy.sourceStrategy.volumes[].source

설명
BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
유형
object
필수 항목
  • type
속성유형설명

configMap

ConfigMapVolumeSource

ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다.

csi

CSIVolumeSource

CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다.

Secret

SecretVolumeSource

secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

type

string

type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap

2.1.38. .spec.triggers

설명
트리거는 BuildConfig에서 새 빌드를 시작하는 방법을 결정합니다. 트리거가 정의되지 않은 경우 명시적 클라이언트 빌드 생성으로 인해 새 빌드가 발생할 수 있습니다.
유형
array

2.1.39. .spec.triggers[]

설명
BuildTriggerPolicy는 새 Build를 생성하는 단일 트리거에 대한 정책을 설명합니다.
유형
object
필수 항목
  • type
속성유형설명

bitbucket

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

일반

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

github

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

gitlab

object

WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.

imageChange

object

ImageChangeTrigger를 사용하면 ImageStream이 변경될 때 빌드를 트리거할 수 있습니다.

type

string

type은 빌드 트리거의 유형입니다. 유효한 값은 다음과 같습니다.

- GitHubWebHookBuildTriggerType은 GitHub Webhook 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- 일반 GenericWebHookBuildType은 일반 웹 후크 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- GitLab GitLabWebHookBuildTriggerType은 GitLab Webhook 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- Bitbucket BitbucketWebHookBuildTriggerType은 Bitbucket Webhook 호출에서 빌드를 시작하는 트리거를 나타냅니다.

- ImageChange ImageChangeBuildTriggerType은 새 버전의 이미지 사용 가능 여부에 따라 빌드를 시작하는 트리거를 나타냅니다.

- ConfigChange ConfigChangeBuildTriggerType은 초기 빌드 구성 생성 경고에 대한 빌드를 트리거합니다. 나중에 구성 변경 시 빌드를 트리거하도록 동작이 변경됩니다.

2.1.40. .spec.triggers[].bitbucket

설명
WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
유형
object
속성유형설명

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

2.1.41. .spec.triggers[].bitbucket.secretReference

설명
SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

2.1.42. .spec.triggers[].generic

설명
WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
유형
object
속성유형설명

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

2.1.43. .spec.triggers[].generic.secretReference

설명
SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

2.1.44. .spec.triggers[].github

설명
WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
유형
object
속성유형설명

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

2.1.45. .spec.triggers[].github.secretReference

설명
SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

2.1.46. .spec.triggers[].gitlab

설명
WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
유형
object
속성유형설명

allowEnv

boolean

allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다.

Secret

string

요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다.

secretReference

object

SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.

2.1.47. .spec.triggers[].gitlab.secretReference

설명
SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다.

2.1.48. .spec.triggers[].imageChange

설명
ImageChangeTrigger를 사용하면 ImageStream이 변경될 때 빌드를 트리거할 수 있습니다.
유형
object
속성유형설명

from

ObjectReference

에서 은 업데이트될 때 빌드를 트리거하는 ImageStreamTag에 대한 참조입니다. From이 지정되지 않으면 빌드 전략의 From 이미지가 사용됩니다. 빈 From 참조가 있는 ImageChangeTrigger 하나만 빌드 구성에서 허용됩니다.

lastTriggeredImageID

string

lastTriggeredImageID는 ImageChangeController에서 내부적으로 사용하여 빌드에 마지막으로 사용된 이미지 ID를 저장합니다. 이 필드는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 더 이상 사용되지 않음

일시 중지됨

boolean

이 트리거를 일시적으로 비활성화하면 paused가 적용됩니다. 선택 사항입니다.

2.1.49. .status

설명
BuildConfigStatus에는 빌드 구성 오브젝트의 현재 상태가 포함됩니다.
유형
object
필수 항목
  • lastVersion
속성유형설명

imageChangeTriggers

array

imageChangeTriggers는 lastTriggeredImageID에 대한 OpenShift APIServer에서 조정하는 값을 포함하여 BuildConfigSpec에 지정된 ImageChangeTrigger의 런타임 상태를 캡처합니다. spec의 각 이미지 변경 트리거에 대해 이 배열에 단일 항목이 있습니다. 각 트리거 상태는 트리거의 소스 역할을 하는 ImageStreamTag를 참조합니다.

imageChangeTriggers[]

object

ImageChangeTriggerStatus는 BuildConfigSpec.Triggers 구조에 지정된 관련 ImageChangeTrigger 정책의 최신 확인된 상태를 추적합니다.

lastVersion

integer

lastVersion은 마지막 트리거된 빌드 수를 알리는 데 사용됩니다.

2.1.50. .status.imageChangeTriggers

설명
imageChangeTriggers는 lastTriggeredImageID에 대한 OpenShift APIServer에서 조정하는 값을 포함하여 BuildConfigSpec에 지정된 ImageChangeTrigger의 런타임 상태를 캡처합니다. spec의 각 이미지 변경 트리거에 대해 이 배열에 단일 항목이 있습니다. 각 트리거 상태는 트리거의 소스 역할을 하는 ImageStreamTag를 참조합니다.
유형
array

2.1.51. .status.imageChangeTriggers[]

설명
ImageChangeTriggerStatus는 BuildConfigSpec.Triggers 구조에 지정된 관련 ImageChangeTrigger 정책의 최신 확인된 상태를 추적합니다.
유형
object
속성유형설명

from

object

ImageStreamTagReference는 네임스페이스 및 이름으로 이미지 변경 트리거의 ImageStreamTag를 참조합니다.

lastTriggerTime

시간

lastTriggerTime은 이 특정 ImageStreamTag가 빌드가 시작되는 마지막 시간입니다. 이 필드는 이 트리거가 특별히 Build를 시작한 경우에만 업데이트됩니다.

lastTriggeredImageID

string

lastTriggeredImageID는 이 BuildConfig의 Build가 시작될 때 ImageStreamTag의 sha/id를 나타냅니다. 이 ImageStreamTag가 Build가 시작된 이유가 아니더라도 lastTriggeredImageID가 이 BuildConfig에 대한 Build가 시작될 때마다 업데이트됩니다.

2.1.52. .status.imageChangeTriggers[].from

설명
ImageStreamTagReference는 네임스페이스 및 이름으로 이미지 변경 트리거의 ImageStreamTag를 참조합니다.
유형
object
속성유형설명

name

string

name은 ImageChangeTrigger에 대한 ImageStreamTag의 이름입니다.

네임스페이스

string

namespace는 ImageChangeTrigger의 ImageStreamTag가 있는 네임스페이스입니다.

2.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/build.openshift.io/v1/buildconfigs

    • GET: BuildConfig 유형의 오브젝트 목록 또는 감시
  • /apis/build.openshift.io/v1/watch/buildconfigs

    • GET: BuildConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs

    • DELETE: BuildConfig 컬렉션 삭제
    • GET: BuildConfig 유형의 오브젝트 목록 또는 감시
    • POST: BuildConfig 생성
  • /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs

    • GET: BuildConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}

    • DELETE: BuildConfig 삭제
    • GET: 지정된 BuildConfig 읽기
    • PATCH: 지정된 BuildConfig를 부분적으로 업데이트합니다.
    • PUT: 지정된 BuildConfig를 교체
  • /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs/{name}

    • GET: BuildConfig 유형의 오브젝트를 감시합니다. 더 이상 사용되지 않는 오브젝트: 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.

2.2.1. /apis/build.openshift.io/v1/buildconfigs

표 2.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
BuildConfig 유형의 오브젝트 나열 또는 감시
표 2.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildConfigList schema

401 - 무단

2.2.2. /apis/build.openshift.io/v1/watch/buildconfigs

표 2.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
BuildConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 2.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

2.2.3. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs

표 2.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 2.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
BuildConfig 컬렉션 삭제
표 2.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 2.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 2.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
BuildConfig 유형의 오브젝트 나열 또는 감시
표 2.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 2.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildConfigList schema

401 - 무단

HTTP 방법
POST
설명
BuildConfig 생성
표 2.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 2.13. 본문 매개변수
매개변수유형설명

body

BuildConfig schema

 
표 2.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildConfig schema

201 - 생성됨

BuildConfig schema

202 - 승인됨

BuildConfig schema

401 - 무단

2.2.4. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs

표 2.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 2.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
BuildConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 2.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

2.2.5. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}

표 2.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

BuildConfig 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 2.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
BuildConfig 삭제
표 2.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 2.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 2.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 BuildConfig 읽기
표 2.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildConfig schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 BuildConfig를 부분적으로 업데이트
표 2.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 2.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 2.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildConfig schema

201 - 생성됨

BuildConfig schema

401 - 무단

HTTP 방법
PUT
설명
지정된 BuildConfig를 교체
표 2.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 2.28. 본문 매개변수
매개변수유형설명

body

BuildConfig schema

 
표 2.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildConfig schema

201 - 생성됨

BuildConfig schema

401 - 무단

2.2.6. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs/{name}

표 2.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

BuildConfig 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 2.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
더 이상 사용되지 않는 BuildConfig 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 2.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

3장. Build [build.openshift.io/v1]

설명

빌드에서는 새 배포 가능 이미지를 생성하는 데 필요한 입력과 실행 상태 및 빌드를 실행한 Pod에 대한 참조를 캡슐화합니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

3.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

 

spec

object

BuildSpec에는 빌드를 나타내는 정보와 빌드에 대한 추가 정보가 있습니다.

status

object

BuildStatus에는 빌드 상태가 포함되어 있습니다.

3.1.1. .spec

설명
BuildSpec에는 빌드를 나타내는 정보와 빌드에 대한 추가 정보가 있습니다.
유형
object
필수 항목
  • 전략
속성유형설명

completionDeadlineSeconds

integer

completionDeadlineSeconds는 시스템에서 빌드 Pod가 예약되는 시점부터 계산되는 선택적 기간(초)입니다. 시스템이 빌드를 적극적으로 종료하려고 시도하기 전에 빌드가 노드에서 활성화될 수 있습니다. 값은 양의 정수여야 합니다.

mountTrustedCA

boolean

mountTrustedCA 바인딩은 클러스터의 프록시 구성에 정의된 대로 클러스터의 신뢰할 수 있는 인증 기관을 빌드에 마운트합니다. 이를 통해 개인 아티팩트 리포지토리 및 HTTPS 프록시와 같은 사용자 정의 PKI 인증 기관에서 서명한 빌드 신뢰 구성 요소 내의 프로세스를 수행할 수 있습니다.

이 필드가 true로 설정되면 빌드 내의 /etc/pki/ca-trust 의 콘텐츠가 빌드 컨테이너에 의해 관리되고 이 디렉터리 또는 해당 하위 디렉터리(예: Dockerfile RUN 명령 내)에 대한 변경 사항은 빌드의 출력 이미지에 유지되지 않습니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 빌드 Pod가 노드에 적합한 경우 클러스터의 기본 빌드 노드 선택기 값으로 재정의할 수 있는 선택기입니다. 빈 맵 또는 값이 있는 맵으로 설정하면 기본 빌드 노드 선택기 값이 무시됩니다.

출력

object

BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.

postCommit

object

BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.

후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.

후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 rake test --verbose 를 실행합니다.

1. 쉘 스크립트:

"postCommit": { "script": "rake test --verbose", }

위의 형식은 다음과 같은 편리한 형식입니다.

"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }

2. 이미지 진입점으로서의 명령:

"postCommit": { "commit": ["rake", "test", "--verbose"] }

명령은 Docker: https://docs.docker.com/engine/reference/builder/#entrypoint 에 설명된 대로 exec 형식의 이미지 진입점을 재정의합니다.

3. 기본 진입점에 인수를 전달합니다.

"postCommit": { "args": ["rake", "test", "--verbose"] }

이 형식은 이미지 진입점에서 인수를 처리할 수 있는 경우에만 유용합니다.

4. 인수가 있는 쉘 스크립트:

"postCommit": { "script": "rake test $ 1", "args": ["-verbose"] }

이 양식은 쉘 스크립트에서 올바르게 인용하기 어려울 인수를 전달해야 하는 경우에 유용합니다. 스크립트에서 "/bin/sh"와 $ 1, 2 등은 Args의 위치 인수입니다.

5. 인수가 있는 명령:

"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }

이 양식은 Command 슬라이스에 인수를 추가하는 것과 동일합니다.

스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.

resources

resourceRequirements

리소스는 빌드를 실행하기 위해 리소스 요구 사항을 계산합니다.

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

serviceAccount

string

ServiceAccount는 이 빌드에서 생성한 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. Pod는 ServiceAccount에서 참조하는 시크릿을 사용할 수 있습니다.

소스

object

BuildSource는 빌드에 사용되는 SCM입니다.

전략

object

BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.

triggeredBy

array

TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.

triggeredBy[]

object

BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.

3.1.2. .spec.output

설명
BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.
유형
object
속성유형설명

imageLabels

array

imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.

imageLabels[]

object

ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.

pushSecret

LocalObjectReference

pushSecret은 사용 가능한 인증 Docker Registry(또는 Docker Hub)에 대한 Docker 푸시를 실행하는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

다음으로 변경

ObjectReference

이 빌드의 출력을 내보낼 선택적 위치를 정의하려면 다음을 수행합니다. kind는 'ImageStreamTag' 또는 'DockerImage' 중 하나여야 합니다. 이 값은 내보낼 컨테이너 이미지 리포지토리를 찾는 데 사용됩니다. ImageStreamTag의 경우 Namespace를 지정하지 않는 한 ImageStreamTag는 빌드의 네임스페이스에서 검색됩니다.

3.1.3. .spec.output.imageLabels

설명
imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.
유형
array

3.1.4. .spec.output.imageLabels[]

설명
ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다.

value

string

value는 레이블의 리터럴 값을 정의합니다.

3.1.5. .spec.postCommit

설명

BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.

후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.

후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 rake test --verbose 를 실행합니다.

  1. 쉘 스크립트:

    "postCommit": {
      "script": "rake test --verbose",
    }
    The above is a convenient form which is equivalent to:
    "postCommit": {
      "command": ["/bin/sh", "-ic"],
      "args":    ["rake test --verbose"]
    }
  2. 이미지 진입점으로서의 명령:

    "postCommit": {
      "commit": ["rake", "test", "--verbose"]
    }
    Command overrides the image entrypoint in the exec form, as documented in
    Docker: https://docs.docker.com/engine/reference/builder/#entrypoint.
  3. 기본 진입점에 인수를 전달합니다.

    "postCommit": {
     "args": ["rake", "test", "--verbose"]
    }
    This form is only useful if the image entrypoint can handle arguments.
  4. 인수가 있는 쉘 스크립트:

    "postCommit": {
      "script": "rake test $1",
      "args":   ["--verbose"]
    }
    This form is useful if you need to pass arguments that would otherwise be
    hard to quote properly in the shell script. In the script, $0 will be
    "/bin/sh" and $1, $2, etc, are the positional arguments from Args.
  5. 인수가 있는 명령:

    "postCommit": {
      "command": ["rake", "test"],
      "args":    ["--verbose"]
    }
    This form is equivalent to appending the arguments to the Command slice.

스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.

유형
object
속성유형설명

args

배열(문자열)

인수는 Command, Script 또는 컨테이너 이미지의 기본 진입점에 제공되는 인수 목록입니다. 인수는 명령을 실행한 직후에 배치됩니다.

command

배열(문자열)

명령은 실행할 명령입니다. 스크립트로 지정할 수 없습니다. 이미지에 /bin/sh 가 없거나 쉘을 사용하지 않는 경우 이 작업이 필요할 수 있습니다. 다른 모든 경우에는 스크립트를 사용하는 것이 더 편리할 수 있습니다.

script

string

script는 /bin/sh -ic 를 사용하여 실행할 쉘 스크립트입니다. command를 사용하여 지정할 수 없습니다. 스크립트를 사용하여 스크립트를 사용하여 빌드 후 후크를 실행합니다(예: rake test 로 단위 테스트를 실행하는 경우). 이미지 진입점을 제어해야 하거나 이미지에 /bin/sh 가 없는 경우 명령 및/또는 Args를 사용합니다. 쉘에 적절한 컬렉션을 활성화하려면 -i 플래그는 소프트웨어 컬렉션(SCL)을 사용하는 CentOS 및 RHEL 이미지를 지원하는 데 필요합니다. 예를 들어 Ruby 이미지에서 이 값은 PATH에서 ruby,bundle 및 기타 바이너리를 사용할 수 있도록 하는 데 필요합니다.

3.1.6. .spec.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

3.1.7. .spec.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

3.1.8. .spec.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.9. .spec.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.10. .spec.source

설명
BuildSource는 빌드에 사용되는 SCM입니다.
유형
object
속성유형설명

바이너리

object

BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.

configMaps

array

ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.

configMaps[]

object

ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.

contextDir

string

contextDir은 애플리케이션의 소스 코드가 있는 하위 디렉터리를 지정합니다. 그러면 리포지토리의 root가 아닌 다른 디렉터리에 빌드 가능한 소스가 있을 수 있습니다.

dockerfile

string

Dockerfile은 빌드해야 하는 Dockerfile의 원시 콘텐츠입니다. 이 옵션을 지정하면 전략 기본 이미지를 기반으로 FROM을 수정하고 전략 환경의 추가 ENV 스탠자가 FROM 뒤에 추가되지만 나머지 Dockerfile 스탠자 전에 추가됩니다. Dockerfile 소스 유형은 git과 같은 다른 옵션과 함께 사용할 수 있습니다. 이 경우 Git 리포지터리에 컨텍스트 dir에서 대체된 모든 Dockerfile이 있습니다.

git

object

GitBuildSource는 Git SCM의 매개변수를 정의합니다.

이미지

array

이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.

images[]

object

ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).

secrets

array

보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.

secrets[]

object

SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.

sourceSecret

LocalObjectReference

sourceSecret은 프라이빗 리포지토리 복제를 위한 인증을 설정하는 데 사용되는 보안의 이름입니다. 보안에는 원격 리포지토리에 대한 유효한 인증 정보가 포함되어 있습니다. 여기서 데이터의 키는 사용할 인증 방법을 나타내며 value는 base64로 인코딩된 인증 정보입니다. 지원되는 인증 방법은 ssh-privatekey입니다.

type

string

허용할 빌드 입력 유형

3.1.11. .spec.source.binary

설명
BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.
유형
object
속성유형설명

asFile

string

Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 /webapp.war 로 배치됩니다. 비어 있는 경우 Docker 및 Source 빌드 전략에서는 이 파일이 zip, tar 또는 tar.gz 파일이라고 가정하고 소스로 추출합니다. 사용자 지정 전략은 이 바이너리를 표준 입력으로 수신합니다. 이 파일 이름은 슬래시를 포함하거나 '..' 또는 '.'일 수 없습니다.

3.1.12. .spec.source.configMaps

설명
ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.
유형
array

3.1.13. .spec.source.configMaps[]

설명
ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
유형
object
필수 항목
  • configMap
속성유형설명

configMap

LocalObjectReference

ConfigMap은 빌드에서 사용하려는 기존 구성 맵에 대한 참조입니다.

destinationDir

string

destinationDir은 configmap의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다.

3.1.14. .spec.source.git

설명
GitBuildSource는 Git SCM의 매개변수를 정의합니다.
유형
object
필수 항목
  • URI
속성유형설명

httpProxy

string

httpProxy는 http를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다.

httpsProxy

string

httpsProxy는 https를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다.

noProxy

string

noProxy는 프록시를 사용하지 않아야 하는 도메인 목록입니다.

ref

string

ref는 빌드할 분기/태그/참조입니다.

URI

string

URI는 빌드될 소스를 가리킵니다. 소스 구조는 실행할 빌드 유형에 따라 달라집니다.

3.1.15. .spec.source.images

설명
이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.
유형
array

3.1.16. .spec.source.images[]

설명
ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).
유형
object
필수 항목
  • from
속성유형설명

as

배열(문자열)

다중 단계 컨테이너 이미지 빌드 중에 이 소스를 사용할 이미지 이름 목록입니다. 예를 들어 "COPY --from=nginx:latest"를 사용하는 Dockerfile은 먼저 이 필드에 "nginx:latest"가 있는 이미지 소스를 직접 가져오기 전에 확인합니다. Dockerfile에서 이미지 소스를 참조하지 않으면 무시됩니다. 이 필드와 경로는 모두 설정될 수 있으며, 이 경우 콘텐츠가 두 번 사용됩니다.

from

ObjectReference

에서 소스를 복사할 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 참조입니다.

경로

array

경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.

paths[]

object

ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.

pullSecret

LocalObjectReference

pullSecret은 레지스트리에서 이미지를 가져오는 데 사용할 보안에 대한 참조로, OpenShift 레지스트리에서 이미지를 가져오는 경우 이 필드를 설정할 필요가 없습니다.

3.1.17. .spec.source.images[].paths

설명
경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.
유형
array

3.1.18. .spec.source.images[].paths[]

설명
ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.
유형
object
필수 항목
  • sourcePath
  • destinationDir
속성유형설명

destinationDir

string

destinationDir은 이미지에서 복사한 파일이 배치되는 빌드 디렉터리 내의 상대 디렉터리입니다.

sourcePath

string

SourcePath는 빌드 디렉터리에 복사할 이미지 내부의 파일 또는 디렉터리의 절대 경로입니다. 소스 경로가 /.로 종료되면 디렉터리의 콘텐츠가 복사되지만 디렉터리 자체는 대상에 생성되지 않습니다.

3.1.19. .spec.source.secrets

설명
보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.
유형
array

3.1.20. .spec.source.secrets[]

설명
SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
유형
object
필수 항목
  • Secret
속성유형설명

destinationDir

string

destinationDir은 시크릿의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 나중에 스크립트가 완료되면 삽입된 모든 파일이 0 길이로 잘립니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다.

Secret

LocalObjectReference

Secret은 빌드에서 사용하려는 기존 보안에 대한 참조입니다.

3.1.21. .spec.strategy

설명
BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.
유형
object
속성유형설명

customStrategy

object

CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.

dockerStrategy

object

DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.

jenkinsPipelineStrategy

object

JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용

sourceStrategy

object

SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.

type

string

유형은 빌드 전략의 종류입니다.

3.1.22. .spec.strategy.customStrategy

설명
CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.
유형
object
필수 항목
  • from
속성유형설명

buildAPIVersion

string

buildAPIVersion은 Build 오브젝트 직렬화 및 사용자 정의 빌더에 대해 요청된 API 버전입니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

exposeDockerSocket

boolean

exposeDockerSocket을 사용하면 컨테이너 내부에서 Docker 명령(및 컨테이너 이미지 빌드)을 실행할 수 있습니다.

forcePull

boolean

forcePull은 컨트롤러가 항상 빌더의 이미지를 가져오도록 빌드 Pod를 구성해야 하는지 또는 로컬에 없는 경우에만 가져오기를 수행해야 하는지 설명합니다.

from

ObjectReference

에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

secrets

array

보안은 빌드 Pod에 포함될 추가 보안 목록입니다.

secrets[]

object

SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.

3.1.23. .spec.strategy.customStrategy.secrets

설명
보안은 빌드 Pod에 포함될 추가 보안 목록입니다.
유형
array

3.1.24. .spec.strategy.customStrategy.secrets[]

설명
SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.
유형
object
필수 항목
  • secretSource
  • mountPath
속성유형설명

mountPath

string

mountPath는 시크릿을 마운트할 경로입니다.

secretSource

LocalObjectReference

secretSource는 보안에 대한 참조입니다.

3.1.25. .spec.strategy.dockerStrategy

설명
DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.
유형
object
속성유형설명

buildArgs

array(EnvVar)

buildArgs에는 Dockerfile에서 해결할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 을 참조하십시오. 참고: 'name' 및 '값' 필드만 지원됩니다. 'valueFrom' 필드의 설정은 모두 무시됩니다.

dockerfilePath

string

dockerfilePath는 컨텍스트 루트(contextDir)를 기준으로 컨테이너 이미지를 빌드하는 데 사용할 Dockerfile의 경로입니다. 설정되지 않은 경우 기본값은 Dockerfile 입니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

forcePull

boolean

forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다.

from

ObjectReference

에서 빌드의 Dockerfile의 FROM 이미지를 재정의하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. Dockerfile에서 다중 단계 빌드를 사용하는 경우 파일의 마지막 FROM 지시문에 있는 이미지를 대체합니다.

imageOptimizationPolicy

string

imageOptimizationPolicy는 이미지 빌드에 소요되는 최종 크기 또는 시간을 줄이기 위해 이미지를 빌드할 때 사용할 수 있는 최적화를 설명합니다. 기본 정책은 '없음'으로, 최종 빌드 이미지가 컨테이너 이미지 빌드 API에서 생성한 이미지와 동일합니다. 실험적 정책 'SkipLayers'는 각 이미지 단계 사이에 새 계층을 커밋하지 않으며 Dockerfile에서 '없음' 정책과의 호환성을 제공할 수 없는 경우 실패합니다. 추가 실험 정책 'SkipLayersAndWarn'은 'SkipLayers'와 동일하지만 호환성을 유지할 수 없는 경우 경고합니다.

noCache

boolean

noCache true로 설정하면 --no-cache=true 플래그를 사용하여 컨테이너 이미지 빌드를 실행해야 함을 나타냅니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

volumes

array

volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.

3.1.26. .spec.strategy.dockerStrategy.volumes

설명
volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
유형
array

3.1.27. .spec.strategy.dockerStrategy.volumes[]

설명
BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.
유형
object
필수 항목
  • name
  • 소스
  • mounts
속성유형설명

mounts

array

mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.

mounts[]

object

BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.

name

string

name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

소스

object

BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.

3.1.28. .spec.strategy.dockerStrategy.volumes[].mounts

설명
mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
유형
array

3.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[]

설명
BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • destinationPath
속성유형설명

destinationPath

string

destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다.

3.1.30. .spec.strategy.dockerStrategy.volumes[].source

설명
BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
유형
object
필수 항목
  • type
속성유형설명

configMap

ConfigMapVolumeSource

ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다.

csi

CSIVolumeSource

CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다.

Secret

SecretVolumeSource

secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

type

string

type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap

3.1.31. .spec.strategy.jenkinsPipelineStrategy

설명
JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용
유형
object
속성유형설명

env

array(EnvVar)

env에는 빌드 파이프라인에 전달할 추가 환경 변수가 포함되어 있습니다.

Jenkinsfile

string

Jenkinsfile은 Jenkins 파이프라인 빌드를 정의하는 Jenkinsfile의 선택적 원시 콘텐츠를 정의합니다.

jenkinsfilePath

string

jenkinsfilePath는 컨텍스트 루트(contextDir)를 기준으로 파이프라인을 구성하는 데 사용할 Jenkinsfile의 선택적 경로입니다. JenkinsfilePath 및 Jenkinsfile 둘 다 지정되지 않은 경우 기본값은 지정된 contextDir의 루트에서 Jenkinsfile으로 설정됩니다.

3.1.32. .spec.strategy.sourceStrategy

설명
SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.
유형
object
필수 항목
  • from
속성유형설명

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

forcePull

boolean

forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다.

from

ObjectReference

에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다.

증분

boolean

증분 플래그는 true인 경우 소스 빌드가 증분 빌드를 수행하도록 강제 적용합니다.

pullSecret

LocalObjectReference

pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다.

스크립트

string

스크립트는 소스 스크립트의 위치입니다.

volumes

array

volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.

3.1.33. .spec.strategy.sourceStrategy.volumes

설명
volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
유형
array

3.1.34. .spec.strategy.sourceStrategy.volumes[]

설명
BuildVolume은 buildah의 런타임 환경에 마운트할 수 있도록 Pod 빌드에 사용할 수 있는 볼륨을 설명합니다. Kubernetes 볼륨 소스의 하위 집합만 지원됩니다.
유형
object
필수 항목
  • name
  • 소스
  • mounts
속성유형설명

mounts

array

mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.

mounts[]

object

BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.

name

string

name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

소스

object

BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.

3.1.35. .spec.strategy.sourceStrategy.volumes[].mounts

설명
mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
유형
array

3.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[]

설명
BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • destinationPath
속성유형설명

destinationPath

string

destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다.

3.1.37. .spec.strategy.sourceStrategy.volumes[].source

설명
BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
유형
object
필수 항목
  • type
속성유형설명

configMap

ConfigMapVolumeSource

ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다.

csi

CSIVolumeSource

CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다.

Secret

SecretVolumeSource

secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

type

string

type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap

3.1.38. .spec.triggeredBy

설명
TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.
유형
array

3.1.39. .spec.triggeredBy[]

설명
BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.
유형
object
속성유형설명

bitbucketWebHook

object

BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.

genericWebHook

object

GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.

githubWebHook

object

GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.

gitlabWebHook

object

GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.

imageChangeBuild

object

ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.

message

string

message는 빌드가 트리거된 이유에 대한 사람이 읽을 수 있는 메시지를 저장하는 데 사용됩니다. 예: "Manually triggered by user", "Configuration change",etc.

3.1.40. .spec.triggeredBy[].bitbucketWebHook

설명
BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

3.1.41. .spec.triggeredBy[].bitbucketWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

3.1.42. .spec.triggeredBy[].bitbucketWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

3.1.43. .spec.triggeredBy[].bitbucketWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.44. .spec.triggeredBy[].bitbucketWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.45. .spec.triggeredBy[].genericWebHook

설명
GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

3.1.46. .spec.triggeredBy[].genericWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

3.1.47. .spec.triggeredBy[].genericWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

3.1.48. .spec.triggeredBy[].genericWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.49. .spec.triggeredBy[].genericWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.50. .spec.triggeredBy[].githubWebHook

설명
GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

3.1.51. .spec.triggeredBy[].githubWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

3.1.52. .spec.triggeredBy[].githubWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

3.1.53. .spec.triggeredBy[].githubWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.54. .spec.triggeredBy[].githubWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.55. .spec.triggeredBy[].gitlabWebHook

설명
GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

3.1.56. .spec.triggeredBy[].gitlabWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

3.1.57. .spec.triggeredBy[].gitlabWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

3.1.58. .spec.triggeredBy[].gitlabWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.59. .spec.triggeredBy[].gitlabWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

3.1.60. .spec.triggeredBy[].imageChangeBuild

설명
ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.
유형
object
속성유형설명

fromRef

ObjectReference

fromRef에는 빌드를 트리거한 이미지에 대한 자세한 정보가 포함되어 있습니다.

imageID

string

ImageId는 새 빌드를 트리거한 이미지의 ID입니다.

3.1.61. .status

설명
BuildStatus에는 빌드 상태가 포함되어 있습니다.
유형
object
필수 항목
  • phase
속성유형설명

취소됨

boolean

취소된 이벤트는 빌드에 대해 취소 이벤트가 트리거되었는지 여부를 나타냅니다.

completionTimestamp

시간

completionTimestamp는 빌드 실패 또는 성공 여부에 관계없이 이 빌드가 완료된 서버 시간을 나타내는 타임스탬프입니다. 빌드를 실행하는 Pod가 종료된 시간을 반영합니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

conditions

array

조건은 빌드의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

BuildCondition은 특정 시점에서 빌드 상태를 설명합니다.

config

ObjectReference

config는 이 Build가 기반으로 하는 BuildConfig에 대한 ObjectReference입니다.

duration

integer

duration에는 빌드 시간을 설명하는 time.Duration 오브젝트가 포함됩니다.

logSnippet

string

logSnippet은 빌드 로그의 마지막 몇 줄입니다. 이 값은 실패한 빌드에만 설정됩니다.

message

string

message는 빌드의 상태가 이 상태에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

출력

object

BuildStatusOutput에는 빌드된 이미지의 상태가 포함됩니다.

outputDockerImageReference

string

outputDockerImageReference에는 이 빌드에서 빌드할 컨테이너 이미지에 대한 참조가 포함되어 있습니다. 해당 값은 Build.Spec.Output.To에서 계산되며 이미지를 푸시하고 가져오는 데 사용할 수 있도록 레지스트리 주소를 포함해야 합니다.

phase

string

단계는 빌드 라이프사이클의 지점입니다. 가능한 값은 "New", "Pending", "Running", "Complete", "Failed", "Error", "Cancelled"입니다.

reason

string

이유는 오류를 설명하는 짧은 CamelCase 문자열이며 CLI에서 머신 구문 분석 및 tidy 표시를 의미합니다.

단계

array

스테이지에는 시작 시간, 기간(밀리초) 및 각 단계 내에서 발생한 단계를 포함하여 빌드 중에 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.

stages[]

object

StageInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.

startTimestamp

시간

startTimestamp는 이 빌드가 Pod에서 실행되기 시작한 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

3.1.62. .status.conditions

설명
조건은 빌드의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

3.1.63. .status.conditions[]

설명
BuildCondition은 특정 시점에서 빌드 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다.

lastUpdateTime

시간

이 조건이 마지막으로 업데이트된 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

빌드 조건 유형입니다.

3.1.64. .status.output

설명
BuildStatusOutput에는 빌드된 이미지의 상태가 포함됩니다.
유형
object
속성유형설명

다음으로 변경

object

BuildStatusOutputTo는 푸시해야 하는 이미지 레지스트리와 관련하여 빌드된 이미지의 상태를 설명합니다.

3.1.65. .status.output.to

설명
BuildStatusOutputTo는 푸시해야 하는 이미지 레지스트리와 관련하여 빌드된 이미지의 상태를 설명합니다.
유형
object
속성유형설명

imageDigest

string

imageDigest는 빌드된 컨테이너 이미지의 다이제스트입니다. 다이제스트는 푸시된 레지스트리에서 이미지를 고유하게 식별합니다.

이 필드는 푸시가 성공적으로 완료된 경우에도 이 필드가 항상 설정되지 않을 수 있습니다. 예를 들어 레지스트리에서 다이제스트를 반환하지 않거나 빌더가 이해할 수 없는 형식으로 반환하는 경우입니다.

3.1.66. .status.stages

설명
스테이지에는 시작 시간, 기간(밀리초) 및 각 단계 내에서 발생한 단계를 포함하여 빌드 중에 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.
유형
array

3.1.67. .status.stages[]

설명
StageInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.
유형
object
속성유형설명

durationMilliseconds

integer

durationMilliseconds는 스테이지가 밀리초 단위로 완료하는 데 걸리는 시간을 식별합니다. 참고: 스테이지 기간은 명시적 빌드 단계에서 모든 작업이 고려되는 것은 아니므로 스테이지 내의 단계 기간의 합계를 초과할 수 있습니다.

name

string

name은 수행되는 각 빌드 단계의 고유 식별자입니다.

startTime

시간

StartTime은 이 단계가 시작될 때 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

단계

array

단계에는 시작 시간 및 지속 시간(밀리초)을 포함하여 빌드 단계에서 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.

steps[]

object

StepInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.

3.1.68. .status.stages[].steps

설명
단계에는 시작 시간 및 지속 시간(밀리초)을 포함하여 빌드 단계에서 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.
유형
array

3.1.69. .status.stages[].steps[]

설명
StepInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.
유형
object
속성유형설명

durationMilliseconds

integer

durationMilliseconds는 단계가 밀리초 단위로 완료하는 데 걸리는 시간을 식별합니다.

name

string

name은 각 빌드 단계의 고유 식별자입니다.

startTime

시간

StartTime은 이 단계가 시작될 때 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다.

3.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/build.openshift.io/v1/builds

    • GET: 빌드 유형의 오브젝트 목록 또는 감시
  • /apis/build.openshift.io/v1/watch/builds

    • GET: Build. deprecated 목록에 대한 개별 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하십시오.
  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds

    • DELETE: Build의 컬렉션 삭제
    • GET: 빌드 유형의 오브젝트 목록 또는 감시
    • POST: 빌드 생성
  • /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds

    • GET: Build. deprecated 목록에 대한 개별 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하십시오.
  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}

    • DELETE: 빌드를 삭제
    • GET: 지정된 빌드 읽기
    • PATCH: 지정된 빌드를 부분적으로 업데이트
    • PUT: 지정된 빌드로 교체
  • /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds/{name}

    • GET: Build. deprecated 오브젝트의 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개 변수를 사용하여 'fieldSelector' 매개 변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/details

    • PUT: 지정된 빌드의 세부 정보 교체
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks

    • POST: BuildConfig의 Webhook에 POST 요청을 연결
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks/{path}

    • POST: BuildConfig의 Webhook에 POST 요청을 연결

3.2.1. /apis/build.openshift.io/v1/builds

표 3.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Build 유형의 오브젝트 나열 또는 감시
표 3.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildList schema

401 - 무단

3.2.2. /apis/build.openshift.io/v1/watch/builds

표 3.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Build. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 3.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

3.2.3. /apis/build.openshift.io/v1/namespaces/{namespace}/builds

표 3.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
빌드 컬렉션 삭제
표 3.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 3.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 3.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
Build 유형의 오브젝트 나열 또는 감시
표 3.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 3.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildList schema

401 - 무단

HTTP 방법
POST
설명
빌드 생성
표 3.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 3.13. 본문 매개변수
매개변수유형설명

body

빌드 스키마

 
표 3.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

202 - 승인됨

빌드 스키마

401 - 무단

3.2.4. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds

표 3.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Build. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 3.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

3.2.5. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}

표 3.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

빌드의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
빌드 삭제
표 3.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 3.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 3.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 빌드 읽기
표 3.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Build를 부분적으로 업데이트
표 3.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 3.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 3.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 빌드로 교체
표 3.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 3.28. 본문 매개변수
매개변수유형설명

body

빌드 스키마

 
표 3.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

401 - 무단

3.2.6. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds/{name}

표 3.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

빌드의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Build. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 3.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

3.2.7. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/details

표 3.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

빌드의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.34. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
PUT
설명
지정된 빌드의 세부 정보 교체
표 3.35. 본문 매개변수
매개변수유형설명

body

빌드 스키마

 
표 3.36. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

401 - 무단

3.2.8. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks

표 3.37. 글로벌 경로 매개변수
매개변수유형설명

name

string

빌드의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 3.38. 글로벌 쿼리 매개변수
매개변수유형설명

path

string

path는 Pod에 대한 현재 프록시 요청에 사용할 URL 경로입니다.

HTTP 방법
POST
설명
BuildConfig의 Webhook에 POST 요청 연결
표 3.39. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

string

401 - 무단

3.2.9. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks/{path}

표 3.40. 글로벌 경로 매개변수
매개변수유형설명

name

string

빌드의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

path

string

리소스 경로

표 3.41. 글로벌 쿼리 매개변수
매개변수유형설명

path

string

path는 Pod에 대한 현재 프록시 요청에 사용할 URL 경로입니다.

HTTP 방법
POST
설명
BuildConfig의 Webhook에 POST 요청 연결
표 3.42. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

string

401 - 무단

4장. BuildLog [build.openshift.io/v1]

설명

BuildLog는 빌드 로그 리디렉션과 연결된 (사용되지 않음) 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

4.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

4.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log

    • GET: 지정된 빌드의 로그

4.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/log

표 4.1. 글로벌 경로 매개변수
매개변수유형설명

name

string

BuildLog의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 4.2. 글로벌 쿼리 매개변수
매개변수유형설명

container

string

로그를 스트리밍할 수 있는 cointainer입니다. Pod에 컨테이너가 한 개 있는 경우에만 기본값은 컨테이너입니다.

팔로우

boolean

true인 경우 빌드가 종료될 때까지 빌드 로그를 스트리밍해야 합니다.

insecureSkipTLSVerifyBackend

boolean

insecureSkipTLSVerifyBackend는 apiserver가 연결된 백엔드의 제공 인증서의 유효성을 확인하지 않아야 함을 나타냅니다. 이렇게 하면 apiserver와 백엔드 간에 HTTPS 연결이 안전하지 않습니다. 즉, apiserver에서 수신 중인 로그 데이터를 실제 kubelet에서 확인할 수 없습니다. kubelet이 apiserver의 TLS 인증 정보를 확인하도록 구성된 경우 실제 kubelet에 대한 연결이 중간 공격의 사람에 취약하지 않습니다(예: 공격자가 실제 kubelet에서 들어오는 실제 로그 데이터를 가로챌 수 없음).

limitBytes

integer

limitBytes, If set 은 로그 출력을 종료하기 전에 서버에서 읽을 바이트 수입니다. 이는 완전한 최종 로깅 행을 표시하지 않을 수 있으며 지정된 제한보다 약간 많거나 적을 수 있습니다.

nowait

boolean

nowait true인 경우 빌드를 아직 사용할 수 없는 경우에도 호출이 즉시 반환됩니다. 그렇지 않으면 서버는 빌드가 시작될 때까지 기다립니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

이전

boolean

이전 빌드 로그를 반환합니다. 기본값은 false입니다.

sinceSeconds

integer

sinceSeconds는 로그를 표시하는 현재 시간 이전의 상대 시간(초)입니다. 이 값이 Pod를 시작한 시간보다 앞면 Pod 시작 이후의 로그만 반환됩니다. 이 값이 향후이면 로그가 반환되지 않습니다. sinceSeconds 또는 sinceTime 중 하나만 지정할 수 있습니다.

tailLines

integer

taillines, If set, is the number of lines from the end of the logs to show. 지정하지 않으면 컨테이너 생성 또는 sinceSeconds 또는 sinceTime에서 로그가 표시됩니다.

타임 스탬프

boolean

타임스탬프(true인 경우)는 모든 로그 출력의 시작 부분에 RFC3339 또는 RFC3339Nano 타임스탬프를 추가합니다. 기본값은 false입니다.

version

integer

로그를 볼 빌드 버전입니다.

HTTP 방법
GET
설명
지정된 빌드의 로그 읽기
표 4.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildLog schema

401 - 무단

5장. BuildRequest [build.openshift.io/v1]

설명

BuildRequest는 빌드 생성기에 매개변수를 전달하는 데 사용되는 리소스입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

5.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

바이너리

object

BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.

dockerStrategyOptions

object

DockerStrategyOptions에는 컨테이너 이미지 빌드를 위한 추가 전략 옵션이 포함되어 있습니다.

env

array(EnvVar)

env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다.

from

ObjectReference

에서 빌드를 트리거한 ImageStreamTag에 대한 참조입니다.

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

lastVersion

integer

lastVersion(선택 사항)은 빌드를 생성하는 데 사용된 BuildConfig의 LastVersion입니다. 생성기의 BuildConfig가 일치하지 않으면 빌드가 생성되지 않습니다.

메타데이터

ObjectMeta

 

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

sourceStrategyOptions

object

SourceStrategyOptions에는 소스 빌드에 대한 추가 전략 옵션이 포함되어 있습니다.

triggeredBy

array

TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.

triggeredBy[]

object

BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.

triggeredByImage

ObjectReference

triggeredByImage는 이 빌드를 트리거한 이미지입니다.

5.1.1. .binary

설명
BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.
유형
object
속성유형설명

asFile

string

Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 /webapp.war 로 배치됩니다. 비어 있는 경우 Docker 및 Source 빌드 전략에서는 이 파일이 zip, tar 또는 tar.gz 파일이라고 가정하고 소스로 추출합니다. 사용자 지정 전략은 이 바이너리를 표준 입력으로 수신합니다. 이 파일 이름은 슬래시를 포함하거나 '..' 또는 '.'일 수 없습니다.

5.1.2. .dockerStrategyOptions

설명
DockerStrategyOptions에는 컨테이너 이미지 빌드를 위한 추가 전략 옵션이 포함되어 있습니다.
유형
object
속성유형설명

buildArgs

array(EnvVar)

args에는 Docker로 전달할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 에서 참조하십시오.

noCache

boolean

noCache는 빌드 구성의 docker-strategy noCache 옵션을 덮어씁니다.

5.1.3. .revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

5.1.4. .revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

5.1.5. .revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.6. .revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.7. .sourceStrategyOptions

설명
SourceStrategyOptions에는 소스 빌드에 대한 추가 전략 옵션이 포함되어 있습니다.
유형
object
속성유형설명

증분

boolean

빌드 구성의 source-strategy 증분 옵션을 점진적으로 덮어씁니다.

5.1.8. .triggeredBy

설명
TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.
유형
array

5.1.9. .triggeredBy[]

설명
BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.
유형
object
속성유형설명

bitbucketWebHook

object

BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.

genericWebHook

object

GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.

githubWebHook

object

GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.

gitlabWebHook

object

GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.

imageChangeBuild

object

ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.

message

string

message는 빌드가 트리거된 이유에 대한 사람이 읽을 수 있는 메시지를 저장하는 데 사용됩니다. 예: "Manually triggered by user", "Configuration change",etc.

5.1.10. .triggeredBy[].bitbucketWebHook

설명
BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

5.1.11. .triggeredBy[].bitbucketWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

5.1.12. .triggeredBy[].bitbucketWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

5.1.13. .triggeredBy[].bitbucketWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.14. .triggeredBy[].bitbucketWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.15. .triggeredBy[].genericWebHook

설명
GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

5.1.16. .triggeredBy[].genericWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

5.1.17. .triggeredBy[].genericWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

5.1.18. .triggeredBy[].genericWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.19. .triggeredBy[].genericWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.20. .triggeredBy[].githubWebHook

설명
GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

5.1.21. .triggeredBy[].githubWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

5.1.22. .triggeredBy[].githubWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

5.1.23. .triggeredBy[].githubWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.24. .triggeredBy[].githubWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.25. .triggeredBy[].gitlabWebHook

설명
GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.
유형
object
속성유형설명

버전

object

SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.

Secret

string

secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다.

5.1.26. .triggeredBy[].gitlabWebHook.revision

설명
SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
유형
object
필수 항목
  • type
속성유형설명

git

object

GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.

type

string

빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다.

5.1.27. .triggeredBy[].gitlabWebHook.revision.git

설명
GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
유형
object
속성유형설명

작성자

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

커밋

string

커밋은 특정 커밋을 식별하는 커밋 해시입니다.

커밋

object

SourceControlUser는 소스 제어 사용자 ID를 정의합니다.

message

string

message는 특정 커밋에 대한 설명입니다.

5.1.28. .triggeredBy[].gitlabWebHook.revision.git.author

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.29. .triggeredBy[].gitlabWebHook.revision.git.committer

설명
SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
유형
object
속성유형설명

email

string

소스 제어 사용자의 이메일

name

string

소스 제어 사용자의 이름

5.1.30. .triggeredBy[].imageChangeBuild

설명
ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.
유형
object
속성유형설명

fromRef

ObjectReference

fromRef에는 빌드를 트리거한 이미지에 대한 자세한 정보가 포함되어 있습니다.

imageID

string

ImageId는 새 빌드를 트리거한 이미지의 ID입니다.

5.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/clone

    • POST: 빌드의 복제본 생성
  • /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate

    • POST: BuildConfig의 인스턴스화 생성

5.2.1. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/clone

표 5.1. 글로벌 경로 매개변수
매개변수유형설명

name

string

BuildRequest의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 5.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
빌드 복제본 생성
표 5.3. 본문 매개변수
매개변수유형설명

body

BuildRequest 스키마

 
표 5.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildRequest 스키마

201 - 생성됨

BuildRequest 스키마

202 - 승인됨

BuildRequest 스키마

401 - 무단

5.2.2. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate

표 5.5. 글로벌 경로 매개변수
매개변수유형설명

name

string

BuildRequest의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 5.6. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
BuildConfig의 인스턴스화 생성
표 5.7. 본문 매개변수
매개변수유형설명

body

BuildRequest 스키마

 
표 5.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

202 - 승인됨

빌드 스키마

401 - 무단

6장. CronJob [batch/v1]

설명
CronJob은 단일 cron 작업의 구성을 나타냅니다.
유형
object

6.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

CronJobSpec은 작업 실행이 어떻게 보이고 실제로 실행될 시기를 설명합니다.

status

object

CronJobStatus는 cron 작업의 현재 상태를 나타냅니다.

6.1.1. .spec

설명
CronJobSpec은 작업 실행이 어떻게 보이고 실제로 실행될 시기를 설명합니다.
유형
object
필수 항목
  • 스케줄
  • jobTemplate
속성유형설명

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 베타 필드이며 CronJobTimeZone 기능 게이트를 통해 활성화해야 합니다.

6.1.2. .spec.jobTemplate

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

메타데이터

ObjectMeta

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

spec

object

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

6.1.3. .spec.jobTemplate.spec

설명
JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다.
유형
object
필수 항목
  • 템플릿
속성유형설명

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

병렬 처리

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으로 설정하면 작업이 완료된 직후에 삭제할 수 있습니다.

6.1.4. .spec.jobTemplate.spec.podFailurePolicy

설명
PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다.
유형
object
필수 항목
  • 규칙
속성유형설명

규칙

array

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

rules[]

object

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

6.1.5. .spec.jobTemplate.spec.podFailurePolicy.rules

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

6.1.6. .spec.jobTemplate.spec.podFailurePolicy.rules[]

설명
PodFailurePolicyRule는 요구사항이 충족될 때 Pod 실패를 처리하는 방법을 설명합니다. OnExitCodes 및 onPodConditions 중 하나이지만 둘 다 사용할 수 없습니다.
유형
object
필수 항목
  • 작업
속성유형설명

작업

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 상태 유형과 일치하는 패턴을 설명합니다.

6.1.7. .spec.jobTemplate.spec.podFailurePolicy.rules[].onExitCodes

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

containerName

string

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

operator

string

컨테이너 종료 코드와 지정된 값 간의 관계를 나타냅니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. 가능한 값은 다음과 같습니다. - In: 하나 이상의 컨테이너 종료 코드( 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개인 경우 여러 개)가 지정된 값 세트에 있는 경우 여러 컨테이너가 충족됩니다. - NotIn: NotIn: 컨테이너 종료 코드 중 하나 이상이 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개 있는 경우 요구 사항이 충족됩니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 요구 사항이 충족되지 않았음을 가정하여 알 수 없는 Operator에 반응해야 합니다.

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

배열(정수)

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

6.1.8. .spec.jobTemplate.spec.podFailurePolicy.rules[].onPodConditions

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

6.1.9. .spec.jobTemplate.spec.podFailurePolicy.rules[].onPodConditions[]

설명
PodFailurePolicyOnPodConditionsPattern은 실제 Pod 상태 유형과 일치하는 패턴을 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

status

string

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

type

string

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

6.1.10. .status

설명
CronJobStatus는 cron 작업의 현재 상태를 나타냅니다.
유형
object
속성유형설명

활성 상태

배열(ObjectReference)

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

lastScheduleTime

시간

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

lastSuccessfulTime

시간

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

6.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/batch/v1/cronjobs

    • GET: CronJob 유형의 오브젝트 나열 또는 감시
  • /apis/batch/v1/watch/cronjobs

    • GET: CronJob. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/batch/v1/namespaces/{namespace}/cronjobs

    • DELETE: CronJob의 컬렉션 삭제
    • GET: CronJob 유형의 오브젝트 나열 또는 감시
    • POST: CronJob 생성
  • /apis/batch/v1/watch/namespaces/{namespace}/cronjobs

    • GET: CronJob. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}

    • DELETE: CronJob 삭제
    • GET: 지정된 CronJob 읽기
    • PATCH: 지정된 CronJob을 부분적으로 업데이트
    • PUT: 지정된 CronJob을 교체
  • /apis/batch/v1/watch/namespaces/{namespace}/cronjobs/{name}

    • GET: CronJob. deprecated 오브젝트의 변경 사항을 감시합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status

    • GET: 지정된 CronJob의 읽기 상태
    • PATCH: 지정된 CronJob의 부분적으로 업데이트 상태
    • PUT: 지정된 CronJob의 상태

6.2.1. /apis/batch/v1/cronjobs

표 6.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
CronJob 유형의 오브젝트 나열 또는 감시
표 6.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJobList schema

401 - 무단

6.2.2. /apis/batch/v1/watch/cronjobs

표 6.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
CronJob. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 6.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

6.2.3. /apis/batch/v1/namespaces/{namespace}/cronjobs

표 6.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 6.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
CronJob 컬렉션 삭제
표 6.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 6.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 6.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
CronJob 유형의 오브젝트 나열 또는 감시
표 6.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 6.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJobList schema

401 - 무단

HTTP 방법
POST
설명
CronJob 생성
표 6.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 6.13. 본문 매개변수
매개변수유형설명

body

CronJob schema

 
표 6.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

201 - 생성됨

CronJob schema

202 - 승인됨

CronJob schema

401 - 무단

6.2.4. /apis/batch/v1/watch/namespaces/{namespace}/cronjobs

표 6.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 6.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
CronJob. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 6.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

6.2.5. /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}

표 6.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

CronJob의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 6.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
delete a CronJob
표 6.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 6.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 6.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 CronJob 읽기
표 6.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 CronJob을 부분적으로 업데이트
표 6.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 6.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 6.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

201 - 생성됨

CronJob schema

401 - 무단

HTTP 방법
PUT
설명
지정된 CronJob을 교체
표 6.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 6.28. 본문 매개변수
매개변수유형설명

body

CronJob schema

 
표 6.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

201 - 생성됨

CronJob schema

401 - 무단

6.2.6. /apis/batch/v1/watch/namespaces/{namespace}/cronjobs/{name}

표 6.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

CronJob의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 6.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
CronJob. deprecated 유형의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 6.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

6.2.7. /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status

표 6.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

CronJob의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 6.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 CronJob의 읽기 상태
표 6.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 CronJob의 부분적으로 업데이트 상태
표 6.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 6.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 6.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

201 - 생성됨

CronJob schema

401 - 무단

HTTP 방법
PUT
설명
지정된 CronJob의 상태 교체
표 6.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 6.40. 본문 매개변수
매개변수유형설명

body

CronJob schema

 
표 6.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

CronJob schema

201 - 생성됨

CronJob schema

401 - 무단

7장. DaemonSet [apps/v1]

설명
DaemonSet은 데몬 세트의 구성을 나타냅니다.
유형
object

7.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

DaemonSetSpec은 데몬 세트의 사양입니다.

status

object

DaemonSetStatus는 데몬 세트의 현재 상태를 나타냅니다.

7.1.1. .spec

설명
DaemonSetSpec은 데몬 세트의 사양입니다.
유형
object
필수 항목
  • 선택기
  • 템플릿
속성유형설명

minReadySeconds

integer

새로 생성된 DaemonSet Pod가 컨테이너 충돌 없이 준비해야 하는 최소 시간(초)을 사용할 수 있는 것으로 간주해야 합니다. 기본값은 0입니다(포드가 준비되는 즉시 사용 가능한 것으로 간주됨).

revisionHistoryLimit

integer

롤백을 허용하기 위해 보유할 이전 기록 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 10입니다.

선택기

LabelSelector

데몬 세트에서 관리하는 Pod에 대한 라벨 쿼리입니다. 제어하려면 일치해야합니다. Pod 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

템플릿

PodTemplateSpec

생성할 Pod를 설명하는 오브젝트입니다. DaemonSet은 템플릿의 노드 선택기와 일치하는 모든 노드에서 (또는 노드 선택기를 지정하지 않은 경우 모든 노드에서) 정확히 하나의 복사본을 생성합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template

updateStrategy

object

DaemonSetUpdateStrategy는 DaemonSet의 업데이트 전략을 제어하는 데 사용되는 구조입니다.

7.1.2. .spec.updateStrategy

설명
DaemonSetUpdateStrategy는 DaemonSet의 업데이트 전략을 제어하는 데 사용되는 구조입니다.
유형
object
속성유형설명

rollingUpdate

object

데몬 세트 롤링 업데이트의 원하는 동작을 제어하는 사양입니다.

type

string

데몬 세트 업데이트 유형입니다. "RollingUpdate" 또는 "OnDelete"일 수 있습니다. 기본값은 RollingUpdate입니다.

가능한 enum 값: - "OnDelete" 는 종료된 경우에만 이전 데몬을 교체합니다. "RollingUpdate" 는 롤링 업데이트를 사용하여 이전 데몬을 새 데몬으로 교체합니다. 즉, 각 노드에서 하나씩 교체합니다.

7.1.3. .spec.updateStrategy.rollingUpdate

설명
데몬 세트 롤링 업데이트의 원하는 동작을 제어하는 사양입니다.
유형
object
속성유형설명

maxSurge

IntOrString

업데이트 중 업데이트된 DaemonSet Pod를 보유할 수 있는 기존 사용 가능한 DaemonSet Pod가 있는 최대 노드 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. MaxUnavailable이 0인 경우 이 값은 0이 될 수 없습니다. 절대 숫자는 백분율에서 최소 1까지 반올림하여 계산됩니다. 기본값은 0입니다. 예: 이 값을 30%로 설정하면 데몬 Pod를 실행해야 하는 총 노드 수의 최대 30%(즉, status.desiredNumberScheduled)에서 이전 Pod가 삭제된 것으로 표시되기 전에 생성된 새 Pod를 보유할 수 있습니다. 업데이트는 노드의 30%에서 새 Pod를 시작하여 시작됩니다. 업데이트된 Pod를 사용할 수 있게 되면(최소 minReadySeconds 이상) 해당 노드의 이전 DaemonSet Pod가 삭제됩니다. 어떤 이유로든 기존 Pod를 사용할 수 없게 되면(Ready가 false로 전환되거나 제거됨) 업데이트된 Pod가 급증 제한을 고려하지 않고 해당 노드에 즉시 생성됩니다. 서지 허용은 지정된 노드에서 데몬 세트에서 사용하는 리소스가 두 배가 될 수 있음을 의미합니다. 따라서 준비 상태 점검이 실패하면 리소스 집약적 데몬 세트에서 두 배로 증가할 수 있으므로 중단 중에 제거가 발생할 수 있습니다.

maxUnavailable

IntOrString

업데이트 중에 사용할 수 없는 최대 DaemonSet Pod 수입니다. 값은 절대 숫자(예: 5) 또는 업데이트 시작 시 총 DaemonSet Pod 수(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. MaxSurge가 0인 경우 0이 될 수 없습니다. 예: 이 값을 30%로 설정하면 데몬 Pod를 실행해야 하는 총 노드 수의 최대 30%(즉, status.desiredNumberScheduled)에서 특정 시간에 업데이트 시 Pod가 중지될 수 있습니다. 업데이트는 해당 DaemonSet Pod의 30 % 이상을 중지한 다음 새 DaemonSet Pod를 순서대로 시작합니다. 새 Pod를 사용할 수 있게 되면 다른 DaemonSet Pod로 진행되므로 업데이트 중에 항상 원래 DaemonSet Pod 수의 70% 이상을 사용할 수 있습니다.

7.1.4. .status

설명
DaemonSetStatus는 데몬 세트의 현재 상태를 나타냅니다.
유형
object
필수 항목
  • currentNumberScheduled
  • numberMisscheduled
  • desiredNumberScheduled
  • numberReady
속성유형설명

collisionCount

integer

DaemonSet의 해시 충돌 수입니다. DaemonSet 컨트롤러는 최신 ControllerRevision의 이름을 생성해야 하는 경우 이 필드를 충돌 방지 메커니즘으로 사용합니다.

conditions

array

DaemonSet의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

DaemonSetCondition은 특정 시점에서 DaemonSet의 상태를 설명합니다.

currentNumberScheduled

integer

데몬 Pod가 1개 이상 실행되고 데몬 Pod를 실행해야 하는 노드 수입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/

desiredNumberScheduled

integer

데몬 Pod를 실행해야 하는 총 노드 수입니다(임시 Pod를 올바르게 실행하는 노드 포함). 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/

numberAvailable

integer

데몬 Pod를 실행하고 하나 이상의 데몬 Pod를 실행하고 사용할 수 있는 노드 수(최소 spec.minReadySeconds 이상)

numberMisscheduled

integer

데몬 Pod를 실행 중이지만 데몬 Pod를 실행하지 않는 노드 수입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/

numberReady

integer

numberReady는 데몬 Pod를 실행해야 하며 Ready 상태에서 하나 이상의 데몬 Pod를 실행해야 하는 노드 수입니다.

numberUnavailable

integer

데몬 Pod를 실행해야 하며 데몬 Pod가 실행되지 않고 사용 가능한 데몬 Pod가 없는 노드 수입니다(최소 spec.minReadySeconds 이상)

observedGeneration

integer

데몬 세트 컨트롤러에서 관찰하는 최신 생성입니다.

updatedNumberScheduled

integer

업데이트된 데몬 Pod를 실행 중인 총 노드 수

7.1.5. .status.conditions

설명
DaemonSet의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

7.1.6. .status.conditions[]

설명
DaemonSetCondition은 특정 시점에서 DaemonSet의 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

DaemonSet 조건 유형입니다.

7.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps/v1/daemonsets

    • GET: 종류 DaemonSet의 오브젝트 목록 또는 감시
  • /apis/apps/v1/watch/daemonsets

    • GET: individual changes to a list of DaemonSet. deprecated: 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/daemonsets

    • DELETE: DaemonSet의 컬렉션 삭제
    • GET: 종류 DaemonSet의 오브젝트 목록 또는 감시
    • POST: DaemonSet 생성
  • /apis/apps/v1/watch/namespaces/{namespace}/daemonsets

    • GET: individual changes to a list of DaemonSet. deprecated: 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}

    • DELETE: DaemonSet 삭제
    • GET: 지정된 DaemonSet 읽기
    • PATCH: 지정된 DaemonSet을 부분적으로 업데이트
    • PUT: 지정된 DaemonSet을 교체
  • /apis/apps/v1/watch/namespaces/{namespace}/daemonsets/{name}

    • GET: kind DaemonSet. deprecated 개체의 변경 사항을 조사합니다. 더 이상 사용되지 않는 'watch' 매개 변수를 목록 작업과 함께 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status

    • GET: 지정된 DaemonSet의 읽기 상태
    • PATCH: 지정된 DaemonSet의 부분 업데이트 상태
    • PUT: 지정된 DaemonSet의 상태

7.2.1. /apis/apps/v1/daemonsets

표 7.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
일련의 DaemonSet 오브젝트 나열 또는 감시
표 7.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSetList schema

401 - 무단

7.2.2. /apis/apps/v1/watch/daemonsets

표 7.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
DaemonSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 7.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

7.2.3. /apis/apps/v1/namespaces/{namespace}/daemonsets

표 7.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 7.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
DaemonSet 컬렉션 삭제
표 7.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 7.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 7.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
일련의 DaemonSet 오브젝트 나열 또는 감시
표 7.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 7.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSetList schema

401 - 무단

HTTP 방법
POST
설명
DaemonSet 생성
표 7.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 7.13. 본문 매개변수
매개변수유형설명

body

DaemonSet 스키마

 
표 7.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

201 - 생성됨

DaemonSet 스키마

202 - 승인됨

DaemonSet 스키마

401 - 무단

7.2.4. /apis/apps/v1/watch/namespaces/{namespace}/daemonsets

표 7.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 7.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
DaemonSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 7.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

7.2.5. /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}

표 7.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

DaemonSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 7.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
DaemonSet 삭제
표 7.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 7.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 7.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 DaemonSet 읽기
표 7.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DaemonSet을 부분적으로 업데이트
표 7.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 7.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 7.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

201 - 생성됨

DaemonSet 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DaemonSet을 교체합니다.
표 7.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 7.28. 본문 매개변수
매개변수유형설명

body

DaemonSet 스키마

 
표 7.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

201 - 생성됨

DaemonSet 스키마

401 - 무단

7.2.6. /apis/apps/v1/watch/namespaces/{namespace}/daemonsets/{name}

표 7.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

DaemonSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 7.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
더 이상 사용되지 않는 유형의 DaemonSet 개체를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 7.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

7.2.7. /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status

표 7.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

DaemonSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 7.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 DaemonSet의 읽기 상태
표 7.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DaemonSet의 부분적으로 업데이트 상태
표 7.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 7.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 7.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

201 - 생성됨

DaemonSet 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DaemonSet의 상태 교체
표 7.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 7.40. 본문 매개변수
매개변수유형설명

body

DaemonSet 스키마

 
표 7.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DaemonSet 스키마

201 - 생성됨

DaemonSet 스키마

401 - 무단

8장. 배포 [apps/v1]

설명
배포를 사용하면 Pod 및 ReplicaSet에 대한 선언적 업데이트가 활성화됩니다.
유형
object

8.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

DeploymentSpec은 원하는 배포 동작의 사양입니다.

status

object

DeploymentStatus는 가장 최근에 관찰된 배포 상태입니다.

8.1.1. .spec

설명
DeploymentSpec은 원하는 배포 동작의 사양입니다.
유형
object
필수 항목
  • 선택기
  • 템플릿
속성유형설명

minReadySeconds

integer

컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)을 사용할 수 있습니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨)

일시 중지됨

boolean

배포가 일시 중지되었음을 나타냅니다.

progressDeadlineSeconds

integer

배포가 실패로 간주되기 전에 진행할 수 있는 최대 시간(초)입니다. 배포 컨트롤러는 실패한 배포를 계속 처리하고 ProgressDeadlineExceeded 이유가 있는 조건이 배포 상태에 표시됩니다. 배포가 일시 중지되는 동안 진행 상황을 추정하지 않습니다. 기본값은 600입니다.

replicas

integer

원하는 Pod 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다.

revisionHistoryLimit

integer

롤백을 허용하기 위해 보유할 이전 ReplicaSet 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 10입니다.

선택기

LabelSelector

Pod의 라벨 선택기입니다. 이 과정에서 선택한 Pod가 있는 기존 ReplicaSet은 이 배포의 영향을 받는 것입니다. Pod 템플릿의 레이블과 일치해야 합니다.

전략

object

DeploymentStrategy는 기존 Pod를 새 Pod로 교체하는 방법을 설명합니다.

템플릿

PodTemplateSpec

템플릿은 생성할 Pod를 설명합니다.

8.1.2. .spec.strategy

설명
DeploymentStrategy는 기존 Pod를 새 Pod로 교체하는 방법을 설명합니다.
유형
object
속성유형설명

rollingUpdate

object

롤링 업데이트의 원하는 동작을 제어하는 사양입니다.

type

string

배포 유형입니다. "Recreate" 또는 "RollingUpdate"일 수 있습니다. 기본값은 RollingUpdate입니다.

가능한 enum 값: - "Recreate" 새 포드를 만들기 전에 기존 Pod를 모두 종료합니다. - "RollingUpdate" 는 롤링 업데이트를 사용하여 이전 ReplicaSet을 새 Pod로 교체합니다. 즉, 이전 ReplicaSet을 점진적으로 축소하고 새 Pod를 확장합니다.

8.1.3. .spec.strategy.rollingUpdate

설명
롤링 업데이트의 원하는 동작을 제어하는 사양입니다.
유형
object
속성유형설명

maxSurge

IntOrString

원하는 Pod 수 이상으로 예약할 수 있는 최대 Pod 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. MaxUnavailable이 0인 경우 이 값은 0이 될 수 없습니다. 절대 수는 백분율로 반올림하여 계산됩니다. 기본값은 25%입니다. 예: 이 값을 30 %로 설정하면 롤링 업데이트가 시작될 때 새 ReplicaSet을 즉시 확장할 수 있으므로 이전 Pod와 새 Pod의 총 수가 원하는 Pod의30%를 초과하지 않습니다. 이전 Pod가 종료되면 새 ReplicaSet을 추가로 확장할 수 있으므로 업데이트 중에 언제든지 실행 중인 총 Pod 수가 원하는 Pod의 최대 192.0.2.%가 되도록 할 수 있습니다.

maxUnavailable

IntOrString

업데이트 중에 사용할 수 없는 최대 Pod 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. MaxSurge가 0인 경우 이 값은 0이 될 수 없습니다. 기본값은 25%입니다. 예: 이 값을 30%로 설정하면 롤링 업데이트가 시작될 때 이전 ReplicaSet을 원하는 Pod의 70%로 즉시 축소할 수 있습니다. 새 Pod가 준비되면 이전 ReplicaSet을 추가로 축소한 후 새 ReplicaSet을 확장하여 업데이트 중에 항상 사용 가능한 총 Pod 수가 필요한 Pod의 70% 이상인지 확인할 수 있습니다.

8.1.4. .status

설명
DeploymentStatus는 가장 최근에 관찰된 배포 상태입니다.
유형
object
속성유형설명

availableReplicas

integer

이 배포를 대상으로 하는 사용 가능한 총 Pod 수(최소 minReadySeconds) 수입니다.

collisionCount

integer

배포에 대한 해시 충돌 수입니다. 배포 컨트롤러는 최신 ReplicaSet의 이름을 생성해야 하는 경우 이 필드를 충돌 방지 메커니즘으로 사용합니다.

conditions

array

배포의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

DeploymentCondition은 특정 시점에서 배포 상태를 설명합니다.

observedGeneration

integer

배포 컨트롤러에서 관찰하는 생성입니다.

readyReplicas

integer

ReadyReplicas는 이 배포에서 Ready 상태가 되는 Pod 수입니다.

replicas

integer

이 배포를 대상으로 하는 총 종료되지 않은 Pod 수입니다(해당 레이블은 선택기와 일치).

unavailableReplicas

integer

이 배포에서 대상으로 하는 총 사용 불가능한 Pod 수입니다. 이는 배포에 필요한 총 Pod 수에 100% 사용 가능한 용량이 있습니다. 실행 중이지만 아직 사용할 수 없는 Pod 또는 아직 생성되지 않은 Pod일 수 있습니다.

updatedReplicas

integer

원하는 템플릿 사양이 있는 이 배포를 대상으로 하는 총 종료되지 않은 Pod 수입니다.

8.1.5. .status.conditions

설명
배포의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

8.1.6. .status.conditions[]

설명
DeploymentCondition은 특정 시점에서 배포 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.

lastUpdateTime

시간

이 조건이 마지막으로 업데이트된 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

배포 조건 유형입니다.

8.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps/v1/deployments

    • GET: 배포 유형의 오브젝트 목록 또는 감시
  • /apis/apps/v1/watch/deployments

    • GET: Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/deployments

    • DELETE: Deployment 컬렉션 삭제
    • GET: 배포 유형의 오브젝트 목록 또는 감시
    • POST: Deployment 생성
  • /apis/apps/v1/watch/namespaces/{namespace}/deployments

    • GET: Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/deployments/{name}

    • DELETE: Deployment 삭제
    • GET: 지정된 배포 읽기
    • PATCH: 지정된 배포를 부분적으로 업데이트
    • PUT: 지정된 배포를 교체
  • /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}

    • GET: 유형의 Deployment. deprecated 개체 변경 사항을 조사합니다. 대신 목록 작업과 함께 'watch' 매개 변수를 사용하고 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

    • GET: 지정된 배포의 읽기 상태
    • PATCH: 지정된 배포의 부분 업데이트 상태
    • PUT: 지정된 배포의 상태

8.2.1. /apis/apps/v1/deployments

표 8.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
배포 유형의 오브젝트 나열 또는 감시
표 8.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentList 스키마

401 - 무단

8.2.2. /apis/apps/v1/watch/deployments

표 8.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 8.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

8.2.3. /apis/apps/v1/namespaces/{namespace}/deployments

표 8.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 8.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
배포 컬렉션 삭제
표 8.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 8.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 8.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
배포 유형의 오브젝트 나열 또는 감시
표 8.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 8.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentList 스키마

401 - 무단

HTTP 방법
POST
설명
배포 생성
표 8.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 8.13. 본문 매개변수
매개변수유형설명

body

배포 스키마

 
표 8.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

201 - 생성됨

배포 스키마

202 - 승인됨

배포 스키마

401 - 무단

8.2.4. /apis/apps/v1/watch/namespaces/{namespace}/deployments

표 8.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 8.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 8.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

8.2.5. /apis/apps/v1/namespaces/{namespace}/deployments/{name}

표 8.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

배포 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 8.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
배포 삭제
표 8.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 8.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 8.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 배포 읽기
표 8.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 배포를 부분적으로 업데이트
표 8.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 8.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 8.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

201 - 생성됨

배포 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 배포 교체
표 8.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 8.28. 본문 매개변수
매개변수유형설명

body

배포 스키마

 
표 8.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

201 - 생성됨

배포 스키마

401 - 무단

8.2.6. /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}

표 8.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

배포 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 8.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
더 이상 사용되지 않는 유형의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 8.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

8.2.7. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

표 8.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

배포 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 8.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 배포의 상태 확인
표 8.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 배포의 부분적으로 업데이트 상태
표 8.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 8.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 8.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

201 - 생성됨

배포 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 배포의 상태 교체
표 8.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 8.40. 본문 매개변수
매개변수유형설명

body

배포 스키마

 
표 8.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

배포 스키마

201 - 생성됨

배포 스키마

401 - 무단

9장. DeploymentConfig [apps.openshift.io/v1]

설명

배포 구성은 Pod에 대한 템플릿을 정의하고 새 이미지 또는 구성 변경 배포를 관리합니다. 단일 배포 구성은 일반적으로 단일 마이크로 서비스와 유사합니다. 전체 재시작, 사용자 정의 롤링 업데이트, 완전히 사용자 지정 동작, 사전 및 배포 후 후크를 비롯한 다양한 배포 패턴을 지원할 수 있습니다. 각 개별 배포는 복제 컨트롤러로 표시됩니다.

구성이 변경되거나 이미지 스트림의 태그가 변경되면 배포가 "triggered"됩니다. 배포를 수동으로 제어할 수 있도록 트리거를 비활성화할 수 있습니다. "전략"은 배포 수행 방법을 결정하고 언제든지 변경될 수 있습니다. latestVersion 필드는 새로운 배포가 어떤 수단에 의해 트리거될 때 업데이트됩니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • spec

9.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

 

spec

object

DeploymentConfigSpec은 원하는 배포 상태를 나타냅니다.

status

object

DeploymentConfigStatus는 현재 배포 상태를 나타냅니다.

9.1.1. .spec

설명
DeploymentConfigSpec은 원하는 배포 상태를 나타냅니다.
유형
object
속성유형설명

minReadySeconds

integer

minReadySeconds는 컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)입니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨)

일시 중지됨

boolean

paused는 배포 구성이 일시 중지되어 다른 트리거로 인한 템플릿 변경이나 템플릿 변경에 대한 새 배포가 발생하지 않음을 나타냅니다.

replicas

integer

replicas는 원하는 복제본 수입니다.

revisionHistoryLimit

integer

RevisionHistoryLimit은 롤백을 허용하도록 유지할 이전 ReplicationController 수입니다. 이 필드는 명시적 0과 지정되지 않은 경우를 구분할 수 있는 포인터입니다. 기본값은 10입니다. (기존 리소스가 아닌 새 그룹 API 리소스를 통해 생성된 DeploymentConfig에만 적용됩니다.)

선택기

오브젝트(문자열)

selector는 Replicas 수와 일치해야 하는 Pod의 레이블 쿼리입니다.

전략

object

DeploymentStrategy는 배포를 수행하는 방법을 설명합니다.

템플릿

PodTemplateSpec

템플릿은 충분하지 않은 복제본이 감지되면 생성되는 Pod를 설명하는 오브젝트입니다.

test

boolean

test는 배포가 실행되는 경우를 제외하고 이 배포 구성에 복제본이 0인지 확인합니다. 이를 통해 배포 구성을 연속 배포 테스트로 사용할 수 있습니다. 이미지 트리거, 배포를 실행한 다음 성공 또는 실패합니다. 전략 후 후크 및 작업 후 작업을 사용하여 성공적인 배포를 작업과 통합할 수 있습니다.

Trigger

array

Trigger가 DeploymentConfig에 대한 업데이트로 인해 새 배포가 생성되는 방식을 결정합니다. 트리거가 정의되지 않은 경우 새 LatestVersion을 사용하여 DeploymentConfig에 대한 명시적 클라이언트 업데이트로 인해 새 배포가 발생할 수 있습니다. null인 경우 기본적으로 구성 변경 트리거가 있습니다.

triggers[]

object

DeploymentTriggerPolicy는 새 배포를 생성하는 단일 트리거에 대한 정책을 설명합니다.

9.1.2. .spec.strategy

설명
DeploymentStrategy는 배포를 수행하는 방법을 설명합니다.
유형
object
속성유형설명

activeDeadlineSeconds

integer

activeDeadlineSeconds는 시스템이 적극적으로 종료하려고 시도하기 전에 이 배포 구성의 배포자 Pod가 노드에서 활성화될 수 있는 시간(초)입니다.

annotations

오브젝트(문자열)

주석은 사용자 정의 배포자 및 후크 Pod 사전/게스트 포드의 라이프사이클에 추가된 키, 값 쌍 세트입니다.

customParams

object

CustomDeploymentStrategyParams는 사용자 정의 배포 전략에 대한 입력입니다.

labels

오브젝트(문자열)

레이블은 사용자 정의 배포자 및 후크 사전/게스트 포드의 라이프사이클에 추가된 키, 값 쌍 세트입니다.

recreateParams

object

RecreateDeploymentStrategyParams는 Recreate 배포 전략에 대한 입력입니다.

resources

resourceRequirements

리소스에는 배포 및 후크를 실행하기 위한 리소스 요구 사항이 포함되어 있습니다.

rollingParams

object

RollingDeploymentStrategyParams는 롤링 배포 전략에 대한 입력입니다.

type

string

type은 배포 전략의 이름입니다.

9.1.3. .spec.strategy.customParams

설명
CustomDeploymentStrategyParams는 사용자 정의 배포 전략에 대한 입력입니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 선택 사항이며 컨테이너 이미지의 CMD를 덮어씁니다.

환경

array(EnvVar)

환경에는 이미지용으로 컨테이너에 제공할 환경이 있습니다.

image

string

image는 배포를 수행할 수 있는 컨테이너 이미지를 지정합니다.

9.1.4. .spec.strategy.recreateParams

설명
RecreateDeploymentStrategyParams는 Recreate 배포 전략에 대한 입력입니다.
유형
object
속성유형설명

중간

object

LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.

POST

object

LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.

pre

object

LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.

timeoutSeconds

integer

timeoutSeconds는 포기하기 전에 업데이트를 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다.

9.1.5. .spec.strategy.recreateParams.mid

설명
LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
유형
object
필수 항목
  • failurePolicy
속성유형설명

execNewPod

object

ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.

failurePolicy

string

failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다.

tagImages

array

TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.

tagImages[]

object

TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.

9.1.6. .spec.strategy.recreateParams.mid.execNewPod

설명
ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
유형
object
필수 항목
  • command
  • containerName
속성유형설명

command

배열(문자열)

명령은 작업 명령 및 해당 인수입니다.

containerName

string

containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다.

env

array(EnvVar)

env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다.

volumes

배열(문자열)

volume은 후크 포드에 복사해야 하는 Pod 템플릿에서 이름이 지정된 볼륨 목록입니다. Pod 사양에서 찾을 수 없는 볼륨 이름은 무시됩니다. 빈 목록은 볼륨이 복사되지 않음을 의미합니다.

9.1.7. .spec.strategy.recreateParams.mid.tagImages

설명
TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.
유형
array

9.1.8. .spec.strategy.recreateParams.mid.tagImages[]

설명
TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.
유형
object
필수 항목
  • containerName
  • 다음으로 변경
속성유형설명

containerName

string

containername은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다.

다음으로 변경

ObjectReference

to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다.

9.1.9. .spec.strategy.recreateParams.post

설명
LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
유형
object
필수 항목
  • failurePolicy
속성유형설명

execNewPod

object

ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.

failurePolicy

string

failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다.

tagImages

array

TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.

tagImages[]

object

TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.

9.1.10. .spec.strategy.recreateParams.post.execNewPod

설명
ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
유형
object
필수 항목
  • command
  • containerName
속성유형설명

command

배열(문자열)

명령은 작업 명령 및 해당 인수입니다.

containerName

string

containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다.

env

array(EnvVar)

env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다.

volumes

배열(문자열)

volume은 후크 포드에 복사해야 하는 Pod 템플릿에서 이름이 지정된 볼륨 목록입니다. Pod 사양에서 찾을 수 없는 볼륨 이름은 무시됩니다. 빈 목록은 볼륨이 복사되지 않음을 의미합니다.

9.1.11. .spec.strategy.recreateParams.post.tagImages

설명
TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.
유형
array

9.1.12. .spec.strategy.recreateParams.post.tagImages[]

설명
TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.
유형
object
필수 항목
  • containerName
  • 다음으로 변경
속성유형설명

containerName

string

containername은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다.

다음으로 변경

ObjectReference

to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다.

9.1.13. .spec.strategy.recreateParams.pre

설명
LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
유형
object
필수 항목
  • failurePolicy
속성유형설명

execNewPod

object

ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.

failurePolicy

string

failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다.

tagImages

array

TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.

tagImages[]

object

TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.

9.1.14. .spec.strategy.recreateParams.pre.execNewPod

설명
ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
유형
object
필수 항목
  • command
  • containerName
속성유형설명

command

배열(문자열)

명령은 작업 명령 및 해당 인수입니다.

containerName

string

containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다.

env

array(EnvVar)

env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다.

volumes

배열(문자열)

volume은 후크 포드에 복사해야 하는 Pod 템플릿에서 이름이 지정된 볼륨 목록입니다. Pod 사양에서 찾을 수 없는 볼륨 이름은 무시됩니다. 빈 목록은 볼륨이 복사되지 않음을 의미합니다.

9.1.15. .spec.strategy.recreateParams.pre.tagImages

설명
TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.
유형
array

9.1.16. .spec.strategy.recreateParams.pre.tagImages[]

설명
TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.
유형
object
필수 항목
  • containerName
  • 다음으로 변경
속성유형설명

containerName

string

containername은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다.

다음으로 변경

ObjectReference

to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다.

9.1.17. .spec.strategy.rollingParams

설명
RollingDeploymentStrategyParams는 롤링 배포 전략에 대한 입력입니다.
유형
object
속성유형설명

intervalSeconds

integer

IntervalSeconds는 업데이트 후 배포 상태를 폴링할 때까지 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다.

maxSurge

IntOrString

maxSurge는 원래 Pod 수 이상으로 예약할 수 있는 최대 Pod 수입니다. 값은 절대 번호(예: 5) 또는 업데이트 시작 시 총 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다.

MaxUnavailable이 0인 경우 이 값은 0이 될 수 없습니다. 기본적으로 25%가 사용됩니다.

예: 이 값을 30%로 설정하면 롤링 업데이트가 시작될 때 즉시 새 RC를 30%까지 확장할 수 있습니다. 이전 Pod가 종료되면 새 RC를 추가로 확장할 수 있으므로 업데이트 중에 언제든지 실행 중인 총 Pod 수가 원래 Pod의 최대 controlPlane%가 되도록 할 수 있습니다.

maxUnavailable

IntOrString

maxUnavailable은 업데이트 중에 사용할 수 없는 최대 Pod 수입니다. 값은 절대 번호(예: 5) 또는 업데이트 시작 시 총 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다.

MaxSurge가 0인 경우 이 값은 0이 될 수 없습니다. 기본적으로 25%가 사용됩니다.

예: 이 값을 30%로 설정하면 롤링 업데이트가 시작될 때 즉시 이전 RC를 30%까지 축소할 수 있습니다. 새 Pod가 준비되면 이전 RC를 추가로 축소한 후 새 RC를 확장하여 업데이트 중에 원래 Pod 수의 70% 이상을 사용할 수 있습니다.

POST

object

LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.

pre

object

LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.

timeoutSeconds

integer

timeoutSeconds는 포기하기 전에 업데이트를 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다.

updatePeriodSeconds

integer

UpdatePeriodSeconds는 개별 Pod 업데이트 간에 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다.

9.1.18. .spec.strategy.rollingParams.post

설명
LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
유형
object
필수 항목
  • failurePolicy
속성유형설명

execNewPod

object

ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.

failurePolicy

string

failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다.

tagImages

array

TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.

tagImages[]

object

TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.

9.1.19. .spec.strategy.rollingParams.post.execNewPod

설명
ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
유형
object
필수 항목
  • command
  • containerName
속성유형설명

command

배열(문자열)

명령은 작업 명령 및 해당 인수입니다.

containerName

string

containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다.

env

array(EnvVar)

env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다.

volumes

배열(문자열)

volume은 후크 포드에 복사해야 하는 Pod 템플릿에서 이름이 지정된 볼륨 목록입니다. Pod 사양에서 찾을 수 없는 볼륨 이름은 무시됩니다. 빈 목록은 볼륨이 복사되지 않음을 의미합니다.

9.1.20. .spec.strategy.rollingParams.post.tagImages

설명
TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.
유형
array

9.1.21. .spec.strategy.rollingParams.post.tagImages[]

설명
TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.
유형
object
필수 항목
  • containerName
  • 다음으로 변경
속성유형설명

containerName

string

containername은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다.

다음으로 변경

ObjectReference

to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다.

9.1.22. .spec.strategy.rollingParams.pre

설명
LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
유형
object
필수 항목
  • failurePolicy
속성유형설명

execNewPod

object

ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.

failurePolicy

string

failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다.

tagImages

array

TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.

tagImages[]

object

TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.

9.1.23. .spec.strategy.rollingParams.pre.execNewPod

설명
ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
유형
object
필수 항목
  • command
  • containerName
속성유형설명

command

배열(문자열)

명령은 작업 명령 및 해당 인수입니다.

containerName

string

containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다.

env

array(EnvVar)

env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다.

volumes

배열(문자열)

volume은 후크 포드에 복사해야 하는 Pod 템플릿에서 이름이 지정된 볼륨 목록입니다. Pod 사양에서 찾을 수 없는 볼륨 이름은 무시됩니다. 빈 목록은 볼륨이 복사되지 않음을 의미합니다.

9.1.24. .spec.strategy.rollingParams.pre.tagImages

설명
TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다.
유형
array

9.1.25. .spec.strategy.rollingParams.pre.tagImages[]

설명
TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다.
유형
object
필수 항목
  • containerName
  • 다음으로 변경
속성유형설명

containerName

string

containername은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다.

다음으로 변경

ObjectReference

to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다.

9.1.26. .spec.triggers

설명
Trigger가 DeploymentConfig에 대한 업데이트로 인해 새 배포가 생성되는 방식을 결정합니다. 트리거가 정의되지 않은 경우 새 LatestVersion을 사용하여 DeploymentConfig에 대한 명시적 클라이언트 업데이트로 인해 새 배포가 발생할 수 있습니다. null인 경우 기본적으로 구성 변경 트리거가 있습니다.
유형
array

9.1.27. .spec.triggers[]

설명
DeploymentTriggerPolicy는 새 배포를 생성하는 단일 트리거에 대한 정책을 설명합니다.
유형
object
속성유형설명

imageChangeParams

object

DeploymentTriggerImageChangeParams는 ImageChange 트리거에 대한 매개변수를 나타냅니다.

type

string

트리거의 유형

9.1.28. .spec.triggers[].imageChangeParams

설명
DeploymentTriggerImageChangeParams는 ImageChange 트리거에 대한 매개변수를 나타냅니다.
유형
object
필수 항목
  • from
속성유형설명

자동

boolean

자동이란 새 태그 값을 탐지하면 pod 템플릿 내에서 이미지가 업데이트되어야 합니다.

containerNames

배열(문자열)

ContainerNames는 Pod에서 지정된 컨테이너 이름 세트로 태그 업데이트를 제한하는 데 사용됩니다. 여러 트리거가 동일한 컨테이너를 가리키는 경우 결과 동작이 정의되지 않습니다. 향후 API 버전에서는 검증 오류가 발생합니다. ContainerNames에서 유효한 컨테이너를 가리키지 않으면 트리거가 무시됩니다. 향후 API 버전에서는 검증 오류가 발생합니다.

from

ObjectReference

에서 변경 사항을 조사할 이미지 스트림 태그에 대한 참조입니다. from.Name은 유일한 필수 하위 필드입니다 - From.Namespace가 비어 있으면 현재 배포 트리거의 네임스페이스가 사용됩니다.

lastTriggeredImage

string

LastTriggeredImage는 트리거할 마지막 이미지입니다.

9.1.29. .status

설명
DeploymentConfigStatus는 현재 배포 상태를 나타냅니다.
유형
object
필수 항목
  • latestVersion
  • observedGeneration
  • replicas
  • updatedReplicas
  • availableReplicas
  • unavailableReplicas
속성유형설명

availableReplicas

integer

AvailableReplicas는 이 배포 구성에서 대상으로 하는 총 사용 가능한 Pod 수입니다.

conditions

array

conditions는 배포 구성의 현재 상태를 확인할 수 있는 최신 상태를 나타냅니다.

conditions[]

object

DeploymentCondition은 특정 시점에서 배포 구성 상태를 설명합니다.

세부 정보

object

Deployment Details는 배포 원인에 대한 정보를 캡처합니다.

latestVersion

integer

LatestVersion은 배포 구성과 연결된 현재 배포가 동기화되지 않았는지 확인하는 데 사용됩니다.

observedGeneration

integer

observedGeneration은 배포 구성 컨트롤러에서 관찰하는 최신 생성입니다.

readyReplicas

integer

이 배포에서 대상으로 하는 총 준비된 Pod 수입니다.

replicas

integer

replicas는 이 배포 구성에서 대상으로 하는 총 Pod 수입니다.

unavailableReplicas

integer

UnavailableReplicas는 이 배포 구성에서 대상으로 하는 사용 불가능한 총 Pod 수입니다.

updatedReplicas

integer

UpdatedReplicas는 원하는 템플릿 사양이 있는 이 배포 구성에서 대상으로 하는 종료되지 않은 총 Pod 수입니다.

9.1.30. .status.conditions

설명
conditions는 배포 구성의 현재 상태를 확인할 수 있는 최신 상태를 나타냅니다.
유형
array

9.1.31. .status.conditions[]

설명
DeploymentCondition은 특정 시점에서 배포 구성 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다.

lastUpdateTime

시간

이 조건이 마지막으로 업데이트된 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

배포 조건 유형입니다.

9.1.32. .status.details

설명
Deployment Details는 배포 원인에 대한 정보를 캡처합니다.
유형
object
필수 항목
  • 원인
속성유형설명

원인

array

이는 새 배포를 생성하기 위한 모든 원인과 연결된 확장된 데이터입니다.

causes[]

object

DeploymentCause는 배포의 특정 원인에 대한 정보를 캡처합니다.

message

string

message는 사용자가 이 배포가 수동으로 트리거된 경우 변경 메시지입니다.

9.1.33. .status.details.causes

설명
이는 새 배포를 생성하기 위한 모든 원인과 연결된 확장된 데이터입니다.
유형
array

9.1.34. .status.details.causes[]

설명
DeploymentCause는 배포의 특정 원인에 대한 정보를 캡처합니다.
유형
object
필수 항목
  • type
속성유형설명

imageTrigger

object

DeploymentCauseImageTrigger는 이미지 변경 트리거에서 발생하는 배포 원인에 대한 세부 정보를 나타냅니다.

type

string

새 배포가 생성된 트리거의 유형

9.1.35. .status.details.causes[].imageTrigger

설명
DeploymentCauseImageTrigger는 이미지 변경 트리거에서 발생하는 배포 원인에 대한 세부 정보를 나타냅니다.
유형
object
필수 항목
  • from
속성유형설명

from

ObjectReference

에서 배포를 트리거한 변경된 오브젝트에 대한 참조입니다. 이 필드에는 DockerImage, ImageStreamTag 또는 ImageStreamImage 유형이 있을 수 있습니다.

9.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps.openshift.io/v1/deploymentconfigs

    • GET: DeploymentConfig 유형의 오브젝트 나열 또는 감시
  • /apis/apps.openshift.io/v1/watch/deploymentconfigs

    • GET: DeploymentConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs

    • DELETE: DeploymentConfig의 컬렉션 삭제
    • GET: DeploymentConfig 유형의 오브젝트 나열 또는 감시
    • POST: DeploymentConfig 생성
  • /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs

    • GET: DeploymentConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}

    • DELETE: DeploymentConfig 삭제
    • GET: 지정된 DeploymentConfig 읽기
    • PATCH: 지정된 DeploymentConfig를 부분적으로 업데이트
    • PUT: 지정된 DeploymentConfig를 교체
  • /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}

    • GET: kind DeploymentConfig. deprecated 오브젝트의 변경 사항을 조사합니다. 더 이상 사용되지 않는 오브젝트: 'fieldSelector' 매개변수를 사용하여 목록 작업과 함께 'watch' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status

    • GET: 지정된 DeploymentConfig의 읽기 상태
    • PATCH: 지정된 DeploymentConfig의 부분적으로 업데이트 상태
    • PUT: 지정된 DeploymentConfig의 상태

9.2.1. /apis/apps.openshift.io/v1/deploymentconfigs

표 9.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
DeploymentConfig 유형의 오브젝트 나열 또는 감시
표 9.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfigList schema

401 - 무단

9.2.2. /apis/apps.openshift.io/v1/watch/deploymentconfigs

표 9.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
DeploymentConfig. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 9.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

9.2.3. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs

표 9.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 9.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
DeploymentConfig 컬렉션 삭제
표 9.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 9.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 9.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
DeploymentConfig 유형의 오브젝트 나열 또는 감시
표 9.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 9.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfigList schema

401 - 무단

HTTP 방법
POST
설명
DeploymentConfig 생성
표 9.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 9.13. 본문 매개변수
매개변수유형설명

body

DeploymentConfig 스키마

 
표 9.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

201 - 생성됨

DeploymentConfig 스키마

202 - 승인됨

DeploymentConfig 스키마

401 - 무단

9.2.4. /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs

표 9.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 9.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
DeploymentConfig. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 9.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

9.2.5. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}

표 9.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

DeploymentConfig의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 9.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
DeploymentConfig 삭제
표 9.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 9.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 9.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 DeploymentConfig 읽기
표 9.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DeploymentConfig를 부분적으로 업데이트
표 9.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 9.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 9.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

201 - 생성됨

DeploymentConfig 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DeploymentConfig를 교체
표 9.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 9.28. 본문 매개변수
매개변수유형설명

body

DeploymentConfig 스키마

 
표 9.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

201 - 생성됨

DeploymentConfig 스키마

401 - 무단

9.2.6. /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}

표 9.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

DeploymentConfig의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 9.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
DeploymentConfig. deprecated 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 9.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

9.2.7. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status

표 9.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

DeploymentConfig의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 9.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 DeploymentConfig의 읽기 상태
표 9.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 DeploymentConfig의 부분적으로 업데이트 상태
표 9.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 9.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 9.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

201 - 생성됨

DeploymentConfig 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DeploymentConfig의 상태 교체
표 9.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 9.40. 본문 매개변수
매개변수유형설명

body

DeploymentConfig 스키마

 
표 9.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfig 스키마

201 - 생성됨

DeploymentConfig 스키마

401 - 무단

10장. DeploymentConfigRollback [apps.openshift.io/v1]

설명

DeploymentConfigRollback은 롤백 생성에 대한 입력을 제공합니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • name
  • spec

10.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

롤백할 배포 구성의 이름입니다.

spec

object

DeploymentConfigRollbackSpec은 롤백 생성 옵션을 나타냅니다.

updatedAnnotations

오브젝트(문자열)

UpdatedAnnotations는 배포 구성에 추가될 새 주석 세트입니다.

10.1.1. .spec

설명
DeploymentConfigRollbackSpec은 롤백 생성 옵션을 나타냅니다.
유형
object
필수 항목
  • from
  • includeTriggers
  • includeTemplate
  • includeReplicationMeta
  • includeStrategy
속성유형설명

from

ObjectReference

배포인 ReplicationController를 가리킵니다.

includeReplicationMeta

boolean

IncludeReplicationMeta 는 복제본 수와 선택기를 포함할지 여부를 지정합니다.

includeStrategy

boolean

IncludeStrategy는 배포 전략을 포함할지 여부를 지정합니다.

includeTemplate

boolean

IncludeTemplate은 PodTemplateSpec을 포함할지 여부를 지정합니다.

includeTriggers

boolean

IncludeTriggers는 구성 트리거를 포함할지 여부를 지정합니다.

버전

integer

롤백할 수 있습니다. 0으로 설정하면 마지막 버전으로 롤백하십시오.

10.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/rollback

    • POST: DeploymentConfig의 롤백 생성

10.2.1. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/rollback

표 10.1. 글로벌 경로 매개변수
매개변수유형설명

name

string

DeploymentConfigRollback의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 10.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
DeploymentConfig의 롤백 생성
표 10.3. 본문 매개변수
매개변수유형설명

body

DeploymentConfigRollback schema

 
표 10.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentConfigRollback schema

201 - 생성됨

DeploymentConfigRollback schema

202 - 승인됨

DeploymentConfigRollback schema

401 - 무단

11장. DeploymentLog [apps.openshift.io/v1]

설명

DeploymentLog는 배포 로그를 나타냅니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object

11.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

11.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/log

    • GET: 지정된 DeploymentConfig의 읽기 로그

11.2.1. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/log

표 11.1. 글로벌 경로 매개변수
매개변수유형설명

name

string

DeploymentLog의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 11.2. 글로벌 쿼리 매개변수
매개변수유형설명

container

string

로그를 스트리밍할 컨테이너입니다. Pod에 컨테이너가 한 개 있는 경우에만 기본값은 컨테이너입니다.

팔로우

boolean

true인 경우 빌드가 종료될 때까지 빌드 로그를 스트리밍해야 합니다.

limitBytes

integer

설정된 경우 로그 출력을 종료하기 전에 서버에서 읽을 바이트 수입니다. 이는 완전한 최종 로깅 행을 표시하지 않을 수 있으며 지정된 제한보다 약간 많거나 적을 수 있습니다.

nowait

boolean

nowait true인 경우 배포를 아직 사용할 수 없는 경우에도 호출이 즉시 반환됩니다. 그렇지 않으면 서버가 배포가 시작될 때까지 기다립니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

이전

boolean

이전 배포 로그를 반환합니다. 기본값은 false입니다.

sinceSeconds

integer

로그를 표시할 현재 시간(초) 전의 상대 시간(초)입니다. 이 값이 Pod를 시작한 시간보다 앞면 Pod 시작 이후의 로그만 반환됩니다. 이 값이 향후이면 로그가 반환되지 않습니다. sinceSeconds 또는 sinceTime 중 하나만 지정할 수 있습니다.

tailLines

integer

설정하는 경우 표시할 로그 끝부분의 행 수입니다. 지정하지 않으면 컨테이너 생성 또는 sinceSeconds 또는 sinceTime에서 로그가 표시됩니다.

타임 스탬프

boolean

true인 경우 로그 출력의 모든 줄 시작 부분에 RFC3339 또는 RFC3339Nano 타임스탬프를 추가합니다. 기본값은 false입니다.

version

integer

로그를 볼 배포 버전입니다.

HTTP 방법
GET
설명
지정된 DeploymentConfig의 로그 읽기
표 11.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentLog schema

401 - 무단

12장. DeploymentRequest [apps.openshift.io/v1]

설명

DeploymentRequest는 새 배포에 대한 배포 구성에 대한 요청입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형
object
필수 항목
  • name
  • latest
  • force

12.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

excludeTriggers

배열(문자열)

ExcludeTriggers는 지정된 트리거를 처리하지 않도록 인스턴스화를 지시합니다. 이 필드는 최신의 트리거를 재정의하고 클라이언트가 특정 논리를 제어할 수 있습니다. 지정하지 않으면 이 필드는 무시됩니다.

force

boolean

force는 새 배포를 강제로 실행하려고 합니다. 배포 구성이 일시 중지되면 true로 설정하면 Invalid 오류가 반환됩니다.

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

latest

boolean

latest는 모든 트리거의 최신 상태로 배포 구성을 업데이트합니다.

name

string

새 배포를 요청하는 배포 구성의 이름입니다.

12.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/instantiate

    • POST: DeploymentConfig의 인스턴스화 생성

12.2.1. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/instantiate

표 12.1. 글로벌 경로 매개변수
매개변수유형설명

name

string

DeploymentRequest의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 12.2. 글로벌 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
POST
설명
DeploymentConfig의 인스턴스화 생성
표 12.3. 본문 매개변수
매개변수유형설명

body

DeploymentRequest 스키마

 
표 12.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DeploymentRequest 스키마

201 - 생성됨

DeploymentRequest 스키마

202 - 승인됨

DeploymentRequest 스키마

401 - 무단

13장. 작업 [batch/v1]

설명
job은 단일 작업의 구성을 나타냅니다.
유형
object

13.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

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

status

object

JobStatus는 작업의 현재 상태를 나타냅니다.

13.1.1. .spec

설명
JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다.
유형
object
필수 항목
  • 템플릿
속성유형설명

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

병렬 처리

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으로 설정하면 작업이 완료된 직후에 삭제할 수 있습니다.

13.1.2. .spec.podFailurePolicy

설명
PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다.
유형
object
필수 항목
  • 규칙
속성유형설명

규칙

array

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

rules[]

object

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

13.1.3. .spec.podFailurePolicy.rules

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

13.1.4. .spec.podFailurePolicy.rules[]

설명
PodFailurePolicyRule는 요구사항이 충족될 때 Pod 실패를 처리하는 방법을 설명합니다. OnExitCodes 및 onPodConditions 중 하나이지만 둘 다 사용할 수 없습니다.
유형
object
필수 항목
  • 작업
속성유형설명

작업

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 상태 유형과 일치하는 패턴을 설명합니다.

13.1.5. .spec.podFailurePolicy.rules[].onExitCodes

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

containerName

string

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

operator

string

컨테이너 종료 코드와 지정된 값 간의 관계를 나타냅니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. 가능한 값은 다음과 같습니다. - In: 하나 이상의 컨테이너 종료 코드( 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개인 경우 여러 개)가 지정된 값 세트에 있는 경우 여러 컨테이너가 충족됩니다. - NotIn: NotIn: 컨테이너 종료 코드 중 하나 이상이 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개 있는 경우 요구 사항이 충족됩니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 요구 사항이 충족되지 않았음을 가정하여 알 수 없는 Operator에 반응해야 합니다.

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

배열(정수)

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

13.1.6. .spec.podFailurePolicy.rules[].onPodConditions

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

13.1.7. .spec.podFailurePolicy.rules[].onPodConditions[]

설명
PodFailurePolicyOnPodConditionsPattern은 실제 Pod 상태 유형과 일치하는 패턴을 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

status

string

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

type

string

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

13.1.8. .status

설명
JobStatus는 작업의 현재 상태를 나타냅니다.
유형
object
속성유형설명

활성 상태

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를 보유하고 있습니다.

13.1.9. .status.conditions

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

13.1.10. .status.conditions[]

설명
JobCondition은 작업의 현재 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastProbeTime

시간

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

lastTransitionTime

시간

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

message

string

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

reason

string

조건의 마지막 전환 이유

status

string

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

type

string

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

13.1.11. .status.uncountedTerminatedPods

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

failed

배열(문자열)

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

succeeded

배열(문자열)

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

13.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/batch/v1/jobs

    • GET: 작업 유형의 오브젝트 나열 또는 감시
  • /apis/batch/v1/watch/jobs

    • GET: individual changes to a list of Job. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/batch/v1/namespaces/{namespace}/jobs

    • DELETE: 작업 컬렉션 삭제
    • GET: 작업 유형의 오브젝트 나열 또는 감시
    • POST: 작업 생성
  • /apis/batch/v1/watch/namespaces/{namespace}/jobs

    • GET: individual changes to a list of Job. deprecated: 대신 list 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/batch/v1/namespaces/{namespace}/jobs/{name}

    • DELETE: 작업 삭제
    • GET: 지정된 작업 읽기
    • PATCH: 지정된 작업을 부분적으로 업데이트
    • PUT: 지정된 작업 교체
  • /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}

    • GET: 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

    • GET: 지정된 작업의 읽기 상태
    • PATCH: 지정된 작업의 부분 업데이트 상태
    • PUT: 지정된 작업의 상태

13.2.1. /apis/batch/v1/jobs

표 13.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
작업 유형 오브젝트 나열 또는 감시
표 13.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

JobList 스키마

401 - 무단

13.2.2. /apis/batch/v1/watch/jobs

표 13.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Job. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 13.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

13.2.3. /apis/batch/v1/namespaces/{namespace}/jobs

표 13.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 13.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
작업 컬렉션 삭제
표 13.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 13.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 13.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
작업 유형 오브젝트 나열 또는 감시
표 13.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 13.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

JobList 스키마

401 - 무단

HTTP 방법
POST
설명
작업 생성
표 13.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 13.13. 본문 매개변수
매개변수유형설명

body

작업 스키마

 
표 13.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

201 - 생성됨

작업 스키마

202 - 승인됨

작업 스키마

401 - 무단

13.2.4. /apis/batch/v1/watch/namespaces/{namespace}/jobs

표 13.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 13.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Job. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 13.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

13.2.5. /apis/batch/v1/namespaces/{namespace}/jobs/{name}

표 13.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

작업 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 13.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
작업 삭제
표 13.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 13.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 13.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 작업 읽기
표 13.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 작업을 부분적으로 업데이트
표 13.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 13.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 13.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

201 - 생성됨

작업 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 작업 교체
표 13.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 13.28. 본문 매개변수
매개변수유형설명

body

작업 스키마

 
표 13.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

201 - 생성됨

작업 스키마

401 - 무단

13.2.6. /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}

표 13.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

작업 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 13.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 13.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

13.2.7. /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

표 13.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

작업 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 13.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 작업의 읽기 상태
표 13.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 작업의 부분적으로 업데이트 상태
표 13.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 13.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 13.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

201 - 생성됨

작업 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 작업의 상태 교체
표 13.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 13.40. 본문 매개변수
매개변수유형설명

body

작업 스키마

 
표 13.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

작업 스키마

201 - 생성됨

작업 스키마

401 - 무단

14장. 포드 [v1]

설명
Pod는 호스트에서 실행할 수 있는 컨테이너 컬렉션입니다. 이 리소스는 클라이언트에서 생성하며 호스트에 예약됩니다.
유형
object

14.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

PodSpec은 Pod에 대한 설명입니다.

status

object

PodStatus는 Pod 상태에 대한 정보를 나타냅니다. Pod가 컨트롤 플레인에 연결할 수 없는 경우 상태가 시스템의 실제 상태를 추적할 수 있습니다.

14.1.1. .spec

설명
PodSpec은 Pod에 대한 설명입니다.
유형
object
필수 항목
  • 컨테이너
속성유형설명

activeDeadlineSeconds

integer

시스템이 적극적으로 실패했음을 표시하고 연결된 컨테이너를 종료하기 전에 Pod가 StartTime을 기준으로 노드에서 활성화되는 시간(초)입니다. 값은 양의 정수여야 합니다.

유사성

object

유사성은 선호도 스케줄링 규칙 그룹입니다.

automountServiceAccountToken

boolean

AutomountServiceAccountToken은 서비스 계정 토큰을 자동으로 마운트해야 하는지 여부를 나타냅니다.

컨테이너

array

Pod에 속하는 컨테이너 목록입니다. 컨테이너는 현재 추가 또는 제거할 수 없습니다. Pod에는 하나 이상의 컨테이너가 있어야 합니다. CamelCase로

containers[]

object

Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.

dnsConfig

object

PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다.

dnsPolicy

string

Pod의 DNS 정책을 설정합니다. 기본값은 "ClusterFirst"입니다. 유효한 값은 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' 또는 'None'입니다. DNSConfig에 제공된 DNS 매개변수는 DNSPolicy와 선택한 정책과 병합됩니다. hostNetwork와 함께 DNS 옵션을 설정하려면 'ClusterFirstWithHostNet'에 DNS 정책을 명시적으로 지정해야 합니다.

가능한 enum 값: - "ClusterFirst" 는 hostNetwork가 true인 경우를 제외하고 먼저 클러스터 DNS를 사용해야 함을 나타냅니다. 그런 다음 기본 ( kubelet에 의해 결정됨) DNS 설정으로 대체하십시오. - "ClusterFirstWithHostNet" 은 사용 가능한 경우 Pod에서 클러스터 DNS를 먼저 사용해야 함을 나타냅니다. 기본 ( kubelet에 의해 결정됨) DNS 설정에서 "Default" 는 Pod에서 기본 ( kubelet에 의해 결정됨) DNS 설정을 사용해야 함을 나타냅니다. - "없음" 은 Pod에서 빈 DNS 설정을 사용해야 함을 나타냅니다. 이름 서버 및 검색 경로와 같은 DNS 매개변수는 DNSConfig를 통해 정의해야 합니다.

enableServiceLinks

boolean

EnableServiceLinks는 서비스에 대한 정보를 Docker 링크의 구문과 일치하는 Pod의 환경 변수에 삽입해야 하는지 여부를 나타냅니다. 선택 사항: true로 설정됩니다.

ephemeralContainers

array

이 Pod에서 실행되는 임시 컨테이너 목록입니다. 임시 컨테이너는 기존 Pod에서 실행하여 디버깅과 같은 사용자 시작 작업을 수행할 수 있습니다. 이 목록은 Pod를 생성할 때 지정할 수 없으며 Pod 사양을 업데이트하여 수정할 수 없습니다. 기존 포드에 임시 컨테이너를 추가하려면 Pod의 ephemeralcontainers 하위 리소스를 사용합니다.

ephemeralContainers[]

object

EphemeralContainer는 디버깅과 같은 사용자 시작 활동을 위해 기존 Pod에 추가할 수 있는 임시 컨테이너입니다. 임시 컨테이너에는 리소스 또는 스케줄링 보장이 없으며 Pod가 종료되거나 Pod를 다시 시작할 때 재시작되지 않습니다. 임시 컨테이너에서 Pod가 리소스 할당을 초과하는 경우 kubelet에서 Pod를 제거할 수 있습니다.

임시 컨테이너를 추가하려면 기존 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. 임시 컨테이너는 제거하거나 다시 시작할 수 없습니다.

hostAliases

array

hostAliases는 지정된 경우 Pod의 호스트 파일에 삽입될 호스트 및 IP의 선택적 목록입니다. 이는 non-hostNetwork Pod에만 유효합니다.

hostAliases[]

object

HostAlias는 Pod의 호스트 파일에 항목으로 삽입될 IP와 호스트 이름 간의 매핑을 보유합니다.

hostIPC

boolean

호스트의 ipc 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다.

hostNetwork

boolean

이 Pod에 대해 요청된 호스트 네트워킹입니다. 호스트의 네트워크 네임스페이스를 사용합니다. 이 옵션을 설정하는 경우 사용할 포트를 지정해야 합니다. 기본값은 false입니다.

hostPID

boolean

호스트의 pid 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다.

hostUsers

boolean

호스트의 사용자 네임스페이스를 사용합니다. 선택 사항: 기본값은 true입니다. true로 설정하면 Pod에 CAP_SYS_MODULE을 사용하여 커널 모듈을 로드하는 등 호스트 사용자 네임스페이스만 사용할 수 있는 기능이 필요한 경우에 유용합니다. false로 설정하면 Pod에 대한 새 사용자가 생성됩니다. false를 설정하면 사용자가 실제로 호스트에 대한 root 권한이 없어도 컨테이너 중단 취약점을 완화하는 데 유용합니다. 이 필드는 알파 수준이며 UserNamespacesSupport 기능을 활성화하는 서버에서만 적용됩니다.

hostname

string

Pod의 호스트 이름을 지정하지 않으면 Pod의 호스트 이름이 시스템 정의 값으로 설정됩니다.

imagePullSecrets

array

imagePullSecrets는 이 PodSpec에서 사용하는 이미지를 가져오는 데 사용할 동일한 네임스페이스의 시크릿에 대한 선택적 참조 목록입니다. 지정된 경우 이러한 시크릿은 사용할 수 있도록 개별 풀러 구현으로 전달됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod

imagePullSecrets[]

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

initContainers

array

Pod에 속하는 초기화 컨테이너 목록입니다. Init 컨테이너는 컨테이너가 시작되기 전에 실행됩니다. init 컨테이너가 실패하면 Pod가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너에서 고유해야 합니다. Init 컨테이너에는 Lifecycle 작업, 준비 상태 프로브, 활성 상태 프로브 또는 시작 프로브가 없을 수 있습니다. init 컨테이너의 resourceRequirements는 각 리소스 유형에 대해 가장 높은 요청/제한을 찾은 다음 해당 값의 최대값 또는 일반 컨테이너의 합계를 사용하여 스케줄링 중에 고려됩니다. 제한은 init 컨테이너에 유사한 방식으로 적용됩니다. init 컨테이너는 현재 추가 또는 제거할 수 없습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/

initContainers[]

object

Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.

nodeName

string

nodename은 이 Pod를 특정 노드에 예약하기 위한 요청입니다. 비어 있지 않은 경우 스케줄러는 리소스 요구 사항에 부합한다고 가정하면 해당 노드에 이 Pod를 간단히 예약합니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 Pod가 노드에 적합하도록 true여야 하는 선택기입니다. 해당 노드에 예약하려면 Pod의 노드 레이블과 일치해야 하는 선택기입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

OS

object

PodOS는 Pod의 OS 매개변수를 정의합니다.

오버헤드

오브젝트(Quantity)

오버헤드는 지정된 RuntimeClass에 대해 Pod를 실행하는 것과 관련된 리소스 오버헤드를 나타냅니다. 이 필드는 RuntimeClass 승인 컨트롤러에서 승인 시 자동으로 채워집니다. RuntimeClass 승인 컨트롤러가 활성화된 경우 Pod 생성 요청에 오버헤드를 설정하지 않아야 합니다. RuntimeClass 승인 컨트롤러는 오버헤드가 이미 설정된 Pod 생성 요청을 거부합니다. PodSpec에서 RuntimeClass를 구성 및 선택하면 Overhead가 해당 RuntimeClass에 정의된 값으로 설정됩니다. 그렇지 않으면 설정되지 않고 0으로 처리됩니다. 자세한 내용은 https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md

preemptionPolicy

string

preemptionPolicy는 우선순위가 낮은 Pod를 선점하는 정책입니다. Never, PreemptLowerPriority 중 하나입니다. 설정되지 않은 경우 기본값은 PreemptLowerPriority입니다.

priority

integer

우선순위 값입니다. 다양한 시스템 구성 요소는 이 필드를 사용하여 Pod의 우선 순위를 찾습니다. Priority Admission Controller가 활성화되면 사용자가 이 필드를 설정할 수 없습니다. 승인 컨트롤러는 PriorityClassName에서 이 필드를 채웁니다. 값이 클수록 우선순위가 높습니다.

priorityClassName

string

지정하면 Pod의 우선 순위를 나타냅니다. "system-node-critical" 및 "system-cluster-critical"은 두 가지 특수 키워드로, 전자의 우선 순위가 가장 높은 우선 순위임을 나타냅니다. 다른 이름은 해당 이름으로 PriorityClass 오브젝트를 생성하여 정의해야 합니다. 지정하지 않으면 Pod 우선순위가 기본값 또는 기본값이 없는 경우 0입니다.

readinessGates

array

지정하면 Pod 준비 상태에 대한 모든 준비 상태 게이트가 평가됩니다. 모든 컨테이너가 준비되고 준비 게이트에 지정된 모든 조건이 "True" 추가 정보와 같은 상태가 있는 경우 Pod가 준비됩니다. https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates

readinessGates[]

object

PodReadinessGate에는 Pod 상태에 대한 참조가 포함되어 있습니다.

restartPolicy

string

Pod 내의 모든 컨테이너에 대한 재시작 정책입니다. Always, OnFailure, Never 중 하나입니다. 기본값은 Always입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy

가능한 열거 값: - "항상" - "Never" - "OnFailure"

runtimeClassName

string

runtimeClassName은 이 Pod를 실행하는 데 사용해야 하는 node.k8s.io 그룹의 RuntimeClass 오브젝트를 나타냅니다. RuntimeClass 리소스가 이름이 지정된 클래스와 일치하지 않으면 Pod가 실행되지 않습니다. 설정되지 않았거나 비어 있으면 기본 런타임 처리기를 사용하는 빈 정의가 있는 암시적 클래스인 "legacy" RuntimeClass가 사용됩니다. 자세한 내용은 https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class

schedulerName

string

지정된 경우 지정된 스케줄러에 의해 Pod가 디스패치됩니다. 지정하지 않으면 Pod가 기본 스케줄러에서 디스패치됩니다.

securityContext

object

PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다.

serviceAccount

string

더 이상 사용되지 않는ServiceAccount는 ServiceAccountName의 더 이상 사용되지 않는 별칭입니다. deprecated: 대신 serviceAccountName을 사용합니다.

serviceAccountName

string

serviceAccountName은 이 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/

setHostnameAsFQDN

boolean

true인 경우 Pod의 호스트 이름이 리프 이름(기본값)이 아닌 Pod의 FQDN으로 구성됩니다. Linux 컨테이너에서 커널의 hostname 필드에 FQDN을 설정하는 것을 의미합니다( struct utsname의 nodename 필드). Windows 컨테이너에서 레지스트리 키 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters의 레지스트리 값을 FQDN으로 설정하는 것을 의미합니다. Pod에 FQDN이 없는 경우 적용되지 않습니다. 기본값은 false입니다.

shareProcessNamespace

boolean

Pod의 모든 컨테이너 간에 단일 프로세스 네임스페이스를 공유합니다. 컨테이너를 설정하면 동일한 포드에 있는 다른 컨테이너의 프로세스를 보고 신호할 수 있으며 각 컨테이너의 첫 번째 프로세스에 PID 1이 할당되지 않습니다. HostPID 및 ShareProcessNamespace는 둘 다 설정할 수 없습니다. 선택 사항: 기본값은 false입니다.

하위 도메인

string

지정된 경우 정규화된 Pod 호스트 이름은 "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>"입니다. 지정하지 않으면 Pod에 도메인 이름이 전혀 없습니다.

terminationGracePeriodSeconds

integer

Pod가 정상적으로 종료되어야 하는 시간(초)입니다. 삭제 요청으로 줄어들 수 있습니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 이 값이 nil이면 기본 유예 기간이 대신 사용됩니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 기본값은 30초입니다.

허용 오차

array

지정된 경우 Pod의 허용 오차입니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

topologySpreadConstraints

array

TopologySpreadConstraints는 Pod 그룹이 토폴로지 도메인에 분산되는 방법을 설명합니다. 스케줄러는 제약 조건에 따라 비활성화되는 방식으로 Pod를 예약합니다. 모든 topologySpreadConstraints는 ANDed입니다.

topologySpreadConstraints[]

object

TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.

volumes

array

Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다.

14.1.2. .spec.affinity

설명
유사성은 선호도 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

nodeAffinity

object

노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다.

podAffinity

object

Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다.

podAntiAffinity

object

Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다.

14.1.3. .spec.affinity.nodeAffinity

설명
노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.

requiredDuringSchedulingIgnoredDuringExecution

object

노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.

14.1.4. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.
유형
array

14.1.5. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.
유형
object
필수 항목
  • weight
  • preference
속성유형설명

preference

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

weight

integer

1-100 범위의 해당 nodeSelectorTerm과 일치하는 가중치입니다.

14.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

14.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.9. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.10. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
유형
object
필수 항목
  • nodeSelectorTerms
속성유형설명

nodeSelectorTerms

array

필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.

nodeSelectorTerms[]

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

14.1.12. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms

설명
필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.
유형
array

14.1.13. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

14.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.16. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

14.1.17. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

14.1.18. .spec.affinity.podAffinity

설명
Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

14.1.19. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

14.1.20. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • weight
  • podAffinityTerm
속성유형설명

podAffinityTerm

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

14.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.22. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

14.1.23. .spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.24. .spec.affinity.podAntiAffinity

설명
Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

14.1.25. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

14.1.26. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • weight
  • podAffinityTerm
속성유형설명

podAffinityTerm

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

14.1.27. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.28. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

14.1.29. .spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • topologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

topologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

14.1.30. .spec.containers

설명
Pod에 속하는 컨테이너 목록입니다. 컨테이너는 현재 추가 또는 제거할 수 없습니다. Pod에는 하나 이상의 컨테이너가 있어야 합니다. CamelCase로
유형
array

14.1.31. .spec.containers[]

설명
Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.
유형
object
필수 항목
  • name
속성유형설명

args

배열(문자열)

진입점에 대한 인수입니다. 컨테이너 이미지의 CMD는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

command

배열(문자열)

ENTRYPOINT 배열. 쉘 내에서 실행되지 않습니다. 컨테이너 이미지의 ENTRYPOINT는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array

컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

envFrom

array

컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로

envFrom[]

object

EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.

image

string

컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다.

imagePullPolicy

string

이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images

가능한 열거 값: - "항상" 은 kubelet이 항상 최신 이미지를 가져오려고 시도한다는 것을 의미합니다. 가져오기에 실패하면 컨테이너가 실패합니다. - "IfNotPresent" 는 이미지가 디스크에 없는 경우 kubelet을 가져오는 것을 의미합니다. 이미지가 존재하지 않고 가져오기에 실패하면 컨테이너가 실패합니다. - "없음" 은 kubelet이 이미지를 가져오지 않지만 로컬 이미지만 사용한다는 것을 의미합니다. 이미지가 없으면 컨테이너가 실패합니다.

lifecycle

object

라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.

livenessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

name

string

DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로

포트

array

컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로

ports[]

object

containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.

readinessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

securityContext

object

securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.

startupProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

stdin

boolean

이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다.

stdinOnce

boolean

컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다.

terminationMessagePath

string

선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로

terminationMessagePolicy

string

종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로

가능한 enum 값: - "FallbackToLogsOnError" 는 컨테이너가 오류와 함께 종료되면 컨테이너 상태 메시지에 대한 컨테이너 로그의 최신 내용을 읽습니다. - "File" 은 기본 동작이며 컨테이너가 종료될 때 컨테이너의 terminationMessagePath의 콘텐츠로 컨테이너 상태 메시지를 설정합니다.

tty

boolean

이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다.

volumeDevices

array

volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.

volumeDevices[]

object

volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.

volumeMounts

array

컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로

volumeMounts[]

object

volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.

workingDir

string

컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로

14.1.32. .spec.containers[].env

설명
컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
유형
array

14.1.33. .spec.containers[].env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

EnvVarSource는 EnvVar 값의 소스를 나타냅니다.

14.1.34. .spec.containers[].env[].valueFrom

설명
EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap에서 키를 선택합니다.

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

secretKeyRef

object

SecretKeySelector는 시크릿의 키를 선택합니다.

14.1.35. .spec.containers[].env[].valueFrom.configMapKeyRef

설명
ConfigMap에서 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.36. .spec.containers[].env[].valueFrom.fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

14.1.37. .spec.containers[].env[].valueFrom.resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

14.1.38. .spec.containers[].env[].valueFrom.secretKeyRef

설명
SecretKeySelector는 시크릿의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.39. .spec.containers[].envFrom

설명
컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
유형
array

14.1.40. .spec.containers[].envFrom[]

설명
EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
유형
object
속성유형설명

configMapRef

object

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

접두사

string

ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다.

secretRef

object

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

14.1.41. .spec.containers[].envFrom[].configMapRef

설명

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap을 정의해야 하는지 여부를 지정

14.1.42. .spec.containers[].envFrom[].secretRef

설명

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

보안을 정의해야 하는지 여부를 지정합니다.

14.1.43. .spec.containers[].lifecycle

설명
라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
유형
object
속성유형설명

postStart

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

preStop

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

14.1.44. .spec.containers[].lifecycle.postStart

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

14.1.45. .spec.containers[].lifecycle.postStart.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.46. .spec.containers[].lifecycle.postStart.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.47. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.48. .spec.containers[].lifecycle.postStart.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.49. .spec.containers[].lifecycle.postStart.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.50. .spec.containers[].lifecycle.preStop

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

14.1.51. .spec.containers[].lifecycle.preStop.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.52. .spec.containers[].lifecycle.preStop.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.53. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.54. .spec.containers[].lifecycle.preStop.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.55. .spec.containers[].lifecycle.preStop.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.56. .spec.containers[].livenessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.57. .spec.containers[].livenessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.58. .spec.containers[].livenessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.59. .spec.containers[].livenessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.60. .spec.containers[].livenessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.61. .spec.containers[].livenessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.62. .spec.containers[].livenessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.63. .spec.containers[].ports

설명
컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로
유형
array

14.1.64. .spec.containers[].ports[]

설명
containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
유형
object
필수 항목
  • containerPort
속성유형설명

containerPort

integer

Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다.

hostIP

string

외부 포트를 바인딩할 호스트 IP는 무엇입니까.

hostPort

integer

호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다.

name

string

지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다.

프로토콜

string

포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

14.1.65. .spec.containers[].readinessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.66. .spec.containers[].readinessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.67. .spec.containers[].readinessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.68. .spec.containers[].readinessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.69. .spec.containers[].readinessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.70. .spec.containers[].readinessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.71. .spec.containers[].readinessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.72. .spec.containers[].resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

14.1.73. .spec.containers[].securityContext

설명
securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
유형
object
속성유형설명

allowPrivilegeEscalation

boolean

allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

capabilities

object

실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.

privileged

boolean

권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

procMount

string

procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

readOnlyRootFilesystem

boolean

이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

14.1.74. .spec.containers[].securityContext.capabilities

설명
실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
유형
object
속성유형설명

add

배열(문자열)

추가 기능

drop

배열(문자열)

제거된 기능

14.1.75. .spec.containers[].securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

14.1.76. .spec.containers[].securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

14.1.77. .spec.containers[].securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

14.1.78. .spec.containers[].startupProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.79. .spec.containers[].startupProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.80. .spec.containers[].startupProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.81. .spec.containers[].startupProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.82. .spec.containers[].startupProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.83. .spec.containers[].startupProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.84. .spec.containers[].startupProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.85. .spec.containers[].volumeDevices

설명
volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.
유형
array

14.1.86. .spec.containers[].volumeDevices[]

설명
volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.
유형
object
필수 항목
  • name
  • devicePath
속성유형설명

devicePath

string

devicePath는 장치를 매핑할 컨테이너 내부의 경로입니다.

name

string

name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다

14.1.87. .spec.containers[].volumeMounts

설명
컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로
유형
array

14.1.88. .spec.containers[].volumeMounts[]

설명
volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • name
  • mountPath
속성유형설명

mountPath

string

볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다.

mountPropagation

string

mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다.

name

string

이는 볼륨 이름과 일치해야 합니다.

readOnly

boolean

true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다.

subPath

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

subPathExpr

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다.

14.1.89. .spec.dnsConfig

설명
PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다.
유형
object
속성유형설명

네임서버

배열(문자열)

DNS 이름 서버 IP 주소 목록입니다. DNSPolicy에서 생성된 기본 이름 서버에 추가됩니다. 중복된 네임서버가 제거됩니다.

options

array

DNS 확인자 옵션 목록입니다. 이는 DNSPolicy에서 생성된 기본 옵션과 병합됩니다. 중복된 항목이 제거됩니다. 옵션에 제공된 해결 옵션은 기본 DNSPolicy에 표시되는 옵션을 재정의합니다.

options[]

object

PodDNSConfigOption은 Pod의 DNS 확인자 옵션을 정의합니다.

검색

배열(문자열)

호스트 이름 조회를 위한 DNS 검색 도메인 목록입니다. DNSPolicy에서 생성된 기본 검색 경로에 추가됩니다. 중복된 검색 경로가 제거됩니다.

14.1.90. .spec.dnsConfig.options

설명
DNS 확인자 옵션 목록입니다. 이는 DNSPolicy에서 생성된 기본 옵션과 병합됩니다. 중복된 항목이 제거됩니다. 옵션에 제공된 해결 옵션은 기본 DNSPolicy에 표시되는 옵션을 재정의합니다.
유형
array

14.1.91. .spec.dnsConfig.options[]

설명
PodDNSConfigOption은 Pod의 DNS 확인자 옵션을 정의합니다.
유형
object
속성유형설명

name

string

필수 항목입니다.

value

string

 

14.1.92. .spec.ephemeralContainers

설명
이 Pod에서 실행되는 임시 컨테이너 목록입니다. 임시 컨테이너는 기존 Pod에서 실행하여 디버깅과 같은 사용자 시작 작업을 수행할 수 있습니다. 이 목록은 Pod를 생성할 때 지정할 수 없으며 Pod 사양을 업데이트하여 수정할 수 없습니다. 기존 포드에 임시 컨테이너를 추가하려면 Pod의 ephemeralcontainers 하위 리소스를 사용합니다.
유형
array

14.1.93. .spec.ephemeralContainers[]

설명

EphemeralContainer는 디버깅과 같은 사용자 시작 활동을 위해 기존 Pod에 추가할 수 있는 임시 컨테이너입니다. 임시 컨테이너에는 리소스 또는 스케줄링 보장이 없으며 Pod가 종료되거나 Pod를 다시 시작할 때 재시작되지 않습니다. 임시 컨테이너에서 Pod가 리소스 할당을 초과하는 경우 kubelet에서 Pod를 제거할 수 있습니다.

임시 컨테이너를 추가하려면 기존 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. 임시 컨테이너는 제거하거나 다시 시작할 수 없습니다.

유형
object
필수 항목
  • name
속성유형설명

args

배열(문자열)

진입점에 대한 인수입니다. 이미지의 CMD는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

command

배열(문자열)

ENTRYPOINT 배열. 쉘 내에서 실행되지 않습니다. 이미지의 ENTRYPOINT는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array

컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

envFrom

array

컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로

envFrom[]

object

EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.

image

string

컨테이너 이미지 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images

imagePullPolicy

string

이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images

가능한 열거 값: - "항상" 은 kubelet이 항상 최신 이미지를 가져오려고 시도한다는 것을 의미합니다. 가져오기에 실패하면 컨테이너가 실패합니다. - "IfNotPresent" 는 이미지가 디스크에 없는 경우 kubelet을 가져오는 것을 의미합니다. 이미지가 존재하지 않고 가져오기에 실패하면 컨테이너가 실패합니다. - "없음" 은 kubelet이 이미지를 가져오지 않지만 로컬 이미지만 사용한다는 것을 의미합니다. 이미지가 없으면 컨테이너가 실패합니다.

lifecycle

object

라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.

livenessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

name

string

DNS_LABEL로 지정된 임시 컨테이너의 이름입니다. 이 이름은 모든 컨테이너, init 컨테이너 및 임시 컨테이너에서 고유해야 합니다.

포트

array

임시 컨테이너에는 포트가 허용되지 않습니다.

ports[]

object

containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.

readinessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

securityContext

object

securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.

startupProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

stdin

boolean

이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다.

stdinOnce

boolean

컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다.

targetContainerName

string

설정된 경우 PodSpec의 컨테이너 이름이 이 임시 컨테이너를 대상으로 합니다. 임시 컨테이너는 이 컨테이너의 네임스페이스(IPC, PID 등)에서 실행됩니다. 설정되지 않은 경우 임시 컨테이너는 Pod 사양에 구성된 네임스페이스를 사용합니다.

컨테이너 런타임은 이 기능에 대한 지원을 구현해야 합니다. 런타임에서 네임스페이스 대상 지정을 지원하지 않으면 이 필드를 설정한 결과는 정의되지 않습니다.

terminationMessagePath

string

선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로

terminationMessagePolicy

string

종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로

가능한 enum 값: - "FallbackToLogsOnError" 는 컨테이너가 오류와 함께 종료되면 컨테이너 상태 메시지에 대한 컨테이너 로그의 최신 내용을 읽습니다. - "File" 은 기본 동작이며 컨테이너가 종료될 때 컨테이너의 terminationMessagePath의 콘텐츠로 컨테이너 상태 메시지를 설정합니다.

tty

boolean

이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다.

volumeDevices

array

volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.

volumeDevices[]

object

volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.

volumeMounts

array

컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로

volumeMounts[]

object

volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.

workingDir

string

컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로

14.1.94. .spec.ephemeralContainers[].env

설명
컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
유형
array

14.1.95. .spec.ephemeralContainers[].env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

EnvVarSource는 EnvVar 값의 소스를 나타냅니다.

14.1.96. .spec.ephemeralContainers[].env[].valueFrom

설명
EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap에서 키를 선택합니다.

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

secretKeyRef

object

SecretKeySelector는 시크릿의 키를 선택합니다.

14.1.97. .spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef

설명
ConfigMap에서 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.98. .spec.ephemeralContainers[].env[].valueFrom.fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

14.1.99. .spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

14.1.100. .spec.ephemeralContainers[].env[].valueFrom.secretKeyRef

설명
SecretKeySelector는 시크릿의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.101. .spec.ephemeralContainers[].envFrom

설명
컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
유형
array

14.1.102. .spec.ephemeralContainers[].envFrom[]

설명
EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
유형
object
속성유형설명

configMapRef

object

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

접두사

string

ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다.

secretRef

object

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

14.1.103. .spec.ephemeralContainers[].envFrom[].configMapRef

설명

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap을 정의해야 하는지 여부를 지정

14.1.104. .spec.ephemeralContainers[].envFrom[].secretRef

설명

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

보안을 정의해야 하는지 여부를 지정합니다.

14.1.105. .spec.ephemeralContainers[].lifecycle

설명
라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
유형
object
속성유형설명

postStart

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

preStop

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

14.1.106. .spec.ephemeralContainers[].lifecycle.postStart

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

14.1.107. .spec.ephemeralContainers[].lifecycle.postStart.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.108. .spec.ephemeralContainers[].lifecycle.postStart.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.109. .spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.110. .spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.111. .spec.ephemeralContainers[].lifecycle.postStart.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.112. .spec.ephemeralContainers[].lifecycle.preStop

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

14.1.113. .spec.ephemeralContainers[].lifecycle.preStop.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.114. .spec.ephemeralContainers[].lifecycle.preStop.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.115. .spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.116. .spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.117. .spec.ephemeralContainers[].lifecycle.preStop.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.118. .spec.ephemeralContainers[].livenessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.119. .spec.ephemeralContainers[].livenessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.120. .spec.ephemeralContainers[].livenessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.121. .spec.ephemeralContainers[].livenessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.122. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.123. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.124. .spec.ephemeralContainers[].livenessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.125. .spec.ephemeralContainers[].ports

설명
임시 컨테이너에는 포트가 허용되지 않습니다.
유형
array

14.1.126. .spec.ephemeralContainers[].ports[]

설명
containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
유형
object
필수 항목
  • containerPort
속성유형설명

containerPort

integer

Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다.

hostIP

string

외부 포트를 바인딩할 호스트 IP는 무엇입니까.

hostPort

integer

호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다.

name

string

지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다.

프로토콜

string

포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

14.1.127. .spec.ephemeralContainers[].readinessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.128. .spec.ephemeralContainers[].readinessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.129. .spec.ephemeralContainers[].readinessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.130. .spec.ephemeralContainers[].readinessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.131. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.132. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.133. .spec.ephemeralContainers[].readinessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.134. .spec.ephemeralContainers[].resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

14.1.135. .spec.ephemeralContainers[].securityContext

설명
securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
유형
object
속성유형설명

allowPrivilegeEscalation

boolean

allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

capabilities

object

실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.

privileged

boolean

권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

procMount

string

procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

readOnlyRootFilesystem

boolean

이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

14.1.136. .spec.ephemeralContainers[].securityContext.capabilities

설명
실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
유형
object
속성유형설명

add

배열(문자열)

추가 기능

drop

배열(문자열)

제거된 기능

14.1.137. .spec.ephemeralContainers[].securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

14.1.138. .spec.ephemeralContainers[].securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

14.1.139. .spec.ephemeralContainers[].securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

14.1.140. .spec.ephemeralContainers[].startupProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.141. .spec.ephemeralContainers[].startupProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.142. .spec.ephemeralContainers[].startupProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.143. .spec.ephemeralContainers[].startupProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.144. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.145. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.146. .spec.ephemeralContainers[].startupProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.147. .spec.ephemeralContainers[].volumeDevices

설명
volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.
유형
array

14.1.148. .spec.ephemeralContainers[].volumeDevices[]

설명
volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.
유형
object
필수 항목
  • name
  • devicePath
속성유형설명

devicePath

string

devicePath는 장치를 매핑할 컨테이너 내부의 경로입니다.

name

string

name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다

14.1.149. .spec.ephemeralContainers[].volumeMounts

설명
컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로
유형
array

14.1.150. .spec.ephemeralContainers[].volumeMounts[]

설명
volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • name
  • mountPath
속성유형설명

mountPath

string

볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다.

mountPropagation

string

mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다.

name

string

이는 볼륨 이름과 일치해야 합니다.

readOnly

boolean

true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다.

subPath

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

subPathExpr

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다.

14.1.151. .spec.hostAliases

설명
hostAliases는 지정된 경우 Pod의 호스트 파일에 삽입될 호스트 및 IP의 선택적 목록입니다. 이는 non-hostNetwork Pod에만 유효합니다.
유형
array

14.1.152. .spec.hostAliases[]

설명
HostAlias는 Pod의 호스트 파일에 항목으로 삽입될 IP와 호스트 이름 간의 매핑을 보유합니다.
유형
object
속성유형설명

호스트 이름

배열(문자열)

위 IP 주소에 대한 호스트 이름입니다.

ip

string

호스트 파일 항목의 IP 주소입니다.

14.1.153. .spec.imagePullSecrets

설명
imagePullSecrets는 이 PodSpec에서 사용하는 이미지를 가져오는 데 사용할 동일한 네임스페이스의 시크릿에 대한 선택적 참조 목록입니다. 지정된 경우 이러한 시크릿은 사용할 수 있도록 개별 풀러 구현으로 전달됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
유형
array

14.1.154. .spec.imagePullSecrets[]

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.155. .spec.initContainers

설명
Pod에 속하는 초기화 컨테이너 목록입니다. Init 컨테이너는 컨테이너가 시작되기 전에 실행됩니다. init 컨테이너가 실패하면 Pod가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너에서 고유해야 합니다. Init 컨테이너에는 Lifecycle 작업, 준비 상태 프로브, 활성 상태 프로브 또는 시작 프로브가 없을 수 있습니다. init 컨테이너의 resourceRequirements는 각 리소스 유형에 대해 가장 높은 요청/제한을 찾은 다음 해당 값의 최대값 또는 일반 컨테이너의 합계를 사용하여 스케줄링 중에 고려됩니다. 제한은 init 컨테이너에 유사한 방식으로 적용됩니다. init 컨테이너는 현재 추가 또는 제거할 수 없습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
유형
array

14.1.156. .spec.initContainers[]

설명
Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.
유형
object
필수 항목
  • name
속성유형설명

args

배열(문자열)

진입점에 대한 인수입니다. 컨테이너 이미지의 CMD는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

command

배열(문자열)

ENTRYPOINT 배열. 쉘 내에서 실행되지 않습니다. 컨테이너 이미지의 ENTRYPOINT는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array

컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

envFrom

array

컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로

envFrom[]

object

EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.

image

string

컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다.

imagePullPolicy

string

이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images

가능한 열거 값: - "항상" 은 kubelet이 항상 최신 이미지를 가져오려고 시도한다는 것을 의미합니다. 가져오기에 실패하면 컨테이너가 실패합니다. - "IfNotPresent" 는 이미지가 디스크에 없는 경우 kubelet을 가져오는 것을 의미합니다. 이미지가 존재하지 않고 가져오기에 실패하면 컨테이너가 실패합니다. - "없음" 은 kubelet이 이미지를 가져오지 않지만 로컬 이미지만 사용한다는 것을 의미합니다. 이미지가 없으면 컨테이너가 실패합니다.

lifecycle

object

라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.

livenessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

name

string

DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로

포트

array

컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로

ports[]

object

containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.

readinessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

securityContext

object

securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.

startupProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

stdin

boolean

이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다.

stdinOnce

boolean

컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다.

terminationMessagePath

string

선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로

terminationMessagePolicy

string

종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로

가능한 enum 값: - "FallbackToLogsOnError" 는 컨테이너가 오류와 함께 종료되면 컨테이너 상태 메시지에 대한 컨테이너 로그의 최신 내용을 읽습니다. - "File" 은 기본 동작이며 컨테이너가 종료될 때 컨테이너의 terminationMessagePath의 콘텐츠로 컨테이너 상태 메시지를 설정합니다.

tty

boolean

이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다.

volumeDevices

array

volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.

volumeDevices[]

object

volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.

volumeMounts

array

컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로

volumeMounts[]

object

volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.

workingDir

string

컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로

14.1.157. .spec.initContainers[].env

설명
컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
유형
array

14.1.158. .spec.initContainers[].env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

EnvVarSource는 EnvVar 값의 소스를 나타냅니다.

14.1.159. .spec.initContainers[].env[].valueFrom

설명
EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap에서 키를 선택합니다.

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

secretKeyRef

object

SecretKeySelector는 시크릿의 키를 선택합니다.

14.1.160. .spec.initContainers[].env[].valueFrom.configMapKeyRef

설명
ConfigMap에서 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.161. .spec.initContainers[].env[].valueFrom.fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

14.1.162. .spec.initContainers[].env[].valueFrom.resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

14.1.163. .spec.initContainers[].env[].valueFrom.secretKeyRef

설명
SecretKeySelector는 시크릿의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.164. .spec.initContainers[].envFrom

설명
컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
유형
array

14.1.165. .spec.initContainers[].envFrom[]

설명
EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
유형
object
속성유형설명

configMapRef

object

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

접두사

string

ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다.

secretRef

object

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

14.1.166. .spec.initContainers[].envFrom[].configMapRef

설명

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap을 정의해야 하는지 여부를 지정

14.1.167. .spec.initContainers[].envFrom[].secretRef

설명

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

보안을 정의해야 하는지 여부를 지정합니다.

14.1.168. .spec.initContainers[].lifecycle

설명
라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
유형
object
속성유형설명

postStart

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

preStop

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

14.1.169. .spec.initContainers[].lifecycle.postStart

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

14.1.170. .spec.initContainers[].lifecycle.postStart.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.171. .spec.initContainers[].lifecycle.postStart.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.172. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.173. .spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.174. .spec.initContainers[].lifecycle.postStart.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.175. .spec.initContainers[].lifecycle.preStop

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

14.1.176. .spec.initContainers[].lifecycle.preStop.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.177. .spec.initContainers[].lifecycle.preStop.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.178. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.179. .spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.180. .spec.initContainers[].lifecycle.preStop.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.181. .spec.initContainers[].livenessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.182. .spec.initContainers[].livenessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.183. .spec.initContainers[].livenessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.184. .spec.initContainers[].livenessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.185. .spec.initContainers[].livenessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.186. .spec.initContainers[].livenessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.187. .spec.initContainers[].livenessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.188. .spec.initContainers[].ports

설명
컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로
유형
array

14.1.189. .spec.initContainers[].ports[]

설명
containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
유형
object
필수 항목
  • containerPort
속성유형설명

containerPort

integer

Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다.

hostIP

string

외부 포트를 바인딩할 호스트 IP는 무엇입니까.

hostPort

integer

호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다.

name

string

지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다.

프로토콜

string

포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

14.1.190. .spec.initContainers[].readinessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.191. .spec.initContainers[].readinessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.192. .spec.initContainers[].readinessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.193. .spec.initContainers[].readinessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.194. .spec.initContainers[].readinessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.195. .spec.initContainers[].readinessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.196. .spec.initContainers[].readinessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.197. .spec.initContainers[].resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

14.1.198. .spec.initContainers[].securityContext

설명
securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
유형
object
속성유형설명

allowPrivilegeEscalation

boolean

allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

capabilities

object

실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.

privileged

boolean

권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

procMount

string

procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

readOnlyRootFilesystem

boolean

이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

14.1.199. .spec.initContainers[].securityContext.capabilities

설명
실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
유형
object
속성유형설명

add

배열(문자열)

추가 기능

drop

배열(문자열)

제거된 기능

14.1.200. .spec.initContainers[].securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

14.1.201. .spec.initContainers[].securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

14.1.202. .spec.initContainers[].securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

14.1.203. .spec.initContainers[].startupProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

14.1.204. .spec.initContainers[].startupProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

14.1.205. .spec.initContainers[].startupProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

14.1.206. .spec.initContainers[].startupProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

14.1.207. .spec.initContainers[].startupProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

14.1.208. .spec.initContainers[].startupProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

14.1.209. .spec.initContainers[].startupProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

14.1.210. .spec.initContainers[].volumeDevices

설명
volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.
유형
array

14.1.211. .spec.initContainers[].volumeDevices[]

설명
volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.
유형
object
필수 항목
  • name
  • devicePath
속성유형설명

devicePath

string

devicePath는 장치를 매핑할 컨테이너 내부의 경로입니다.

name

string

name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다

14.1.212. .spec.initContainers[].volumeMounts

설명
컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로
유형
array

14.1.213. .spec.initContainers[].volumeMounts[]

설명
volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • name
  • mountPath
속성유형설명

mountPath

string

볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다.

mountPropagation

string

mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다.

name

string

이는 볼륨 이름과 일치해야 합니다.

readOnly

boolean

true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다.

subPath

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

subPathExpr

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다.

14.1.214. .spec.os

설명
PodOS는 Pod의 OS 매개변수를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

운영 체제의 이름입니다.Is the name of the operating system. 현재 지원되는 값은 linux 및 windows입니다. 추가 값은 나중에 정의할 수 있으며 다음 중 하나일 수 있습니다. https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration 클라이언트는 추가 값을 처리하고 이 필드의 인식되지 않은 값을 os: null로 처리해야 합니다.

14.1.215. .spec.readinessGates

설명
지정하면 Pod 준비 상태에 대한 모든 준비 상태 게이트가 평가됩니다. 모든 컨테이너가 준비되고 준비 게이트에 지정된 모든 조건이 "True" 추가 정보와 같은 상태가 있는 경우 Pod가 준비됩니다. https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
유형
array

14.1.216. .spec.readinessGates[]

설명
PodReadinessGate에는 Pod 상태에 대한 참조가 포함되어 있습니다.
유형
object
필수 항목
  • conditionType
속성유형설명

conditionType

string

conditionType은 일치하는 유형이 있는 Pod의 조건 목록의 조건을 나타냅니다.

14.1.217. .spec.securityContext

설명
PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다.
유형
object
속성유형설명

fsGroup

integer

Pod의 모든 컨테이너에 적용되는 특수 추가 그룹입니다. 일부 볼륨 유형을 사용하면 Kubelet에서 해당 볼륨의 소유권을 Pod에서 소유하도록 변경할 수 있습니다.

1. GID를 소유하는 것은 FSGroup 2가 됩니다. setgid 비트가 설정되어 있습니다(볼륨에서 생성된 새 파일은 FSGroup에 의해 소유됨) 3. 권한 비트는 rw-rw----를 사용하여 또는d입니다.

설정되지 않은 경우 Kubelet은 볼륨의 소유권 및 권한을 수정하지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

fsGroupChangePolicy

string

fsGroupChangePolicy는 Pod 내부에서 노출되기 전에 볼륨의 소유권 및 권한 변경 동작을 정의합니다. 이 필드는 fsGroup 기반 소유권 및 권한을 지원하는 볼륨 유형에만 적용됩니다. secret, configmaps 및 emptydir과 같은 임시 볼륨 유형에는 영향을 미치지 않습니다. 유효한 값은 "OnRootMismatch" 및 "Always"입니다. 지정하지 않으면 "항상"이 사용됩니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

supplementalGroups

배열(정수)

컨테이너의 기본 GID 외에도 각 컨테이너에서 첫 번째 프로세스에 적용되는 그룹 목록입니다. 지정되지 않은 경우 컨테이너에 그룹이 추가되지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

sysctls

array

sysctl에는 Pod에 사용되는 네임스페이스가 지정된 sysctl 목록이 있습니다. 지원되지 않는 sysctl이 있는 Pod(컨테이너 런타임별)가 시작되지 않을 수 있습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

sysctls[]

object

sysctl은 설정할 커널 매개변수를 정의합니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

14.1.218. .spec.securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

14.1.219. .spec.securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

14.1.220. .spec.securityContext.sysctls

설명
sysctl에는 Pod에 사용되는 네임스페이스가 지정된 sysctl 목록이 있습니다. 지원되지 않는 sysctl이 있는 Pod(컨테이너 런타임별)가 시작되지 않을 수 있습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.
유형
array

14.1.221. .spec.securityContext.sysctls[]

설명
sysctl은 설정할 커널 매개변수를 정의합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

설정할 속성의 이름

value

string

설정할 속성의 값

14.1.222. .spec.securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

14.1.223. .spec.tolerations

설명
지정된 경우 Pod의 허용 오차입니다.
유형
array

14.1.224. .spec.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

가능한 enum 값: - "NoExecute" 테인트를 허용하지 않는 이미 실행 중인 Pod를 제거합니다. 현재 NodeController에서 강제 적용합니다. - "NoSchedule" 은 테인트를 허용하지 않는 한 새 pod를 노드에 예약할 수 없지만 스케줄러를 거치지 않고 Kubelet에 제출한 모든 Pod를 허용하고 이미 실행 중인 모든 Pod가 계속 실행되도록 허용합니다. 스케줄러에 의해 시행됩니다. - "PreferNoSchedule" TaintEffectNoSchedule과 같은 TaintEffectNoSchedule이지만 스케줄러는 새 Pod를 노드에 완전히 예약하지 않고 노드에 새 Pod를 예약하지 않습니다. 스케줄러에 의해 적용됩니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

가능한 열거 값: - "Equal" - "Exists"

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

14.1.225. .spec.topologySpreadConstraints

설명
TopologySpreadConstraints는 Pod 그룹이 토폴로지 도메인에 분산되는 방법을 설명합니다. 스케줄러는 제약 조건에 따라 비활성화되는 방식으로 Pod를 예약합니다. 모든 topologySpreadConstraints는 ANDed입니다.
유형
array

14.1.226. .spec.topologySpreadConstraints[]

설명
TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.
유형
object
필수 항목
  • maxSkew
  • topologyKey
  • whenUnsatisfiable
속성유형설명

labelSelector

LabelSelector

labelSelector는 일치하는 포드를 찾는 데 사용됩니다. 이 라벨 선택기와 일치하는 Pod는 해당 토폴로지 도메인의 Pod 수를 확인하기 위해 계산됩니다.

matchLabelKeys

배열(문자열)

MatchLabelKeys는 분배를 계산할 Pod를 선택하는 Pod 레이블 키 집합입니다. 키는 들어오는 Pod 라벨에서 값을 조회하는 데 사용되며, 해당 키-값 레이블은 labelSelector와 함께 사용되어 들어오는 포드에 대해 분산이 계산될 기존 포드 그룹을 선택합니다. 들어오는 Pod 라벨에 없는 키는 무시됩니다. null 또는 빈 목록은 labelSelector와만 일치함을 의미합니다.

maxSkew

integer

MaxSkew는 Pod를 균등하게 배포할 수 있는 정도를 설명합니다. whenUnsatisfiable=DoNotSchedule 에서는 대상 토폴로지에서 일치하는 Pod 수와 글로벌 최소값 간에 허용되는 최대 차이입니다. 글로벌 최소는 적격 도메인의 일치하는 최소 Pod 수 또는 적격 도메인 수가 MinDomains보다 작은 경우 0입니다. 예를 들어 3 영역 클러스터에서 MaxSkew는 1로 설정되고 labelSelector가 2/2/1과 동일한 Pod가 있습니다. 이 경우 글로벌 최소값은 1입니다. | zone1 | zone2 | zone2 | zone3 | | P | P | - MaxSkew가 1이면 들어오는 Pod를 2/2/2가 되도록 영역3으로 예약할 수 있습니다. zone1(zone2)에 예약하면 zone1(zone2)이 MaxSkew(1)를 위반하면 최대Skew(1)를 위반할 수 있습니다. - 최대Skew(1)를 위반하면 최대Skew(1)를 예약할 수 있습니다. whenUnsatisfiable=ScheduleAnyway 는 이를 충족하는 토폴로지에 더 높은 우선 순위를 부여하는 데 사용됩니다. 필수 필드입니다. 기본값은 1이고 0은 허용되지 않습니다.

minDomains

integer

MinDomains는 적격 도메인의 최소 수를 나타냅니다. 토폴로지 키가 일치하는 적격 도메인의 수가 minDomains보다 작으면 Pod Topology Spread가 "global minimum"을 0으로 처리한 다음 Skew 계산을 수행합니다. 그리고 토폴로지 키가 일치하는 적격 도메인의 수가 minDomains보다 크거나 같으면 이 값은 예약에 영향을 미치지 않습니다. 결과적으로 적격 도메인의 수가 minDomains보다 작으면 스케줄러는 해당 도메인에 maxSkew Pod 이상을 예약하지 않습니다. value가 nil인 경우 제약 조건은 MinDomains가 1인 것처럼 작동합니다. 유효한 값은 0보다 큰 정수입니다. 값이 nil이 아닌 경우 WhenUnsatisfiable은 DoNotSchedule이어야 합니다.

예를 들어 3 영역 클러스터에서 MaxSkew는 2/2/2: | zone1 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | 5(MinDomains)로 처리되므로 "global minimum"은 0으로 설정됩니다. 이 경우 새 Pod가 세 영역으로 예약되는 경우 계산된 skew는 3(3 - 0)인 새 Pod를 예약할 수 없으므로 MaxSkew가 위반됩니다.

베타 필드이며 MinDomainsInPodTopologySpread 기능 게이트를 활성화해야 합니다(기본적으로 활성화).

nodeAffinityPolicy

string

NodeAffinityPolicy는 Pod 토폴로지 분배 skew를 계산할 때 Pod의 nodeAffinity/nodeSelector를 처리하는 방법을 나타냅니다. 옵션은: - Cryostat: nodeAffinity/nodeSelector와 일치하는 노드만 계산에 포함됩니다. - Ignore: nodeAffinity/nodeSelector는 무시됩니다. 모든 노드는 계산에 포함됩니다.

이 값이 nil인 경우 동작은 policy와 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다.

nodeTaintsPolicy

string

NodeTaintsPolicy는 Pod 토폴로지 분배 스큐를 계산할 때 노드 테인트를 처리하는 방법을 나타냅니다. 옵션은 다음과 같습니다: 테인트가 없는 노드와 함께 들어오는 Pod에 톨러레이션이 포함된 테인트 노드가 포함됩니다. - Ignore: 노드 테인트는 무시됩니다. 모든 노드가 포함됩니다.

이 값이 nil인 경우 동작은 Ignore 정책과 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다.

topologyKey

string

TopologyKey는 노드 라벨의 키입니다. 이 키와 동일한 값이 있는 라벨이 있는 노드는 동일한 토폴로지에 있는 것으로 간주됩니다. 각 <key, value>를 "bucket"으로 간주하고 각 버킷에 균형 있는 Pod 수를 배치하려고 합니다. 도메인을 토폴로지의 특정 인스턴스로 정의합니다. 또한 적격 도메인을 nodeAffinityPolicy 및 nodeTaintsPolicy의 요구 사항을 충족하는 도메인으로 정의합니다. 예를 들어 TopologyKey가 "kubernetes.io/hostname"인 경우 각 노드는 해당 토폴로지의 도메인입니다. 그리고 TopologyKey가 "topology.kubernetes.io/zone"인 경우 각 영역은 해당 토폴로지의 도메인입니다. 필수 필드입니다.

whenUnsatisfiable

string

whenUnsatisfiable은 spread 제약 조건을 충족하지 않는 경우 Pod를 처리하는 방법을 나타냅니다. - DoNotSchedule (default)은 스케줄러에 일정하지 않도록 지시합니다. - ScheduleAnyway는 모든 위치에서 Pod를 예약하도록 하지만 skew를 줄이는 데 도움이 되는 토폴로지에 더 높은 우선순위를 부여합니다. 제약 조건은 해당 Pod에 대한 가능한 모든 노드 할당이 일부 토폴로지에서 "MaxSkew"를 위반하는 경우에만 들어오는 Pod의 "Unsatisfiable"으로 간주됩니다. 예를 들어 3-zone 클러스터에서 MaxSkew는 1로 설정되고, 3/1/1: | zone1 | zone2 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | WhenUnsatisfiable이 설정된 경우, 들어오는 Pod는 zone2(zone3)로만 영역 2(zone3)로 설정되어 있고, 3/1/1: | zone1 | zone1 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | WhenUnsatisfiable이 DoNotSchedule으로 설정된 경우 들어오는 Pod는 zone2(zone3)로만 영역(zone3)으로 예약할 수 있습니다. 즉, 클러스터의 불균형을 여전히 조정할 수 있지만 스케줄러로 인해 더 많은 불균형이 발생하지 않습니다. 필수 필드입니다.

가능한 enum 값: - "DoNotSchedule" 은 제약 조건이 충족되지 않는 경우 Pod를 예약하지 않도록 스케줄러에 지시합니다. - "ScheduleAnyway" 는 제약 조건이 충족되지 않은 경우에도 스케줄러에 Pod를 예약하도록 지시합니다.

14.1.227. .spec.volumes

설명
Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
유형
array

14.1.228. .spec.volumes[]

설명
volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

awsElasticBlockStore

object

AWS의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

azureDisk

object

AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.

azureFile

object

AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.

cephfs

object

Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.

cinder

object

Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

configMap

object

ConfigMap을 볼륨에 조정합니다.

대상 ConfigMap의 Data 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. ConfigMap 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

csi

object

외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다.

downwardAPI

object

DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다.

emptyDir

object

Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

임시

object

일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다.

fc

object

파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

flexVolume

object

FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다.

flocker

object

Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.

gcePersistentDisk

object

Google Compute Engine의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

gitRepo

object

git 리포지토리의 콘텐츠로 채워지는 볼륨을 나타냅니다. Git 리포지토리 볼륨은 소유권 관리를 지원하지 않습니다. Git 리포지터리 볼륨은 SELinux 레이블 재지정을 지원합니다.

DEPRECATED: GitRepo는 더 이상 사용되지 않습니다. Git 리포지토리를 사용하여 컨테이너를 프로비저닝하려면 git을 사용하여 리포지터리를 복제하는 EmptyDir을 EmptyContainer에 마운트한 다음 EmptyDir을 Pod의 컨테이너에 마운트합니다.

glusterfs

object

Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

hostPath

object

Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

iscsi

object

ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

name

string

볼륨의 이름입니다. DNS_LABEL이어야 하며 Pod 내에서 고유해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

nfs

object

Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

persistentVolumeClaim

object

PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다.

photonPersistentDisk

object

Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.

portworxVolume

object

PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.

예상됨

object

예상 볼륨 소스를 나타냅니다.

quobyte

object

Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

rbd

object

Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

scaleIO

object

scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.

Secret

object

시크릿을 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

storageos

object

StorageOS 영구 볼륨 리소스를 나타냅니다.

vsphereVolume

object

vSphere 볼륨 리소스를 나타냅니다.

14.1.229. .spec.volumes[].awsElasticBlockStore

설명

AWS의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

파티션

integer

partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음).

readOnly

boolean

readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

volumeID는 AWS(Amazon EBS 볼륨)의 영구 디스크 리소스의 고유 ID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

14.1.230. .spec.volumes[].azureDisk

설명
AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
유형
object
필수 항목
  • diskName
  • diskURI
속성유형설명

cachingMode

string

cachingMode는 Host Caching 모드입니다: None, Read Only, Read Write.

diskName

string

diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다.

diskURI

string

diskURI는 Blob 스토리지의 데이터 디스크 URI입니다.

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

kind

string

종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다.

readOnly

boolean

Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

14.1.231. .spec.volumes[].azureFile

설명
AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
유형
object
필수 항목
  • secretName
  • shareName
속성유형설명

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretName

string

secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다.

shareName

string

sharename은 azure share Name입니다.

14.1.232. .spec.volumes[].cephfs

설명
Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
유형
object
필수 항목
  • 모니터
속성유형설명

모니터

배열(문자열)

모니터는 필수 항목입니다. 모니터는 Ceph 모니터 모음입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

path는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다.

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

user

string

사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

14.1.233. .spec.volumes[].cephfs.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.234. .spec.volumes[].cinder

설명
Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

volumeID

string

cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md

14.1.235. .spec.volumes[].cinder.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.236. .spec.volumes[].configMap

설명

ConfigMap을 볼륨에 조정합니다.

대상 ConfigMap의 Data 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. ConfigMap 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
속성유형설명

defaultMode

integer

defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

items

array

지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

선택 사항: ConfigMap 또는 해당 키를 정의해야 하는지 여부 지정

14.1.237. .spec.volumes[].configMap.items

설명
지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

14.1.238. .spec.volumes[].configMap.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

14.1.239. .spec.volumes[].csi

설명
외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다.
유형
object
필수 항목
  • 드라이버
속성유형설명

드라이버

string

driver는 이 볼륨을 처리하는 CSI 드라이버의 이름입니다. 클러스터에 등록된 대로 올바른 이름은 관리자에게 문의하십시오.

fsType

string

마운트할 fstype. 예. "ext4", "xfs", "ntfs". 제공되지 않는 경우 빈 값은 적용할 기본 파일 시스템을 결정하는 연결된 CSI 드라이버에 전달됩니다.

nodePublishSecretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

readOnly

boolean

readonly는 볼륨에 대한 읽기 전용 구성을 지정합니다. 기본값은 false(읽기/쓰기)입니다.

volumeAttributes

오브젝트(문자열)

volumeAttributes는 CSI 드라이버로 전달되는 드라이버별 속성을 저장합니다. 지원되는 값은 드라이버 설명서를 참조하십시오.

14.1.240. .spec.volumes[].csi.nodePublishSecretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.241. .spec.volumes[].downwardAPI

설명
DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다.
유형
object
속성유형설명

defaultMode

integer

선택 사항: 기본적으로 생성된 파일에서 사용할 모드 비트입니다. 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 선택 사항: 모드 비트여야 합니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

items

array

items는 Downward API 볼륨 파일 목록입니다.

items[]

object

DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.

14.1.242. .spec.volumes[].downwardAPI.items

설명
items는 Downward API 볼륨 파일 목록입니다.
유형
array

14.1.243. .spec.volumes[].downwardAPI.items[]

설명
DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.
유형
object
필수 항목
  • path
속성유형설명

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

mode

integer

선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

14.1.244. .spec.volumes[].downwardAPI.items[].fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

14.1.245. .spec.volumes[].downwardAPI.items[].resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

14.1.246. .spec.volumes[].emptyDir

설명
Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
속성유형설명

중간

string

medium는 이 디렉터리를 백업해야 하는 스토리지 미디어 유형을 나타냅니다. 기본값은 ""이며 이는 노드의 기본 미디어를 사용하는 것을 의미합니다. 빈 문자열(기본값) 또는 메모리여야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

수량

sizeLimit은 이 EmptyDir 볼륨에 필요한 총 로컬 스토리지 양입니다. 크기 제한은 메모리 미디어에도 적용할 수 있습니다. 메모리 매체 EmptyDir의 최대 사용량은 여기에 지정된 SizeLimit와 Pod의 모든 컨테이너의 메모리 제한 합계 사이의 최소 값입니다. 기본값은 nil이며 이는 제한이 정의되지 않음을 의미합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/volumes#emptydir

14.1.247. .spec.volumes[].ephemeral

설명
일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다.
유형
object
속성유형설명

volumeClaimTemplate

object

PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다.

14.1.248. .spec.volumes[].ephemeral.volumeClaimTemplate

설명
PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다.
유형
object
필수 항목
  • spec
속성유형설명

메타데이터

ObjectMeta

해당 라벨을 생성할 때 PVC에 복사할 레이블 및 주석이 포함될 수 있습니다. 다른 필드는 허용되지 않으며 검증 중에 거부됩니다.

spec

object

PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.

14.1.249. .spec.volumes[].ephemeral.volumeClaimTemplate.spec

설명
PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.
유형
object
속성유형설명

accessModes

배열(문자열)

accessModes에는 볼륨에 필요한 액세스 모드가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

object

TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

dataSourceRef

object

TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

선택기

LabelSelector

selector는 바인딩에 대해 고려할 볼륨에 대한 레이블 쿼리입니다.

storageClassName

string

storageClassName은 클레임에 필요한 StorageClass의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

string

volumeMode는 클레임에 필요한 볼륨 유형을 정의합니다. claim 사양에 포함되지 않은 경우 Filesystem의 값이 포함됩니다.

volumeName

string

volumeName은 이 클레임을 지원하는 PersistentVolume에 대한 바인딩 참조입니다.

14.1.250. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource

설명
TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiGroup

string

APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.

kind

string

kind는 참조되는 리소스 유형입니다.

name

string

name은 참조되는 리소스의 이름입니다.

14.1.251. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef

설명
TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiGroup

string

APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.

kind

string

kind는 참조되는 리소스 유형입니다.

name

string

name은 참조되는 리소스의 이름입니다.

14.1.252. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

14.1.253. .spec.volumes[].fc

설명
파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

LUN

integer

LUN은 선택 사항입니다. FC 대상 lun 번호

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

targetWWNs

배열(문자열)

targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN)

wwids

배열(문자열)

WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다.

14.1.254. .spec.volumes[].flexVolume

설명
FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • 드라이버
속성유형설명

드라이버

string

driver는 이 볼륨에 사용할 드라이버의 이름입니다.

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다.

options

오브젝트(문자열)

옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다.

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

14.1.255. .spec.volumes[].flexVolume.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.256. .spec.volumes[].flocker

설명
Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
유형
object
속성유형설명

datasetName

string

DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다.

datasetUUID

string

datasetUUID는 데이터 세트의 UUID입니다. Flocker 데이터 세트의 고유 식별자입니다.

14.1.257. .spec.volumes[].gcePersistentDisk

설명

Google Compute Engine의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
필수 항목
  • pdName
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

파티션

integer

partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

string

pdName은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

14.1.258. .spec.volumes[].gitRepo

설명

git 리포지토리의 콘텐츠로 채워지는 볼륨을 나타냅니다. Git 리포지토리 볼륨은 소유권 관리를 지원하지 않습니다. Git 리포지터리 볼륨은 SELinux 레이블 재지정을 지원합니다.

DEPRECATED: GitRepo는 더 이상 사용되지 않습니다. Git 리포지토리를 사용하여 컨테이너를 프로비저닝하려면 git을 사용하여 리포지터리를 복제하는 EmptyDir을 EmptyContainer에 마운트한 다음 EmptyDir을 Pod의 컨테이너에 마운트합니다.

유형
object
필수 항목
  • 리포지토리
속성유형설명

디렉터리

string

디렉터리는 대상 디렉터리 이름입니다. 포함하거나 '..'로 시작하지 않아야 합니다. '.'가 제공되면 볼륨 디렉터리가 git 리포지토리가 됩니다. 지정하지 않으면 볼륨에 지정된 이름이 있는 하위 디렉터리에 git 리포지토리가 포함됩니다.

리포지토리

string

리포지터리는 URL입니다.

버전

string

개정 버전은 지정된 버전의 커밋 해시입니다.

14.1.259. .spec.volumes[].glusterfs

설명
Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • 끝점
  • path
속성유형설명

끝점

string

엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 Glusterfs 볼륨을 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

14.1.260. .spec.volumes[].hostPath

설명
Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • path
속성유형설명

path

string

호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

HostPath Volume 기본값을 "" 추가 정보: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

14.1.261. .spec.volumes[].iscsi

설명
ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • targetPortal
  • iqn
  • LUN
속성유형설명

chapAuthDiscovery

boolean

chapAuthDiscovery는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다.

chapAuthSession

boolean

chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다.

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다.

iqn

string

IQN은 대상 iSCSI 정규화된 이름입니다.

iscsiInterface

string

iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다.

LUN

integer

LUN은 iSCSI 대상 Lun 번호를 나타냅니다.

포털

배열(문자열)

포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260).

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

targetPortal

string

targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260).

14.1.262. .spec.volumes[].iscsi.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.263. .spec.volumes[].nfs

설명
Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • server
  • path
속성유형설명

path

string

NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

서버는 NFS 서버의 호스트 이름 또는 IP 주소입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

14.1.264. .spec.volumes[].persistentVolumeClaim

설명
PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다.
유형
object
필수 항목
  • claimName
속성유형설명

claimName

string

claimName은 이 볼륨을 사용하는 Pod와 동일한 네임스페이스에 있는 PersistentVolumeClaim의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

readOnly

boolean

ReadOnly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본 false.

14.1.265. .spec.volumes[].photonPersistentDisk

설명
Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
유형
object
필수 항목
  • pdID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

pdID

string

pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다.

14.1.266. .spec.volumes[].portworxVolume

설명
PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. 예. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

volumeID

string

volumeID는 Portworx 볼륨을 고유하게 식별합니다.

14.1.267. .spec.volumes[].projected

설명
예상 볼륨 소스를 나타냅니다.
유형
object
속성유형설명

defaultMode

integer

defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

소스

array

소스는 볼륨 프로젝션의 목록입니다.

sources[]

object

다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션

14.1.268. .spec.volumes[].projected.sources

설명
소스는 볼륨 프로젝션의 목록입니다.
유형
array

14.1.269. .spec.volumes[].projected.sources[]

설명
다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션
유형
object
속성유형설명

configMap

object

ConfigMap을 예상 볼륨에 조정합니다.

대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다.

downwardAPI

object

예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다.

Secret

object

시크릿을 예상 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다.

serviceAccountToken

object

ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다.

14.1.270. .spec.volumes[].projected.sources[].configMap

설명

ConfigMap을 예상 볼륨에 조정합니다.

대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다.

유형
object
속성유형설명

items

array

지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

선택 사항: ConfigMap 또는 해당 키를 정의해야 하는지 여부 지정

14.1.271. .spec.volumes[].projected.sources[].configMap.items

설명
지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

14.1.272. .spec.volumes[].projected.sources[].configMap.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

14.1.273. .spec.volumes[].projected.sources[].downwardAPI

설명
예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다.
유형
object
속성유형설명

items

array

items는 DownwardAPIVolume 파일 목록입니다.

items[]

object

DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.

14.1.274. .spec.volumes[].projected.sources[].downwardAPI.items

설명
items는 DownwardAPIVolume 파일 목록입니다.
유형
array

14.1.275. .spec.volumes[].projected.sources[].downwardAPI.items[]

설명
DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.
유형
object
필수 항목
  • path
속성유형설명

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

mode

integer

선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

14.1.276. .spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

14.1.277. .spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

14.1.278. .spec.volumes[].projected.sources[].secret

설명

시크릿을 예상 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다.

유형
object
속성유형설명

items

array

지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

선택적 필드는 Secret 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

14.1.279. .spec.volumes[].projected.sources[].secret.items

설명
지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

14.1.280. .spec.volumes[].projected.sources[].secret.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

14.1.281. .spec.volumes[].projected.sources[].serviceAccountToken

설명
ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다.
유형
object
필수 항목
  • path
속성유형설명

대상

string

audience는 토큰의 의도된 대상입니다. 토큰 수신자는 토큰 대상에 지정된 식별자로 자신을 식별해야 하며, 그렇지 않으면 토큰을 거부해야 합니다. 오디언스는 기본적으로 apiserver의 식별자입니다.

expirationSeconds

integer

expirationSeconds는 서비스 계정 토큰의 유효 기간입니다. 토큰이 만료되면 kubelet 볼륨 플러그인은 서비스 계정 토큰을 사전에 순환합니다. 토큰이 수명의 80% 이상을 경과했거나 24시간 이상된 경우 kubelet은 토큰을 순환하기 시작합니다.Defaults는 1시간 이상이며 최소 10분이어야 합니다.

path

string

path는 토큰을 프로젝션할 파일의 마운트 지점을 기준으로 하는 경로입니다.

14.1.282. .spec.volumes[].quobyte

설명
Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • 레지스트리
  • volume
속성유형설명

group

string

볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다.

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다.

레지스트리

string

registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨)

tenant

string

백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다.

user

string

사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다.

volume

string

volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다.

14.1.283. .spec.volumes[].rbd

설명
Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • 모니터
  • image
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd

image

string

image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

키 링

string

인증 키는 RBDUser의 키 링의 경로입니다. 기본값은 /etc/ceph/keyring입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

모니터

배열(문자열)

모니터는 Ceph 모니터의 컬렉션입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

pool

string

pool은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

user

string

사용자는 rados 사용자 이름입니다. 기본값은 admin입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

14.1.284. .spec.volumes[].rbd.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.285. .spec.volumes[].scaleIO

설명
scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.
유형
object
필수 항목
  • gateway
  • system
  • secretRef
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다.

gateway

string

Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다.

protectionDomain

string

protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다.

readOnly

boolean

Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

sslEnabled

boolean

sslEnabled Flag enable/disable SSL communication with Gateway, default false

storageMode

string

storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다.

storagePool

string

StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다.

system

string

시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다.

volumeName

string

volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다.

14.1.286. .spec.volumes[].scaleIO.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.287. .spec.volumes[].secret

설명

시크릿을 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
속성유형설명

defaultMode

integer

defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

items

array

지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

optional

boolean

선택적 필드는 Secret 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

secretName

string

secretName은 사용할 Pod의 네임스페이스의 시크릿 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

14.1.288. .spec.volumes[].secret.items

설명
지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

14.1.289. .spec.volumes[].secret.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

14.1.290. .spec.volumes[].storageos

설명
StorageOS 영구 볼륨 리소스를 나타냅니다.
유형
object
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

volumeName

string

volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다.

volumeNamespace

string

volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다.

14.1.291. .spec.volumes[].storageos.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

14.1.292. .spec.volumes[].vsphereVolume

설명
vSphere 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • volumePath
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

storagePolicyID

string

storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다.

storagePolicyName

string

storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다.

volumePath

string

volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다.

14.1.293. .status

설명
PodStatus는 Pod 상태에 대한 정보를 나타냅니다. Pod가 컨트롤 플레인에 연결할 수 없는 경우 상태가 시스템의 실제 상태를 추적할 수 있습니다.
유형
object
속성유형설명

conditions

array

Pod의 현재 서비스 상태입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions

conditions[]

object

PodCondition에는 이 Pod의 현재 상태에 대한 세부 정보가 포함되어 있습니다.

containerStatuses

array

목록에는 매니페스트에 컨테이너당 하나의 항목이 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status

containerStatuses[]

object

ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.

ephemeralContainerStatuses

array

이 Pod에서 실행된 임시 컨테이너의 상태입니다.

ephemeralContainerStatuses[]

object

ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.

hostIP

string

포드가 할당되는 호스트의 IP 주소입니다. 아직 예약되지 않은 경우 비어 있습니다.

initContainerStatuses

array

목록에는 매니페스트에 init 컨테이너당 하나의 항목이 있습니다. 가장 최근 성공한 init 컨테이너는 ready = true이고, 가장 최근에 시작된 컨테이너에는 startTime이 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status

initContainerStatuses[]

object

ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.

message

string

Pod가 이 상태에 있는 이유에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

nominatedNodeName

string

nominatedNodeName은 이 Pod가 노드의 다른 Pod를 선점하는 경우에만 설정되지만 선점하는 연애의 종료 기간을 즉시 예약할 수 없습니다. 이 필드는 Pod가 이 노드에 예약되는 것을 보장하지 않습니다. 다른 노드를 더 빨리 사용할 수 있게 되면 스케줄러에서 Pod를 다른 위치에 배치하도록 결정할 수 있습니다. 또한 스케줄러는 선점 후 생성된 우선 순위 Pod에 이 노드의 리소스를 더 높은 우선 순위 Pod에 제공하도록 결정할 수 있습니다. 결과적으로 Pod가 예약될 때 이 필드는 PodSpec.nodeName과 다를 수 있습니다.

phase

string

Pod의 단계는 Pod가 라이프사이클에 있는 위치에 대한 간단한 고급 요약입니다. 조건 배열, 이유 및 메시지 필드 및 개별 컨테이너 상태 배열에는 Pod 상태에 대한 자세한 내용이 포함됩니다. 5개의 가능한 단계 값이 있습니다.

보류 중: Pod가 Kubernetes 시스템에서 수락되었지만 하나 이상의 컨테이너 이미지가 생성되지 않았습니다. 여기에는 예약되기 전 시간과 네트워크를 통해 이미지를 다운로드하는 데 걸리는 시간이 포함되며 시간이 다소 걸릴 수 있습니다. running: Pod가 노드에 바인딩되었으며 모든 컨테이너가 생성되었습니다. 하나 이상의 컨테이너가 계속 실행 중이거나 시작 또는 다시 시작 중입니다. 성공: Pod의 모든 컨테이너가 성공적으로 종료되고 재시작되지 않습니다. 실패: Pod의 모든 컨테이너가 종료되었으며 하나 이상의 컨테이너가 실패로 종료되었습니다. 컨테이너는 0이 아닌 상태로 종료되었거나 시스템에 의해 종료되었습니다. 알 수 없음: 특정 이유로 Pod의 상태를 가져올 수 없었습니다(일반적으로 Pod 호스트와 통신하는 동안 오류 발생).

자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase

가능한 enum 값: - "Failed" 는 Pod의 모든 컨테이너가 종료되었으며 하나 이상의 컨테이너가 실패로 종료되었음을 나타냅니다(0이 아닌 종료 코드로 표시되거나 시스템에서 중지됨). - "Pending" 는 시스템에서 Pod를 수락했음을 의미하지만 하나 이상의 컨테이너가 시작되지 않았음을 의미합니다. 여기에는 노드에 바인딩되기 전과 이미지를 호스트에 가져오는 데 걸리는 시간도 포함됩니다. - "실행" 은 Pod가 노드에 바인딩되었으며 모든 컨테이너가 시작되었습니다. 하나 이상의 컨테이너가 여전히 실행 중이거나 재시작 프로세스 중 하나입니다. - "성공" 은 Pod의 모든 컨테이너가 컨테이너 종료 코드 0으로 종료되었으며 시스템은 이러한 컨테이너를 다시 시작하지 않을 것임을 의미합니다. - "알 수 없음"은 일반적으로 Pod와 통신할 때 오류가 발생하여 Pod의 상태를 가져올 수 없음을 의미합니다. deprecated: 2015 이후 설정되지 않습니다 (74da3b14b0c0f658b3bb8d2def5094686d0e9095)

podIP

string

Pod에 할당된 IP 주소입니다. 최소한 클러스터 내에서 라우팅할 수 있습니다. 아직 할당되지 않은 경우 비어 있습니다.

podIPs

array

podIPs에는 Pod에 할당된 IP 주소가 있습니다. 이 필드를 지정하면 0번째 항목이 podIP 필드와 일치해야 합니다. Pod는 각 IPv4 및 IPv6에 대해 최대 1개의 값을 할당할 수 있습니다. 이 목록은 IP가 아직 할당되지 않은 경우 비어 있습니다.

podIPs[]

object

(plural) PodIPs 필드의 항목에 대한 IP 주소 정보입니다. 각 항목에는 다음이 포함됩니다.

IP: Pod에 할당된 IP 주소입니다. 최소한 클러스터 내에서 라우팅할 수 있습니다.

qosClass

string

리소스 요구 사항을 기반으로 Pod에 할당된 QoS(Quality of Service) 분류는 사용 가능한 QOS 클래스의 PodQOSClass 유형을 참조하십시오. https://git.k8s.io/community/contributors/design-proposals/node/resource-qos.md

가능한 enum 값: - "BestEffort" 는 BestEffort qos 클래스입니다. - "Burstable" 은 Burstable qos 클래스입니다. - "Guaranteed" 는 Guaranteed qos 클래스입니다.

reason

string

Pod가 이 상태에 있는 이유에 대한 세부 정보를 나타내는 간략한 CamelCase 메시지입니다. 예를 들면 다음과 같습니다. 'Evicted'

startTime

시간

Kubelet에서 오브젝트를 승인한 RFC 3339 날짜 및 시간입니다. Kubelet이 Pod의 컨테이너 이미지를 가져오기 전입니다.

14.1.294. .status.conditions

설명
Pod의 현재 서비스 상태입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions
유형
array

14.1.295. .status.conditions[]

설명
PodCondition에는 이 Pod의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastProbeTime

시간

조건을 마지막으로 확인했을 때입니다.

lastTransitionTime

시간

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

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

reason

string

조건의 마지막 전환에 대한 고유하고 한단어, CamelCase 이유.

status

string

Status는 조건의 상태입니다. True, False, 알 수 없음 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions

type

string

type은 조건의 유형입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions

14.1.296. .status.containerStatuses

설명
목록에는 매니페스트에 컨테이너당 하나의 항목이 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
유형
array

14.1.297. .status.containerStatuses[]

설명
ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
  • Ready
  • restartCount
  • image
  • imageID
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID입니다.

image

string

컨테이너가 실행 중인 이미지입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images.

imageID

string

컨테이너 이미지의 ImageId.

lastState

object

ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.

name

string

DNS_LABEL이어야 합니다. Pod의 각 컨테이너에는 고유한 이름이 있어야 합니다. CamelCase로

Ready

boolean

컨테이너가 준비 상태 프로브를 통과했는지 여부를 지정합니다.

restartCount

integer

컨테이너가 다시 시작된 횟수입니다.

started

boolean

컨테이너가 시작 프로브를 통과했는지 여부를 지정합니다. false로 초기화되고 startupProbe가 성공한 후 true가 됩니다. 컨테이너를 다시 시작하거나 kubelet이 일시적으로 상태가 손실될 때 false로 재설정됩니다. startupProbe가 정의되지 않은 경우 항상 true입니다.

상태

object

ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.

14.1.298. .status.containerStatuses[].lastState

설명
ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
유형
object
속성유형설명

running

object

ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.

종료됨

object

ContainerStateTerminated는 컨테이너의 종료 상태입니다.

대기 중

object

ContainerStateWaiting은 컨테이너의 대기 상태입니다.

14.1.299. .status.containerStatuses[].lastState.running

설명
ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
유형
object
속성유형설명

startedAt

시간

컨테이너가 마지막으로 시작된 시간(다시)

14.1.300. .status.containerStatuses[].lastState.terminated

설명
ContainerStateTerminated는 컨테이너의 종료 상태입니다.
유형
object
필수 항목
  • exitCode
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID

exitCode

integer

컨테이너의 마지막 종료 후 종료 상태

finishedAt

시간

컨테이너가 마지막으로 종료되는 시간

message

string

컨테이너의 마지막 종료에 대한 메시지

reason

string

(brief) 컨테이너의 마지막 종료 이유

신호

integer

컨테이너의 마지막 종료 시 신호

startedAt

시간

이전 컨테이너 실행이 시작된 시간

14.1.301. .status.containerStatuses[].lastState.waiting

설명
ContainerStateWaiting은 컨테이너의 대기 상태입니다.
유형
object
속성유형설명

message

string

컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다.

reason

string

(brief) 컨테이너가 아직 실행되지 않은 이유

14.1.302. .status.containerStatuses[].state

설명
ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
유형
object
속성유형설명

running

object

ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.

종료됨

object

ContainerStateTerminated는 컨테이너의 종료 상태입니다.

대기 중

object

ContainerStateWaiting은 컨테이너의 대기 상태입니다.

14.1.303. .status.containerStatuses[].state.running

설명
ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
유형
object
속성유형설명

startedAt

시간

컨테이너가 마지막으로 시작된 시간(다시)

14.1.304. .status.containerStatuses[].state.terminated

설명
ContainerStateTerminated는 컨테이너의 종료 상태입니다.
유형
object
필수 항목
  • exitCode
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID

exitCode

integer

컨테이너의 마지막 종료 후 종료 상태

finishedAt

시간

컨테이너가 마지막으로 종료되는 시간

message

string

컨테이너의 마지막 종료에 대한 메시지

reason

string

(brief) 컨테이너의 마지막 종료 이유

신호

integer

컨테이너의 마지막 종료 시 신호

startedAt

시간

이전 컨테이너 실행이 시작된 시간

14.1.305. .status.containerStatuses[].state.waiting

설명
ContainerStateWaiting은 컨테이너의 대기 상태입니다.
유형
object
속성유형설명

message

string

컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다.

reason

string

(brief) 컨테이너가 아직 실행되지 않은 이유

14.1.306. .status.ephemeralContainerStatuses

설명
이 Pod에서 실행된 임시 컨테이너의 상태입니다.
유형
array

14.1.307. .status.ephemeralContainerStatuses[]

설명
ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
  • Ready
  • restartCount
  • image
  • imageID
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID입니다.

image

string

컨테이너가 실행 중인 이미지입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images.

imageID

string

컨테이너 이미지의 ImageId.

lastState

object

ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.

name

string

DNS_LABEL이어야 합니다. Pod의 각 컨테이너에는 고유한 이름이 있어야 합니다. CamelCase로

Ready

boolean

컨테이너가 준비 상태 프로브를 통과했는지 여부를 지정합니다.

restartCount

integer

컨테이너가 다시 시작된 횟수입니다.

started

boolean

컨테이너가 시작 프로브를 통과했는지 여부를 지정합니다. false로 초기화되고 startupProbe가 성공한 후 true가 됩니다. 컨테이너를 다시 시작하거나 kubelet이 일시적으로 상태가 손실될 때 false로 재설정됩니다. startupProbe가 정의되지 않은 경우 항상 true입니다.

상태

object

ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.

14.1.308. .status.ephemeralContainerStatuses[].lastState

설명
ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
유형
object
속성유형설명

running

object

ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.

종료됨

object

ContainerStateTerminated는 컨테이너의 종료 상태입니다.

대기 중

object

ContainerStateWaiting은 컨테이너의 대기 상태입니다.

14.1.309. .status.ephemeralContainerStatuses[].lastState.running

설명
ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
유형
object
속성유형설명

startedAt

시간

컨테이너가 마지막으로 시작된 시간(다시)

14.1.310. .status.ephemeralContainerStatuses[].lastState.terminated

설명
ContainerStateTerminated는 컨테이너의 종료 상태입니다.
유형
object
필수 항목
  • exitCode
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID

exitCode

integer

컨테이너의 마지막 종료 후 종료 상태

finishedAt

시간

컨테이너가 마지막으로 종료되는 시간

message

string

컨테이너의 마지막 종료에 대한 메시지

reason

string

(brief) 컨테이너의 마지막 종료 이유

신호

integer

컨테이너의 마지막 종료 시 신호

startedAt

시간

이전 컨테이너 실행이 시작된 시간

14.1.311. .status.ephemeralContainerStatuses[].lastState.waiting

설명
ContainerStateWaiting은 컨테이너의 대기 상태입니다.
유형
object
속성유형설명

message

string

컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다.

reason

string

(brief) 컨테이너가 아직 실행되지 않은 이유

14.1.312. .status.ephemeralContainerStatuses[].state

설명
ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
유형
object
속성유형설명

running

object

ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.

종료됨

object

ContainerStateTerminated는 컨테이너의 종료 상태입니다.

대기 중

object

ContainerStateWaiting은 컨테이너의 대기 상태입니다.

14.1.313. .status.ephemeralContainerStatuses[].state.running

설명
ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
유형
object
속성유형설명

startedAt

시간

컨테이너가 마지막으로 시작된 시간(다시)

14.1.314. .status.ephemeralContainerStatuses[].state.terminated

설명
ContainerStateTerminated는 컨테이너의 종료 상태입니다.
유형
object
필수 항목
  • exitCode
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID

exitCode

integer

컨테이너의 마지막 종료 후 종료 상태

finishedAt

시간

컨테이너가 마지막으로 종료되는 시간

message

string

컨테이너의 마지막 종료에 대한 메시지

reason

string

(brief) 컨테이너의 마지막 종료 이유

신호

integer

컨테이너의 마지막 종료 시 신호

startedAt

시간

이전 컨테이너 실행이 시작된 시간

14.1.315. .status.ephemeralContainerStatuses[].state.waiting

설명
ContainerStateWaiting은 컨테이너의 대기 상태입니다.
유형
object
속성유형설명

message

string

컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다.

reason

string

(brief) 컨테이너가 아직 실행되지 않은 이유

14.1.316. .status.initContainerStatuses

설명
목록에는 매니페스트에 init 컨테이너당 하나의 항목이 있습니다. 가장 최근 성공한 init 컨테이너는 ready = true이고, 가장 최근에 시작된 컨테이너에는 startTime이 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status
유형
array

14.1.317. .status.initContainerStatuses[]

설명
ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
유형
object
필수 항목
  • name
  • Ready
  • restartCount
  • image
  • imageID
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID입니다.

image

string

컨테이너가 실행 중인 이미지입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images.

imageID

string

컨테이너 이미지의 ImageId.

lastState

object

ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.

name

string

DNS_LABEL이어야 합니다. Pod의 각 컨테이너에는 고유한 이름이 있어야 합니다. CamelCase로

Ready

boolean

컨테이너가 준비 상태 프로브를 통과했는지 여부를 지정합니다.

restartCount

integer

컨테이너가 다시 시작된 횟수입니다.

started

boolean

컨테이너가 시작 프로브를 통과했는지 여부를 지정합니다. false로 초기화되고 startupProbe가 성공한 후 true가 됩니다. 컨테이너를 다시 시작하거나 kubelet이 일시적으로 상태가 손실될 때 false로 재설정됩니다. startupProbe가 정의되지 않은 경우 항상 true입니다.

상태

object

ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.

14.1.318. .status.initContainerStatuses[].lastState

설명
ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
유형
object
속성유형설명

running

object

ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.

종료됨

object

ContainerStateTerminated는 컨테이너의 종료 상태입니다.

대기 중

object

ContainerStateWaiting은 컨테이너의 대기 상태입니다.

14.1.319. .status.initContainerStatuses[].lastState.running

설명
ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
유형
object
속성유형설명

startedAt

시간

컨테이너가 마지막으로 시작된 시간(다시)

14.1.320. .status.initContainerStatuses[].lastState.terminated

설명
ContainerStateTerminated는 컨테이너의 종료 상태입니다.
유형
object
필수 항목
  • exitCode
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID

exitCode

integer

컨테이너의 마지막 종료 후 종료 상태

finishedAt

시간

컨테이너가 마지막으로 종료되는 시간

message

string

컨테이너의 마지막 종료에 대한 메시지

reason

string

(brief) 컨테이너의 마지막 종료 이유

신호

integer

컨테이너의 마지막 종료 시 신호

startedAt

시간

이전 컨테이너 실행이 시작된 시간

14.1.321. .status.initContainerStatuses[].lastState.waiting

설명
ContainerStateWaiting은 컨테이너의 대기 상태입니다.
유형
object
속성유형설명

message

string

컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다.

reason

string

(brief) 컨테이너가 아직 실행되지 않은 이유

14.1.322. .status.initContainerStatuses[].state

설명
ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
유형
object
속성유형설명

running

object

ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.

종료됨

object

ContainerStateTerminated는 컨테이너의 종료 상태입니다.

대기 중

object

ContainerStateWaiting은 컨테이너의 대기 상태입니다.

14.1.323. .status.initContainerStatuses[].state.running

설명
ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
유형
object
속성유형설명

startedAt

시간

컨테이너가 마지막으로 시작된 시간(다시)

14.1.324. .status.initContainerStatuses[].state.terminated

설명
ContainerStateTerminated는 컨테이너의 종료 상태입니다.
유형
object
필수 항목
  • exitCode
속성유형설명

containerID

string

'<type>://<container_id>' 형식의 컨테이너 ID

exitCode

integer

컨테이너의 마지막 종료 후 종료 상태

finishedAt

시간

컨테이너가 마지막으로 종료되는 시간

message

string

컨테이너의 마지막 종료에 대한 메시지

reason

string

(brief) 컨테이너의 마지막 종료 이유

신호

integer

컨테이너의 마지막 종료 시 신호

startedAt

시간

이전 컨테이너 실행이 시작된 시간

14.1.325. .status.initContainerStatuses[].state.waiting

설명
ContainerStateWaiting은 컨테이너의 대기 상태입니다.
유형
object
속성유형설명

message

string

컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다.

reason

string

(brief) 컨테이너가 아직 실행되지 않은 이유

14.1.326. .status.podIPs

설명
podIPs에는 Pod에 할당된 IP 주소가 있습니다. 이 필드를 지정하면 0번째 항목이 podIP 필드와 일치해야 합니다. Pod는 각 IPv4 및 IPv6에 대해 최대 1개의 값을 할당할 수 있습니다. 이 목록은 IP가 아직 할당되지 않은 경우 비어 있습니다.
유형
array

14.1.327. .status.podIPs[]

설명

(plural) PodIPs 필드의 항목에 대한 IP 주소 정보입니다. 각 항목에는 다음이 포함됩니다.

IP: An IP address allocated to the pod. Routable at least within the cluster.
유형
object
속성유형설명

ip

string

IP는 pod에 할당된 IP 주소(IPv4 또는 IPv6)입니다.

14.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /api/v1/pods

    • GET: 종류 Pod의 오브젝트 나열 또는 감시
  • /API/v1/watch/pods

    • GET: Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/pods

    • DELETE: Pod 컬렉션 삭제
    • GET: 종류 Pod의 오브젝트 나열 또는 감시
    • POST: Pod 생성
  • /api/v1/watch/namespaces/{namespace}/pods

    • GET: Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/pods/{name}

    • DELETE: Pod 삭제
    • GET: 지정된 Pod 읽기
    • PATCH: 지정된 Pod를 부분적으로 업데이트
    • PUT: 지정된 Pod를 교체
  • /api/v1/namespaces/{namespace}/pods/{name}/log

    • GET: 지정된 Pod의 읽기 로그
  • /api/v1/watch/namespaces/{namespace}/pods/{name}

    • GET: 종류 Pod의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 'watch' 매개변수를 목록 작업과 함께 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /api/v1/namespaces/{namespace}/pods/{name}/status

    • GET: 지정된 Pod의 읽기 상태
    • PATCH: 지정된 Pod의 부분적으로 업데이트 상태
    • PUT: 지정된 Pod의 상태
  • /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

    • GET: 지정된 Pod의 read ephemeralcontainers
    • PATCH: 지정된 Pod의 ephemeralcontainers를 부분적으로 업데이트
    • PUT: 지정된 Pod의 ephemeralcontainers를 교체

14.2.1. /api/v1/pods

표 14.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Pod 유형의 오브젝트 나열 또는 감시
표 14.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PodList schema

401 - 무단

14.2.2. /API/v1/watch/pods

표 14.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 14.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

14.2.3. /api/v1/namespaces/{namespace}/pods

표 14.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
Pod 컬렉션 삭제
표 14.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 14.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 14.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
Pod 유형의 오브젝트 나열 또는 감시
표 14.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 14.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PodList schema

401 - 무단

HTTP 방법
POST
설명
Pod 생성
표 14.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 14.13. 본문 매개변수
매개변수유형설명

body

Pod 스키마

 
표 14.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

202 - 승인됨

Pod 스키마

401 - 무단

14.2.4. /api/v1/watch/namespaces/{namespace}/pods

표 14.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 14.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

14.2.5. /api/v1/namespaces/{namespace}/pods/{name}

표 14.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

Pod 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
Pod 삭제
표 14.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 14.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 14.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

202 - 승인됨

Pod 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 Pod 읽기
표 14.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Pod를 부분적으로 업데이트
표 14.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 14.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 14.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 Pod를 교체
표 14.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 14.28. 본문 매개변수
매개변수유형설명

body

Pod 스키마

 
표 14.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

401 - 무단

14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log

표 14.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

Pod 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.31. 글로벌 쿼리 매개변수
매개변수유형설명

container

string

로그를 스트리밍할 컨테이너입니다. Pod에 컨테이너가 한 개 있는 경우에만 기본값은 컨테이너입니다.

팔로우

boolean

Pod의 로그 스트림을 따릅니다. 기본값은 false입니다.

insecureSkipTLSVerifyBackend

boolean

insecureSkipTLSVerifyBackend는 apiserver가 연결된 백엔드의 제공 인증서의 유효성을 확인하지 않아야 함을 나타냅니다. 이렇게 하면 apiserver와 백엔드 간에 HTTPS 연결이 안전하지 않습니다. 즉, apiserver에서 수신 중인 로그 데이터를 실제 kubelet에서 확인할 수 없습니다. kubelet이 apiserver의 TLS 인증 정보를 확인하도록 구성된 경우 실제 kubelet에 대한 연결이 중간 공격의 사람에 취약하지 않습니다(예: 공격자가 실제 kubelet에서 들어오는 실제 로그 데이터를 가로챌 수 없음).

limitBytes

integer

설정된 경우 로그 출력을 종료하기 전에 서버에서 읽을 바이트 수입니다. 이는 완전한 최종 로깅 행을 표시하지 않을 수 있으며 지정된 제한보다 약간 많거나 적을 수 있습니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

이전

boolean

이전에 종료된 컨테이너 로그를 반환합니다. 기본값은 false입니다.

sinceSeconds

integer

로그를 표시할 현재 시간(초) 전의 상대 시간(초)입니다. 이 값이 Pod를 시작한 시간보다 앞면 Pod 시작 이후의 로그만 반환됩니다. 이 값이 향후이면 로그가 반환되지 않습니다. sinceSeconds 또는 sinceTime 중 하나만 지정할 수 있습니다.

tailLines

integer

설정하는 경우 표시할 로그 끝부분의 행 수입니다. 지정하지 않으면 컨테이너 생성 또는 sinceSeconds 또는 sinceTime에서 로그가 표시됩니다.

타임 스탬프

boolean

true인 경우 로그 출력의 모든 줄 시작 부분에 RFC3339 또는 RFC3339Nano 타임스탬프를 추가합니다. 기본값은 false입니다.

HTTP 방법
GET
설명
지정된 Pod의 로그 읽기
표 14.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

string

401 - 무단

14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}

표 14.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

Pod 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.34. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
더 이상 사용되지 않는 Pod의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 14.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status

표 14.36. 글로벌 경로 매개변수
매개변수유형설명

name

string

Pod 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.37. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 Pod의 상태 확인
표 14.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Pod의 부분적으로 업데이트 상태
표 14.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 14.40. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 14.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 Pod의 상태 교체
표 14.42. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 14.43. 본문 매개변수
매개변수유형설명

body

Pod 스키마

 
표 14.44. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

401 - 무단

14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

표 14.45. 글로벌 경로 매개변수
매개변수유형설명

name

string

Pod 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 14.46. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 Pod의 ephemeralcontainers 읽기
표 14.47. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Pod의 임시containers를 부분적으로 업데이트
표 14.48. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 14.49. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 14.50. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 Pod의 ephemeralcontainers 교체
표 14.51. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 14.52. 본문 매개변수
매개변수유형설명

body

Pod 스키마

 
표 14.53. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Pod 스키마

201 - 생성됨

Pod 스키마

401 - 무단

15장. ReplicationController [v1]

설명
복제 컨트롤러의 구성을 나타냅니다.
유형
object

15.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

ReplicationController의 라벨이 비어 있으면 복제 컨트롤러가 관리하는 Pod와 동일하게 기본 설정됩니다. 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ReplicationControllerSpec은 복제 컨트롤러의 사양입니다.

status

object

ReplicationControllerStatus는 복제 컨트롤러의 현재 상태를 나타냅니다.

15.1.1. .spec

설명
ReplicationControllerSpec은 복제 컨트롤러의 사양입니다.
유형
object
속성유형설명

minReadySeconds

integer

컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)을 사용할 수 있습니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨)

replicas

integer

replicas는 원하는 복제본 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller

선택기

오브젝트(문자열)

selector는 Replicas 수와 일치해야 하는 Pod의 레이블 쿼리입니다. Selector가 비어 있으면 Pod 템플릿에 있는 라벨로 설정됩니다. Pod 템플릿의 라벨에 기본값이 기본값인 경우 이 복제 컨트롤러에서 제어하려면 일치해야 하는 레이블 키와 값에 해당합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

템플릿

object

PodTemplateSpec은 템플릿에서 Pod가 생성할 때 보유해야 하는 데이터를 설명합니다.

15.1.2. .spec.template

설명
PodTemplateSpec은 템플릿에서 Pod가 생성할 때 보유해야 하는 데이터를 설명합니다.
유형
object
속성유형설명

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

PodSpec은 Pod에 대한 설명입니다.

15.1.3. .spec.template.spec

설명
PodSpec은 Pod에 대한 설명입니다.
유형
object
필수 항목
  • 컨테이너
속성유형설명

activeDeadlineSeconds

integer

시스템이 적극적으로 실패했음을 표시하고 연결된 컨테이너를 종료하기 전에 Pod가 StartTime을 기준으로 노드에서 활성화되는 시간(초)입니다. 값은 양의 정수여야 합니다.

유사성

object

유사성은 선호도 스케줄링 규칙 그룹입니다.

automountServiceAccountToken

boolean

AutomountServiceAccountToken은 서비스 계정 토큰을 자동으로 마운트해야 하는지 여부를 나타냅니다.

컨테이너

array

Pod에 속하는 컨테이너 목록입니다. 컨테이너는 현재 추가 또는 제거할 수 없습니다. Pod에는 하나 이상의 컨테이너가 있어야 합니다. CamelCase로

containers[]

object

Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.

dnsConfig

object

PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다.

dnsPolicy

string

Pod의 DNS 정책을 설정합니다. 기본값은 "ClusterFirst"입니다. 유효한 값은 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' 또는 'None'입니다. DNSConfig에 제공된 DNS 매개변수는 DNSPolicy와 선택한 정책과 병합됩니다. hostNetwork와 함께 DNS 옵션을 설정하려면 'ClusterFirstWithHostNet'에 DNS 정책을 명시적으로 지정해야 합니다.

가능한 enum 값: - "ClusterFirst" 는 hostNetwork가 true인 경우를 제외하고 먼저 클러스터 DNS를 사용해야 함을 나타냅니다. 그런 다음 기본 ( kubelet에 의해 결정됨) DNS 설정으로 대체하십시오. - "ClusterFirstWithHostNet" 은 사용 가능한 경우 Pod에서 클러스터 DNS를 먼저 사용해야 함을 나타냅니다. 기본 ( kubelet에 의해 결정됨) DNS 설정에서 "Default" 는 Pod에서 기본 ( kubelet에 의해 결정됨) DNS 설정을 사용해야 함을 나타냅니다. - "없음" 은 Pod에서 빈 DNS 설정을 사용해야 함을 나타냅니다. 이름 서버 및 검색 경로와 같은 DNS 매개변수는 DNSConfig를 통해 정의해야 합니다.

enableServiceLinks

boolean

EnableServiceLinks는 서비스에 대한 정보를 Docker 링크의 구문과 일치하는 Pod의 환경 변수에 삽입해야 하는지 여부를 나타냅니다. 선택 사항: true로 설정됩니다.

ephemeralContainers

array

이 Pod에서 실행되는 임시 컨테이너 목록입니다. 임시 컨테이너는 기존 Pod에서 실행하여 디버깅과 같은 사용자 시작 작업을 수행할 수 있습니다. 이 목록은 Pod를 생성할 때 지정할 수 없으며 Pod 사양을 업데이트하여 수정할 수 없습니다. 기존 포드에 임시 컨테이너를 추가하려면 Pod의 ephemeralcontainers 하위 리소스를 사용합니다.

ephemeralContainers[]

object

EphemeralContainer는 디버깅과 같은 사용자 시작 활동을 위해 기존 Pod에 추가할 수 있는 임시 컨테이너입니다. 임시 컨테이너에는 리소스 또는 스케줄링 보장이 없으며 Pod가 종료되거나 Pod를 다시 시작할 때 재시작되지 않습니다. 임시 컨테이너에서 Pod가 리소스 할당을 초과하는 경우 kubelet에서 Pod를 제거할 수 있습니다.

임시 컨테이너를 추가하려면 기존 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. 임시 컨테이너는 제거하거나 다시 시작할 수 없습니다.

hostAliases

array

hostAliases는 지정된 경우 Pod의 호스트 파일에 삽입될 호스트 및 IP의 선택적 목록입니다. 이는 non-hostNetwork Pod에만 유효합니다.

hostAliases[]

object

HostAlias는 Pod의 호스트 파일에 항목으로 삽입될 IP와 호스트 이름 간의 매핑을 보유합니다.

hostIPC

boolean

호스트의 ipc 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다.

hostNetwork

boolean

이 Pod에 대해 요청된 호스트 네트워킹입니다. 호스트의 네트워크 네임스페이스를 사용합니다. 이 옵션을 설정하는 경우 사용할 포트를 지정해야 합니다. 기본값은 false입니다.

hostPID

boolean

호스트의 pid 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다.

hostUsers

boolean

호스트의 사용자 네임스페이스를 사용합니다. 선택 사항: 기본값은 true입니다. true로 설정하면 Pod에 CAP_SYS_MODULE을 사용하여 커널 모듈을 로드하는 등 호스트 사용자 네임스페이스만 사용할 수 있는 기능이 필요한 경우에 유용합니다. false로 설정하면 Pod에 대한 새 사용자가 생성됩니다. false를 설정하면 사용자가 실제로 호스트에 대한 root 권한이 없어도 컨테이너 중단 취약점을 완화하는 데 유용합니다. 이 필드는 알파 수준이며 UserNamespacesSupport 기능을 활성화하는 서버에서만 적용됩니다.

hostname

string

Pod의 호스트 이름을 지정하지 않으면 Pod의 호스트 이름이 시스템 정의 값으로 설정됩니다.

imagePullSecrets

array

imagePullSecrets는 이 PodSpec에서 사용하는 이미지를 가져오는 데 사용할 동일한 네임스페이스의 시크릿에 대한 선택적 참조 목록입니다. 지정된 경우 이러한 시크릿은 사용할 수 있도록 개별 풀러 구현으로 전달됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod

imagePullSecrets[]

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

initContainers

array

Pod에 속하는 초기화 컨테이너 목록입니다. Init 컨테이너는 컨테이너가 시작되기 전에 실행됩니다. init 컨테이너가 실패하면 Pod가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너에서 고유해야 합니다. Init 컨테이너에는 Lifecycle 작업, 준비 상태 프로브, 활성 상태 프로브 또는 시작 프로브가 없을 수 있습니다. init 컨테이너의 resourceRequirements는 각 리소스 유형에 대해 가장 높은 요청/제한을 찾은 다음 해당 값의 최대값 또는 일반 컨테이너의 합계를 사용하여 스케줄링 중에 고려됩니다. 제한은 init 컨테이너에 유사한 방식으로 적용됩니다. init 컨테이너는 현재 추가 또는 제거할 수 없습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/

initContainers[]

object

Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.

nodeName

string

nodename은 이 Pod를 특정 노드에 예약하기 위한 요청입니다. 비어 있지 않은 경우 스케줄러는 리소스 요구 사항에 부합한다고 가정하면 해당 노드에 이 Pod를 간단히 예약합니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 Pod가 노드에 적합하도록 true여야 하는 선택기입니다. 해당 노드에 예약하려면 Pod의 노드 레이블과 일치해야 하는 선택기입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/assign-pod-node/

OS

object

PodOS는 Pod의 OS 매개변수를 정의합니다.

오버헤드

오브젝트(Quantity)

오버헤드는 지정된 RuntimeClass에 대해 Pod를 실행하는 것과 관련된 리소스 오버헤드를 나타냅니다. 이 필드는 RuntimeClass 승인 컨트롤러에서 승인 시 자동으로 채워집니다. RuntimeClass 승인 컨트롤러가 활성화된 경우 Pod 생성 요청에 오버헤드를 설정하지 않아야 합니다. RuntimeClass 승인 컨트롤러는 오버헤드가 이미 설정된 Pod 생성 요청을 거부합니다. PodSpec에서 RuntimeClass를 구성 및 선택하면 Overhead가 해당 RuntimeClass에 정의된 값으로 설정됩니다. 그렇지 않으면 설정되지 않고 0으로 처리됩니다. 자세한 내용은 https://git.k8s.io/enhancements/keps/sig-node/688-pod-overhead/README.md

preemptionPolicy

string

preemptionPolicy는 우선순위가 낮은 Pod를 선점하는 정책입니다. Never, PreemptLowerPriority 중 하나입니다. 설정되지 않은 경우 기본값은 PreemptLowerPriority입니다.

priority

integer

우선순위 값입니다. 다양한 시스템 구성 요소는 이 필드를 사용하여 Pod의 우선 순위를 찾습니다. Priority Admission Controller가 활성화되면 사용자가 이 필드를 설정할 수 없습니다. 승인 컨트롤러는 PriorityClassName에서 이 필드를 채웁니다. 값이 클수록 우선순위가 높습니다.

priorityClassName

string

지정하면 Pod의 우선 순위를 나타냅니다. "system-node-critical" 및 "system-cluster-critical"은 두 가지 특수 키워드로, 전자의 우선 순위가 가장 높은 우선 순위임을 나타냅니다. 다른 이름은 해당 이름으로 PriorityClass 오브젝트를 생성하여 정의해야 합니다. 지정하지 않으면 Pod 우선순위가 기본값 또는 기본값이 없는 경우 0입니다.

readinessGates

array

지정하면 Pod 준비 상태에 대한 모든 준비 상태 게이트가 평가됩니다. 모든 컨테이너가 준비되고 준비 게이트에 지정된 모든 조건이 "True" 추가 정보와 같은 상태가 있는 경우 Pod가 준비됩니다. https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates

readinessGates[]

object

PodReadinessGate에는 Pod 상태에 대한 참조가 포함되어 있습니다.

restartPolicy

string

Pod 내의 모든 컨테이너에 대한 재시작 정책입니다. Always, OnFailure, Never 중 하나입니다. 기본값은 Always입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy

가능한 열거 값: - "항상" - "Never" - "OnFailure"

runtimeClassName

string

runtimeClassName은 이 Pod를 실행하는 데 사용해야 하는 node.k8s.io 그룹의 RuntimeClass 오브젝트를 나타냅니다. RuntimeClass 리소스가 이름이 지정된 클래스와 일치하지 않으면 Pod가 실행되지 않습니다. 설정되지 않았거나 비어 있으면 기본 런타임 처리기를 사용하는 빈 정의가 있는 암시적 클래스인 "legacy" RuntimeClass가 사용됩니다. 자세한 내용은 https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class

schedulerName

string

지정된 경우 지정된 스케줄러에 의해 Pod가 디스패치됩니다. 지정하지 않으면 Pod가 기본 스케줄러에서 디스패치됩니다.

securityContext

object

PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다.

serviceAccount

string

더 이상 사용되지 않는ServiceAccount는 ServiceAccountName의 더 이상 사용되지 않는 별칭입니다. deprecated: 대신 serviceAccountName을 사용합니다.

serviceAccountName

string

serviceAccountName은 이 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/

setHostnameAsFQDN

boolean

true인 경우 Pod의 호스트 이름이 리프 이름(기본값)이 아닌 Pod의 FQDN으로 구성됩니다. Linux 컨테이너에서 커널의 hostname 필드에 FQDN을 설정하는 것을 의미합니다( struct utsname의 nodename 필드). Windows 컨테이너에서 레지스트리 키 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters의 레지스트리 값을 FQDN으로 설정하는 것을 의미합니다. Pod에 FQDN이 없는 경우 적용되지 않습니다. 기본값은 false입니다.

shareProcessNamespace

boolean

Pod의 모든 컨테이너 간에 단일 프로세스 네임스페이스를 공유합니다. 컨테이너를 설정하면 동일한 포드에 있는 다른 컨테이너의 프로세스를 보고 신호할 수 있으며 각 컨테이너의 첫 번째 프로세스에 PID 1이 할당되지 않습니다. HostPID 및 ShareProcessNamespace는 둘 다 설정할 수 없습니다. 선택 사항: 기본값은 false입니다.

subdomain

string

지정된 경우 정규화된 Pod 호스트 이름은 "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>"입니다. 지정하지 않으면 Pod에 도메인 이름이 전혀 없습니다.

terminationGracePeriodSeconds

integer

Pod가 정상적으로 종료되어야 하는 시간(초)입니다. 삭제 요청으로 줄어들 수 있습니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 이 값이 nil이면 기본 유예 기간이 대신 사용됩니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 기본값은 30초입니다.

허용 오차

array

지정된 경우 Pod의 허용 오차입니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

topologySpreadConstraints

array

TopologySpreadConstraints는 Pod 그룹이 토폴로지 도메인에 분산되는 방법을 설명합니다. 스케줄러는 제약 조건에 따라 비활성화되는 방식으로 Pod를 예약합니다. 모든 topologySpreadConstraints는 ANDed입니다.

topologySpreadConstraints[]

object

TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.

volumes

array

Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes

volumes[]

object

volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다.

15.1.4. .spec.template.spec.affinity

설명
유사성은 선호도 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

nodeAffinity

object

노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다.

podAffinity

object

Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다.

podAntiAffinity

object

Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다.

15.1.5. .spec.template.spec.affinity.nodeAffinity

설명
노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.

requiredDuringSchedulingIgnoredDuringExecution

object

노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.

15.1.6. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다.
유형
array

15.1.7. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다.
유형
object
필수 항목
  • weight
  • preference
속성유형설명

preference

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

weight

integer

1-100 범위의 해당 nodeSelectorTerm과 일치하는 가중치입니다.

15.1.8. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

15.1.9. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

15.1.10. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

15.1.11. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

15.1.12. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchFields[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

15.1.13. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
유형
object
필수 항목
  • nodeSelectorTerms
속성유형설명

nodeSelectorTerms

array

필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.

nodeSelectorTerms[]

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

15.1.14. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms

설명
필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.
유형
array

15.1.15. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[]

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

15.1.16. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

15.1.17. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

15.1.18. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

15.1.19. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchFields[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

15.1.20. .spec.template.spec.affinity.podAffinity

설명
Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

15.1.21. .spec.template.spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

15.1.22. .spec.template.spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • weight
  • podAffinityTerm
속성유형설명

podAffinityTerm

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

15.1.23. .spec.template.spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

15.1.24. .spec.template.spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

15.1.25. .spec.template.spec.affinity.podAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

15.1.26. .spec.template.spec.affinity.podAntiAffinity

설명
Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다.
유형
object
속성유형설명

preferredDuringSchedulingIgnoredDuringExecution

array

스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.

preferredDuringSchedulingIgnoredDuringExecution[]

object

일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.

requiredDuringSchedulingIgnoredDuringExecution

array

이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.

requiredDuringSchedulingIgnoredDuringExecution[]

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

15.1.27. .spec.template.spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution

설명
스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다.
유형
array

15.1.28. .spec.template.spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[]

설명
일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다.
유형
object
필수 항목
  • weight
  • podAffinityTerm
속성유형설명

podAffinityTerm

object

Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.

weight

integer

1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다.

15.1.29. .spec.template.spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

15.1.30. .spec.template.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution

설명
이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다.
유형
array

15.1.31. .spec.template.spec.affinity.podAntiAffinity.requiredDuringSchedulingIgnoredDuringExecution[]

설명
Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
유형
object
필수 항목
  • TopologyKey
속성유형설명

labelSelector

LabelSelector

리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다.

namespaceSelector

LabelSelector

용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다.

네임스페이스

배열(문자열)

네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다.

TopologyKey

string

이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다.

15.1.32. .spec.template.spec.containers

설명
Pod에 속하는 컨테이너 목록입니다. 컨테이너는 현재 추가 또는 제거할 수 없습니다. Pod에는 하나 이상의 컨테이너가 있어야 합니다. CamelCase로
유형
array

15.1.33. .spec.template.spec.containers[]

설명
Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.
유형
object
필수 항목
  • name
속성유형설명

args

배열(문자열)

진입점에 대한 인수입니다. 컨테이너 이미지의 CMD는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

command

배열(문자열)

ENTRYPOINT 배열. 쉘 내에서 실행되지 않습니다. 컨테이너 이미지의 ENTRYPOINT는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array

컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

envFrom

array

컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로

envFrom[]

object

EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.

image

string

컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다.

imagePullPolicy

string

이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images

가능한 열거 값: - "항상" 은 kubelet이 항상 최신 이미지를 가져오려고 시도한다는 것을 의미합니다. 가져오기에 실패하면 컨테이너가 실패합니다. - "IfNotPresent" 는 이미지가 디스크에 없는 경우 kubelet을 가져오는 것을 의미합니다. 이미지가 존재하지 않고 가져오기에 실패하면 컨테이너가 실패합니다. - "없음" 은 kubelet이 이미지를 가져오지 않지만 로컬 이미지만 사용한다는 것을 의미합니다. 이미지가 없으면 컨테이너가 실패합니다.

lifecycle

object

라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.

livenessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

name

string

DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로

포트

array

컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로

ports[]

object

containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.

readinessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

securityContext

object

securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.

startupProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

stdin

boolean

이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다.

stdinOnce

boolean

컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다.

terminationMessagePath

string

선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로

terminationMessagePolicy

string

종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로

가능한 enum 값: - "FallbackToLogsOnError" 는 컨테이너가 오류와 함께 종료되면 컨테이너 상태 메시지에 대한 컨테이너 로그의 최신 내용을 읽습니다. - "File" 은 기본 동작이며 컨테이너가 종료될 때 컨테이너의 terminationMessagePath의 콘텐츠로 컨테이너 상태 메시지를 설정합니다.

TTY

boolean

이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다.

volumeDevices

array

volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.

volumeDevices[]

object

volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.

volumeMounts

array

컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로

volumeMounts[]

object

volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.

workingDir

string

컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로

15.1.34. .spec.template.spec.containers[].env

설명
컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
유형
array

15.1.35. .spec.template.spec.containers[].env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

EnvVarSource는 EnvVar 값의 소스를 나타냅니다.

15.1.36. .spec.template.spec.containers[].env[].valueFrom

설명
EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap에서 키를 선택합니다.

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

secretKeyRef

object

SecretKeySelector는 시크릿의 키를 선택합니다.

15.1.37. .spec.template.spec.containers[].env[].valueFrom.configMapKeyRef

설명
ConfigMap에서 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.38. .spec.template.spec.containers[].env[].valueFrom.fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

15.1.39. .spec.template.spec.containers[].env[].valueFrom.resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

15.1.40. .spec.template.spec.containers[].env[].valueFrom.secretKeyRef

설명
SecretKeySelector는 시크릿의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.41. .spec.template.spec.containers[].envFrom

설명
컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
유형
array

15.1.42. .spec.template.spec.containers[].envFrom[]

설명
EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
유형
object
속성유형설명

configMapRef

object

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

prefix

string

ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다.

secretRef

object

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

15.1.43. .spec.template.spec.containers[].envFrom[].configMapRef

설명

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap을 정의해야 하는지 여부를 지정

15.1.44. .spec.template.spec.containers[].envFrom[].secretRef

설명

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

보안을 정의해야 하는지 여부를 지정합니다.

15.1.45. .spec.template.spec.containers[].lifecycle

설명
라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
유형
object
속성유형설명

postStart

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

preStop

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

15.1.46. .spec.template.spec.containers[].lifecycle.postStart

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

15.1.47. .spec.template.spec.containers[].lifecycle.postStart.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.48. .spec.template.spec.containers[].lifecycle.postStart.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.49. .spec.template.spec.containers[].lifecycle.postStart.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.50. .spec.template.spec.containers[].lifecycle.postStart.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.51. .spec.template.spec.containers[].lifecycle.postStart.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.52. .spec.template.spec.containers[].lifecycle.preStop

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

15.1.53. .spec.template.spec.containers[].lifecycle.preStop.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.54. .spec.template.spec.containers[].lifecycle.preStop.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.55. .spec.template.spec.containers[].lifecycle.preStop.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.56. .spec.template.spec.containers[].lifecycle.preStop.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.57. .spec.template.spec.containers[].lifecycle.preStop.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.58. .spec.template.spec.containers[].livenessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.59. .spec.template.spec.containers[].livenessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.60. .spec.template.spec.containers[].livenessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.61. .spec.template.spec.containers[].livenessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.62. .spec.template.spec.containers[].livenessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.63. .spec.template.spec.containers[].livenessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.64. .spec.template.spec.containers[].livenessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.65. .spec.template.spec.containers[].ports

설명
컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로
유형
array

15.1.66. .spec.template.spec.containers[].ports[]

설명
containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
유형
object
필수 항목
  • containerPort
속성유형설명

containerPort

integer

Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다.

hostIP

string

외부 포트를 바인딩할 호스트 IP는 무엇입니까.

hostPort

integer

호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다.

name

string

지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다.

protocol

string

포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

15.1.67. .spec.template.spec.containers[].readinessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.68. .spec.template.spec.containers[].readinessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.69. .spec.template.spec.containers[].readinessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.70. .spec.template.spec.containers[].readinessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.71. .spec.template.spec.containers[].readinessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.72. .spec.template.spec.containers[].readinessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.73. .spec.template.spec.containers[].readinessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.74. .spec.template.spec.containers[].resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

15.1.75. .spec.template.spec.containers[].securityContext

설명
securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
유형
object
속성유형설명

allowPrivilegeEscalation

boolean

allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

capabilities

object

실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.

privileged

boolean

권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

procMount

string

procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

readOnlyRootFilesystem

boolean

이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

15.1.76. .spec.template.spec.containers[].securityContext.capabilities

설명
실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
유형
object
속성유형설명

add

배열(문자열)

추가 기능

drop

배열(문자열)

제거된 기능

15.1.77. .spec.template.spec.containers[].securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

15.1.78. .spec.template.spec.containers[].securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

15.1.79. .spec.template.spec.containers[].securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

15.1.80. .spec.template.spec.containers[].startupProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.81. .spec.template.spec.containers[].startupProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.82. .spec.template.spec.containers[].startupProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.83. .spec.template.spec.containers[].startupProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.84. .spec.template.spec.containers[].startupProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.85. .spec.template.spec.containers[].startupProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.86. .spec.template.spec.containers[].startupProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.87. .spec.template.spec.containers[].volumeDevices

설명
volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.
유형
array

15.1.88. .spec.template.spec.containers[].volumeDevices[]

설명
volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.
유형
object
필수 항목
  • name
  • devicePath
속성유형설명

devicePath

string

devicePath는 장치를 매핑할 컨테이너 내부의 경로입니다.

name

string

name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다

15.1.89. .spec.template.spec.containers[].volumeMounts

설명
컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로
유형
array

15.1.90. .spec.template.spec.containers[].volumeMounts[]

설명
volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • name
  • mountPath
속성유형설명

mountPath

string

볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다.

mountPropagation

string

mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다.

name

string

이는 볼륨 이름과 일치해야 합니다.

readOnly

boolean

true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다.

subPath

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

subPathExpr

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다.

15.1.91. .spec.template.spec.dnsConfig

설명
PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다.
유형
object
속성유형설명

네임서버

배열(문자열)

DNS 이름 서버 IP 주소 목록입니다. DNSPolicy에서 생성된 기본 이름 서버에 추가됩니다. 중복된 네임서버가 제거됩니다.

options

array

DNS 확인자 옵션 목록입니다. 이는 DNSPolicy에서 생성된 기본 옵션과 병합됩니다. 중복된 항목이 제거됩니다. 옵션에 제공된 해결 옵션은 기본 DNSPolicy에 표시되는 옵션을 재정의합니다.

options[]

object

PodDNSConfigOption은 Pod의 DNS 확인자 옵션을 정의합니다.

검색

배열(문자열)

호스트 이름 조회를 위한 DNS 검색 도메인 목록입니다. DNSPolicy에서 생성된 기본 검색 경로에 추가됩니다. 중복된 검색 경로가 제거됩니다.

15.1.92. .spec.template.spec.dnsConfig.options

설명
DNS 확인자 옵션 목록입니다. 이는 DNSPolicy에서 생성된 기본 옵션과 병합됩니다. 중복된 항목이 제거됩니다. 옵션에 제공된 해결 옵션은 기본 DNSPolicy에 표시되는 옵션을 재정의합니다.
유형
array

15.1.93. .spec.template.spec.dnsConfig.options[]

설명
PodDNSConfigOption은 Pod의 DNS 확인자 옵션을 정의합니다.
유형
object
속성유형설명

name

string

필수 항목입니다.

value

string

 

15.1.94. .spec.template.spec.ephemeralContainers

설명
이 Pod에서 실행되는 임시 컨테이너 목록입니다. 임시 컨테이너는 기존 Pod에서 실행하여 디버깅과 같은 사용자 시작 작업을 수행할 수 있습니다. 이 목록은 Pod를 생성할 때 지정할 수 없으며 Pod 사양을 업데이트하여 수정할 수 없습니다. 기존 포드에 임시 컨테이너를 추가하려면 Pod의 ephemeralcontainers 하위 리소스를 사용합니다.
유형
array

15.1.95. .spec.template.spec.ephemeralContainers[]

설명

EphemeralContainer는 디버깅과 같은 사용자 시작 활동을 위해 기존 Pod에 추가할 수 있는 임시 컨테이너입니다. 임시 컨테이너에는 리소스 또는 스케줄링 보장이 없으며 Pod가 종료되거나 Pod를 다시 시작할 때 재시작되지 않습니다. 임시 컨테이너에서 Pod가 리소스 할당을 초과하는 경우 kubelet에서 Pod를 제거할 수 있습니다.

임시 컨테이너를 추가하려면 기존 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. 임시 컨테이너는 제거하거나 다시 시작할 수 없습니다.

유형
object
필수 항목
  • name
속성유형설명

args

배열(문자열)

진입점에 대한 인수입니다. 이미지의 CMD는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

command

배열(문자열)

ENTRYPOINT 배열. 쉘 내에서 실행되지 않습니다. 이미지의 ENTRYPOINT는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array

컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

envFrom

array

컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로

envFrom[]

object

EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.

image

string

컨테이너 이미지 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images

imagePullPolicy

string

이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images

가능한 열거 값: - "항상" 은 kubelet이 항상 최신 이미지를 가져오려고 시도한다는 것을 의미합니다. 가져오기에 실패하면 컨테이너가 실패합니다. - "IfNotPresent" 는 이미지가 디스크에 없는 경우 kubelet을 가져오는 것을 의미합니다. 이미지가 존재하지 않고 가져오기에 실패하면 컨테이너가 실패합니다. - "없음" 은 kubelet이 이미지를 가져오지 않지만 로컬 이미지만 사용한다는 것을 의미합니다. 이미지가 없으면 컨테이너가 실패합니다.

lifecycle

object

라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.

livenessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

name

string

DNS_LABEL로 지정된 임시 컨테이너의 이름입니다. 이 이름은 모든 컨테이너, init 컨테이너 및 임시 컨테이너에서 고유해야 합니다.

포트

array

임시 컨테이너에는 포트가 허용되지 않습니다.

ports[]

object

containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.

readinessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

securityContext

object

securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.

startupProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

stdin

boolean

이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다.

stdinOnce

boolean

컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다.

targetContainerName

string

설정된 경우 PodSpec의 컨테이너 이름이 이 임시 컨테이너를 대상으로 합니다. 임시 컨테이너는 이 컨테이너의 네임스페이스(IPC, PID 등)에서 실행됩니다. 설정되지 않은 경우 임시 컨테이너는 Pod 사양에 구성된 네임스페이스를 사용합니다.

컨테이너 런타임은 이 기능에 대한 지원을 구현해야 합니다. 런타임에서 네임스페이스 대상 지정을 지원하지 않으면 이 필드를 설정한 결과는 정의되지 않습니다.

terminationMessagePath

string

선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로

terminationMessagePolicy

string

종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로

가능한 enum 값: - "FallbackToLogsOnError" 는 컨테이너가 오류와 함께 종료되면 컨테이너 상태 메시지에 대한 컨테이너 로그의 최신 내용을 읽습니다. - "File" 은 기본 동작이며 컨테이너가 종료될 때 컨테이너의 terminationMessagePath의 콘텐츠로 컨테이너 상태 메시지를 설정합니다.

TTY

boolean

이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다.

volumeDevices

array

volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.

volumeDevices[]

object

volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.

volumeMounts

array

컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로

volumeMounts[]

object

volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.

workingDir

string

컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로

15.1.96. .spec.template.spec.ephemeralContainers[].env

설명
컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
유형
array

15.1.97. .spec.template.spec.ephemeralContainers[].env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

EnvVarSource는 EnvVar 값의 소스를 나타냅니다.

15.1.98. .spec.template.spec.ephemeralContainers[].env[].valueFrom

설명
EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap에서 키를 선택합니다.

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

secretKeyRef

object

SecretKeySelector는 시크릿의 키를 선택합니다.

15.1.99. .spec.template.spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef

설명
ConfigMap에서 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.100. .spec.template.spec.ephemeralContainers[].env[].valueFrom.fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

15.1.101. .spec.template.spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

15.1.102. .spec.template.spec.ephemeralContainers[].env[].valueFrom.secretKeyRef

설명
SecretKeySelector는 시크릿의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.103. .spec.template.spec.ephemeralContainers[].envFrom

설명
컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
유형
array

15.1.104. .spec.template.spec.ephemeralContainers[].envFrom[]

설명
EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
유형
object
속성유형설명

configMapRef

object

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

prefix

string

ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다.

secretRef

object

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

15.1.105. .spec.template.spec.ephemeralContainers[].envFrom[].configMapRef

설명

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap을 정의해야 하는지 여부를 지정

15.1.106. .spec.template.spec.ephemeralContainers[].envFrom[].secretRef

설명

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

보안을 정의해야 하는지 여부를 지정합니다.

15.1.107. .spec.template.spec.ephemeralContainers[].lifecycle

설명
라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
유형
object
속성유형설명

postStart

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

preStop

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

15.1.108. .spec.template.spec.ephemeralContainers[].lifecycle.postStart

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

15.1.109. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.110. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.111. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.112. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.113. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.114. .spec.template.spec.ephemeralContainers[].lifecycle.preStop

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

15.1.115. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.116. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.117. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.118. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.119. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.120. .spec.template.spec.ephemeralContainers[].livenessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.121. .spec.template.spec.ephemeralContainers[].livenessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.122. .spec.template.spec.ephemeralContainers[].livenessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.123. .spec.template.spec.ephemeralContainers[].livenessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.124. .spec.template.spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.125. .spec.template.spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.126. .spec.template.spec.ephemeralContainers[].livenessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.127. .spec.template.spec.ephemeralContainers[].ports

설명
임시 컨테이너에는 포트가 허용되지 않습니다.
유형
array

15.1.128. .spec.template.spec.ephemeralContainers[].ports[]

설명
containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
유형
object
필수 항목
  • containerPort
속성유형설명

containerPort

integer

Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다.

hostIP

string

외부 포트를 바인딩할 호스트 IP는 무엇입니까.

hostPort

integer

호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다.

name

string

지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다.

protocol

string

포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

15.1.129. .spec.template.spec.ephemeralContainers[].readinessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.130. .spec.template.spec.ephemeralContainers[].readinessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.131. .spec.template.spec.ephemeralContainers[].readinessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.132. .spec.template.spec.ephemeralContainers[].readinessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.133. .spec.template.spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.134. .spec.template.spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.135. .spec.template.spec.ephemeralContainers[].readinessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.136. .spec.template.spec.ephemeralContainers[].resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

15.1.137. .spec.template.spec.ephemeralContainers[].securityContext

설명
securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
유형
object
속성유형설명

allowPrivilegeEscalation

boolean

allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

capabilities

object

실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.

privileged

boolean

권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

procMount

string

procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

readOnlyRootFilesystem

boolean

이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

15.1.138. .spec.template.spec.ephemeralContainers[].securityContext.capabilities

설명
실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
유형
object
속성유형설명

add

배열(문자열)

추가 기능

drop

배열(문자열)

제거된 기능

15.1.139. .spec.template.spec.ephemeralContainers[].securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

15.1.140. .spec.template.spec.ephemeralContainers[].securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

15.1.141. .spec.template.spec.ephemeralContainers[].securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

15.1.142. .spec.template.spec.ephemeralContainers[].startupProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.143. .spec.template.spec.ephemeralContainers[].startupProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.144. .spec.template.spec.ephemeralContainers[].startupProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.145. .spec.template.spec.ephemeralContainers[].startupProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.146. .spec.template.spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.147. .spec.template.spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.148. .spec.template.spec.ephemeralContainers[].startupProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.149. .spec.template.spec.ephemeralContainers[].volumeDevices

설명
volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.
유형
array

15.1.150. .spec.template.spec.ephemeralContainers[].volumeDevices[]

설명
volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.
유형
object
필수 항목
  • name
  • devicePath
속성유형설명

devicePath

string

devicePath는 장치를 매핑할 컨테이너 내부의 경로입니다.

name

string

name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다

15.1.151. .spec.template.spec.ephemeralContainers[].volumeMounts

설명
컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로
유형
array

15.1.152. .spec.template.spec.ephemeralContainers[].volumeMounts[]

설명
volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • name
  • mountPath
속성유형설명

mountPath

string

볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다.

mountPropagation

string

mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다.

name

string

이는 볼륨 이름과 일치해야 합니다.

readOnly

boolean

true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다.

subPath

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

subPathExpr

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다.

15.1.153. .spec.template.spec.hostAliases

설명
hostAliases는 지정된 경우 Pod의 호스트 파일에 삽입될 호스트 및 IP의 선택적 목록입니다. 이는 non-hostNetwork Pod에만 유효합니다.
유형
array

15.1.154. .spec.template.spec.hostAliases[]

설명
HostAlias는 Pod의 호스트 파일에 항목으로 삽입될 IP와 호스트 이름 간의 매핑을 보유합니다.
유형
object
속성유형설명

호스트 이름

배열(문자열)

위 IP 주소에 대한 호스트 이름입니다.

ip

string

호스트 파일 항목의 IP 주소입니다.

15.1.155. .spec.template.spec.imagePullSecrets

설명
imagePullSecrets는 이 PodSpec에서 사용하는 이미지를 가져오는 데 사용할 동일한 네임스페이스의 시크릿에 대한 선택적 참조 목록입니다. 지정된 경우 이러한 시크릿은 사용할 수 있도록 개별 풀러 구현으로 전달됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod
유형
array

15.1.156. .spec.template.spec.imagePullSecrets[]

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.157. .spec.template.spec.initContainers

설명
Pod에 속하는 초기화 컨테이너 목록입니다. Init 컨테이너는 컨테이너가 시작되기 전에 실행됩니다. init 컨테이너가 실패하면 Pod가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너에서 고유해야 합니다. Init 컨테이너에는 Lifecycle 작업, 준비 상태 프로브, 활성 상태 프로브 또는 시작 프로브가 없을 수 있습니다. init 컨테이너의 resourceRequirements는 각 리소스 유형에 대해 가장 높은 요청/제한을 찾은 다음 해당 값의 최대값 또는 일반 컨테이너의 합계를 사용하여 스케줄링 중에 고려됩니다. 제한은 init 컨테이너에 유사한 방식으로 적용됩니다. init 컨테이너는 현재 추가 또는 제거할 수 없습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/
유형
array

15.1.158. .spec.template.spec.initContainers[]

설명
Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다.
유형
object
필수 항목
  • name
속성유형설명

args

배열(문자열)

진입점에 대한 인수입니다. 컨테이너 이미지의 CMD는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

command

배열(문자열)

ENTRYPOINT 배열. 쉘 내에서 실행되지 않습니다. 컨테이너 이미지의 ENTRYPOINT는 제공되지 않는 경우 사용됩니다. 컨테이너 환경을 사용하여 변수 참조 $(VAR_NAME)이 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

env

array

컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

envFrom

array

컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로

envFrom[]

object

EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.

image

string

컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다.

imagePullPolicy

string

이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images

가능한 열거 값: - "항상" 은 kubelet이 항상 최신 이미지를 가져오려고 시도한다는 것을 의미합니다. 가져오기에 실패하면 컨테이너가 실패합니다. - "IfNotPresent" 는 이미지가 디스크에 없는 경우 kubelet을 가져오는 것을 의미합니다. 이미지가 존재하지 않고 가져오기에 실패하면 컨테이너가 실패합니다. - "없음" 은 kubelet이 이미지를 가져오지 않지만 로컬 이미지만 사용한다는 것을 의미합니다. 이미지가 없으면 컨테이너가 실패합니다.

lifecycle

object

라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.

livenessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

name

string

DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로

포트

array

컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로

ports[]

object

containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.

readinessProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

securityContext

object

securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.

startupProbe

object

프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.

stdin

boolean

이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다.

stdinOnce

boolean

컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다.

terminationMessagePath

string

선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로

terminationMessagePolicy

string

종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로

가능한 enum 값: - "FallbackToLogsOnError" 는 컨테이너가 오류와 함께 종료되면 컨테이너 상태 메시지에 대한 컨테이너 로그의 최신 내용을 읽습니다. - "File" 은 기본 동작이며 컨테이너가 종료될 때 컨테이너의 terminationMessagePath의 콘텐츠로 컨테이너 상태 메시지를 설정합니다.

TTY

boolean

이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다.

volumeDevices

array

volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.

volumeDevices[]

object

volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.

volumeMounts

array

컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로

volumeMounts[]

object

volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.

workingDir

string

컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로

15.1.159. .spec.template.spec.initContainers[].env

설명
컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
유형
array

15.1.160. .spec.template.spec.initContainers[].env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

EnvVarSource는 EnvVar 값의 소스를 나타냅니다.

15.1.161. .spec.template.spec.initContainers[].env[].valueFrom

설명
EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap에서 키를 선택합니다.

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

secretKeyRef

object

SecretKeySelector는 시크릿의 키를 선택합니다.

15.1.162. .spec.template.spec.initContainers[].env[].valueFrom.configMapKeyRef

설명
ConfigMap에서 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.163. .spec.template.spec.initContainers[].env[].valueFrom.fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

15.1.164. .spec.template.spec.initContainers[].env[].valueFrom.resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

15.1.165. .spec.template.spec.initContainers[].env[].valueFrom.secretKeyRef

설명
SecretKeySelector는 시크릿의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.166. .spec.template.spec.initContainers[].envFrom

설명
컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
유형
array

15.1.167. .spec.template.spec.initContainers[].envFrom[]

설명
EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
유형
object
속성유형설명

configMapRef

object

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

prefix

string

ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다.

secretRef

object

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

15.1.168. .spec.template.spec.initContainers[].envFrom[].configMapRef

설명

ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.

대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

ConfigMap을 정의해야 하는지 여부를 지정

15.1.169. .spec.template.spec.initContainers[].envFrom[].secretRef

설명

SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.

대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.

유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

보안을 정의해야 하는지 여부를 지정합니다.

15.1.170. .spec.template.spec.initContainers[].lifecycle

설명
라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
유형
object
속성유형설명

postStart

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

preStop

object

LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.

15.1.171. .spec.template.spec.initContainers[].lifecycle.postStart

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

15.1.172. .spec.template.spec.initContainers[].lifecycle.postStart.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.173. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.174. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.175. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.176. .spec.template.spec.initContainers[].lifecycle.postStart.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.177. .spec.template.spec.initContainers[].lifecycle.preStop

설명
LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

15.1.178. .spec.template.spec.initContainers[].lifecycle.preStop.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.179. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.180. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.181. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.182. .spec.template.spec.initContainers[].lifecycle.preStop.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.183. .spec.template.spec.initContainers[].livenessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.184. .spec.template.spec.initContainers[].livenessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.185. .spec.template.spec.initContainers[].livenessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.186. .spec.template.spec.initContainers[].livenessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.187. .spec.template.spec.initContainers[].livenessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.188. .spec.template.spec.initContainers[].livenessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.189. .spec.template.spec.initContainers[].livenessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.190. .spec.template.spec.initContainers[].ports

설명
컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로
유형
array

15.1.191. .spec.template.spec.initContainers[].ports[]

설명
containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
유형
object
필수 항목
  • containerPort
속성유형설명

containerPort

integer

Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다.

hostIP

string

외부 포트를 바인딩할 호스트 IP는 무엇입니까.

hostPort

integer

호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다.

name

string

지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다.

protocol

string

포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.

가능한 열거 값: - "SCTP" 는 SCTP 프로토콜입니다. - "TCP" 는 TCP 프로토콜입니다. - "UDP" 는 UDP 프로토콜입니다.

15.1.192. .spec.template.spec.initContainers[].readinessProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.193. .spec.template.spec.initContainers[].readinessProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.194. .spec.template.spec.initContainers[].readinessProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.195. .spec.template.spec.initContainers[].readinessProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.196. .spec.template.spec.initContainers[].readinessProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.197. .spec.template.spec.initContainers[].readinessProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.198. .spec.template.spec.initContainers[].readinessProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.199. .spec.template.spec.initContainers[].resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

15.1.200. .spec.template.spec.initContainers[].securityContext

설명
securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
유형
object
속성유형설명

allowPrivilegeEscalation

boolean

allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

capabilities

object

실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.

privileged

boolean

권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

procMount

string

procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

readOnlyRootFilesystem

boolean

이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

15.1.201. .spec.template.spec.initContainers[].securityContext.capabilities

설명
실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
유형
object
속성유형설명

add

배열(문자열)

추가 기능

drop

배열(문자열)

제거된 기능

15.1.202. .spec.template.spec.initContainers[].securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

15.1.203. .spec.template.spec.initContainers[].securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

15.1.204. .spec.template.spec.initContainers[].securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

15.1.205. .spec.template.spec.initContainers[].startupProbe

설명
프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
유형
object
속성유형설명

exec

object

ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.

failureThreshold

integer

성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다.

grpc

object

GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.

httpGet

object

HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.

initialDelaySeconds

integer

활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

periodSeconds

integer

프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다.

successThreshold

integer

프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다.

tcpSocket

object

TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.

terminationGracePeriodSeconds

integer

선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset.

timeoutSeconds

integer

프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes

15.1.206. .spec.template.spec.initContainers[].startupProbe.exec

설명
ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
유형
object
속성유형설명

command

배열(문자열)

명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다.

15.1.207. .spec.template.spec.initContainers[].startupProbe.grpc

설명
GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
유형
object
필수 항목
  • port
속성유형설명

port

integer

gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다.

서비스

string

service는 gRPC HealthCheckRequest에 배치할 서비스의 이름입니다( https://github.com/grpc/grpc/blob/master/doc/health-checking.md참조).

이 값을 지정하지 않으면 기본 동작은 gRPC에 의해 정의됩니다.

15.1.208. .spec.template.spec.initContainers[].startupProbe.httpGet

설명
HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다.

httpHeaders

array

요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.

httpHeaders[]

object

HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.

path

string

HTTP 서버에서 액세스할 경로입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

scheme

string

호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.

가능한 enum 값: - "HTTP" 는 사용된 스키마가 http:// - "HTTPS" 가 될 것임을 의미합니다. 이는 사용되는 스키마가 https://임을 의미합니다.

15.1.209. .spec.template.spec.initContainers[].startupProbe.httpGet.httpHeaders

설명
요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
유형
array

15.1.210. .spec.template.spec.initContainers[].startupProbe.httpGet.httpHeaders[]

설명
HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다.

value

string

헤더 필드 값

15.1.211. .spec.template.spec.initContainers[].startupProbe.tcpSocket

설명
TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
유형
object
필수 항목
  • port
속성유형설명

host

string

선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다.

port

IntOrString

컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다.

15.1.212. .spec.template.spec.initContainers[].volumeDevices

설명
volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다.
유형
array

15.1.213. .spec.template.spec.initContainers[].volumeDevices[]

설명
volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다.
유형
object
필수 항목
  • name
  • devicePath
속성유형설명

devicePath

string

devicePath는 장치를 매핑할 컨테이너 내부의 경로입니다.

name

string

name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다

15.1.214. .spec.template.spec.initContainers[].volumeMounts

설명
컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로
유형
array

15.1.215. .spec.template.spec.initContainers[].volumeMounts[]

설명
volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
유형
object
필수 항목
  • name
  • mountPath
속성유형설명

mountPath

string

볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다.

mountPropagation

string

mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다.

name

string

이는 볼륨 이름과 일치해야 합니다.

readOnly

boolean

true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다.

subPath

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다.

subPathExpr

string

컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다.

15.1.216. .spec.template.spec.os

설명
PodOS는 Pod의 OS 매개변수를 정의합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

운영 체제의 이름입니다.Is the name of the operating system. 현재 지원되는 값은 linux 및 windows입니다. 추가 값은 나중에 정의할 수 있으며 다음 중 하나일 수 있습니다. https://github.com/opencontainers/runtime-spec/blob/master/config.md#platform-specific-configuration 클라이언트는 추가 값을 처리하고 이 필드의 인식되지 않은 값을 os: null로 처리해야 합니다.

15.1.217. .spec.template.spec.readinessGates

설명
지정하면 Pod 준비 상태에 대한 모든 준비 상태 게이트가 평가됩니다. 모든 컨테이너가 준비되고 준비 게이트에 지정된 모든 조건이 "True" 추가 정보와 같은 상태가 있는 경우 Pod가 준비됩니다. https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates
유형
array

15.1.218. .spec.template.spec.readinessGates[]

설명
PodReadinessGate에는 Pod 상태에 대한 참조가 포함되어 있습니다.
유형
object
필수 항목
  • conditionType
속성유형설명

conditionType

string

conditionType은 일치하는 유형이 있는 Pod의 조건 목록의 조건을 나타냅니다.

15.1.219. .spec.template.spec.securityContext

설명
PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다.
유형
object
속성유형설명

fsGroup

integer

Pod의 모든 컨테이너에 적용되는 특수 추가 그룹입니다. 일부 볼륨 유형을 사용하면 Kubelet에서 해당 볼륨의 소유권을 Pod에서 소유하도록 변경할 수 있습니다.

1. GID를 소유하는 것은 FSGroup 2가 됩니다. setgid 비트가 설정되어 있습니다(볼륨에서 생성된 새 파일은 FSGroup에 의해 소유됨) 3. 권한 비트는 rw-rw----를 사용하여 또는d입니다.

설정되지 않은 경우 Kubelet은 볼륨의 소유권 및 권한을 수정하지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

fsGroupChangePolicy

string

fsGroupChangePolicy는 Pod 내부에서 노출되기 전에 볼륨의 소유권 및 권한 변경 동작을 정의합니다. 이 필드는 fsGroup 기반 소유권 및 권한을 지원하는 볼륨 유형에만 적용됩니다. secret, configmaps 및 emptydir과 같은 임시 볼륨 유형에는 영향을 미치지 않습니다. 유효한 값은 "OnRootMismatch" 및 "Always"입니다. 지정하지 않으면 "항상"이 사용됩니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsGroup

integer

컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

runAsNonRoot

boolean

컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

runAsUser

integer

컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

seLinuxOptions

object

seLinuxOptions는 컨테이너에 적용할 레이블입니다.

seccompProfile

object

seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.

supplementalGroups

배열(정수)

컨테이너의 기본 GID 외에도 각 컨테이너에서 첫 번째 프로세스에 적용되는 그룹 목록입니다. 지정되지 않은 경우 컨테이너에 그룹이 추가되지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

sysctls

array

sysctl에는 Pod에 사용되는 네임스페이스가 지정된 sysctl 목록이 있습니다. 지원되지 않는 sysctl이 있는 Pod(컨테이너 런타임별)가 시작되지 않을 수 있습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.

sysctls[]

object

sysctl은 설정할 커널 매개변수를 정의합니다.

windowsOptions

object

WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.

15.1.220. .spec.template.spec.securityContext.seLinuxOptions

설명
seLinuxOptions는 컨테이너에 적용할 레이블입니다.
유형
object
속성유형설명

level

string

level은 컨테이너에 적용되는 SELinux 수준 레이블입니다.

role

string

role은 컨테이너에 적용되는 SELinux 역할 레이블입니다.

type

string

type은 컨테이너에 적용되는 SELinux 유형 레이블입니다.

user

string

사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다.

15.1.221. .spec.template.spec.securityContext.seccompProfile

설명
seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

localhostProfile

string

localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다.

type

string

type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다.

localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.

가능한 열거 값: - "Localhost" 는 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. <kubelet-root-dir>/seccomp. - "RuntimeDefault" 는 기본 컨테이너 런타임 seccomp 프로필을 나타냅니다. - "Unconfined" 는 seccomp 프로필이 적용되지 않음을 나타냅니다(A.K.A. unconfined).

15.1.222. .spec.template.spec.securityContext.sysctls

설명
sysctl에는 Pod에 사용되는 네임스페이스가 지정된 sysctl 목록이 있습니다. 지원되지 않는 sysctl이 있는 Pod(컨테이너 런타임별)가 시작되지 않을 수 있습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다.
유형
array

15.1.223. .spec.template.spec.securityContext.sysctls[]

설명
sysctl은 설정할 커널 매개변수를 정의합니다.
유형
object
필수 항목
  • name
  • value
속성유형설명

name

string

설정할 속성의 이름

value

string

설정할 속성의 값

15.1.224. .spec.template.spec.securityContext.windowsOptions

설명
WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
유형
object
속성유형설명

gmsaCredentialSpec

string

CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa

gmsaCredentialSpecName

string

CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다.

hostProcess

boolean

HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다.

runAsUserName

string

컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다.

15.1.225. .spec.template.spec.tolerations

설명
지정된 경우 Pod의 허용 오차입니다.
유형
array

15.1.226. .spec.template.spec.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

가능한 enum 값: - "NoExecute" 테인트를 허용하지 않는 이미 실행 중인 Pod를 제거합니다. 현재 NodeController에서 강제 적용합니다. - "NoSchedule" 은 테인트를 허용하지 않는 한 새 pod를 노드에 예약할 수 없지만 스케줄러를 거치지 않고 Kubelet에 제출한 모든 Pod를 허용하고 이미 실행 중인 모든 Pod가 계속 실행되도록 허용합니다. 스케줄러에 의해 시행됩니다. - "PreferNoSchedule" TaintEffectNoSchedule과 같은 TaintEffectNoSchedule이지만 스케줄러는 새 Pod를 노드에 완전히 예약하지 않고 노드에 새 Pod를 예약하지 않습니다. 스케줄러에 의해 적용됩니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

가능한 열거 값: - "Equal" - "Exists"

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

15.1.227. .spec.template.spec.topologySpreadConstraints

설명
TopologySpreadConstraints는 Pod 그룹이 토폴로지 도메인에 분산되는 방법을 설명합니다. 스케줄러는 제약 조건에 따라 비활성화되는 방식으로 Pod를 예약합니다. 모든 topologySpreadConstraints는 ANDed입니다.
유형
array

15.1.228. .spec.template.spec.topologySpreadConstraints[]

설명
TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다.
유형
object
필수 항목
  • maxSkew
  • topologyKey
  • whenUnsatisfiable
속성유형설명

labelSelector

LabelSelector

labelSelector는 일치하는 포드를 찾는 데 사용됩니다. 이 라벨 선택기와 일치하는 Pod는 해당 토폴로지 도메인의 Pod 수를 확인하기 위해 계산됩니다.

matchLabelKeys

배열(문자열)

MatchLabelKeys는 분배를 계산할 Pod를 선택하는 Pod 레이블 키 집합입니다. 키는 들어오는 Pod 라벨에서 값을 조회하는 데 사용되며, 해당 키-값 레이블은 labelSelector와 함께 사용되어 들어오는 포드에 대해 분산이 계산될 기존 포드 그룹을 선택합니다. 들어오는 Pod 라벨에 없는 키는 무시됩니다. null 또는 빈 목록은 labelSelector와만 일치함을 의미합니다.

maxSkew

integer

MaxSkew는 Pod를 균등하게 배포할 수 있는 정도를 설명합니다. whenUnsatisfiable=DoNotSchedule 에서는 대상 토폴로지에서 일치하는 Pod 수와 글로벌 최소값 간에 허용되는 최대 차이입니다. 글로벌 최소는 적격 도메인의 일치하는 최소 Pod 수 또는 적격 도메인 수가 MinDomains보다 작은 경우 0입니다. 예를 들어 3 영역 클러스터에서 MaxSkew는 1로 설정되고 labelSelector가 2/2/1과 동일한 Pod가 있습니다. 이 경우 글로벌 최소값은 1입니다. | zone1 | zone2 | zone2 | zone3 | | P | P | - MaxSkew가 1이면 들어오는 Pod를 2/2/2가 되도록 영역3으로 예약할 수 있습니다. zone1(zone2)에 예약하면 zone1(zone2)이 MaxSkew(1)를 위반하면 최대Skew(1)를 위반할 수 있습니다. - 최대Skew(1)를 위반하면 최대Skew(1)를 예약할 수 있습니다. whenUnsatisfiable=ScheduleAnyway 는 이를 충족하는 토폴로지에 더 높은 우선 순위를 부여하는 데 사용됩니다. 필수 필드입니다. 기본값은 1이고 0은 허용되지 않습니다.

minDomains

integer

MinDomains는 적격 도메인의 최소 수를 나타냅니다. 토폴로지 키가 일치하는 적격 도메인의 수가 minDomains보다 작으면 Pod Topology Spread가 "global minimum"을 0으로 처리한 다음 Skew 계산을 수행합니다. 그리고 토폴로지 키가 일치하는 적격 도메인의 수가 minDomains보다 크거나 같으면 이 값은 예약에 영향을 미치지 않습니다. 결과적으로 적격 도메인의 수가 minDomains보다 작으면 스케줄러는 해당 도메인에 maxSkew Pod 이상을 예약하지 않습니다. value가 nil인 경우 제약 조건은 MinDomains가 1인 것처럼 작동합니다. 유효한 값은 0보다 큰 정수입니다. 값이 nil이 아닌 경우 WhenUnsatisfiable은 DoNotSchedule이어야 합니다.

예를 들어 3 영역 클러스터에서 MaxSkew는 2/2/2: | zone1 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | 5(MinDomains)로 처리되므로 "global minimum"은 0으로 설정됩니다. 이 경우 새 Pod가 세 영역으로 예약되는 경우 계산된 skew는 3(3 - 0)인 새 Pod를 예약할 수 없으므로 MaxSkew가 위반됩니다.

베타 필드이며 MinDomainsInPodTopologySpread 기능 게이트를 활성화해야 합니다(기본적으로 활성화).

nodeAffinityPolicy

string

NodeAffinityPolicy는 Pod 토폴로지 분배 skew를 계산할 때 Pod의 nodeAffinity/nodeSelector를 처리하는 방법을 나타냅니다. 옵션은: - Cryostat: nodeAffinity/nodeSelector와 일치하는 노드만 계산에 포함됩니다. - Ignore: nodeAffinity/nodeSelector는 무시됩니다. 모든 노드는 계산에 포함됩니다.

이 값이 nil인 경우 동작은 policy와 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다.

nodeTaintsPolicy

string

NodeTaintsPolicy는 Pod 토폴로지 분배 스큐를 계산할 때 노드 테인트를 처리하는 방법을 나타냅니다. 옵션은 다음과 같습니다: 테인트가 없는 노드와 함께 들어오는 Pod에 톨러레이션이 포함된 테인트 노드가 포함됩니다. - Ignore: 노드 테인트는 무시됩니다. 모든 노드가 포함됩니다.

이 값이 nil인 경우 동작은 Ignore 정책과 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다.

topologyKey

string

TopologyKey는 노드 라벨의 키입니다. 이 키와 동일한 값이 있는 라벨이 있는 노드는 동일한 토폴로지에 있는 것으로 간주됩니다. 각 <key, value>를 "bucket"으로 간주하고 각 버킷에 균형 있는 Pod 수를 배치하려고 합니다. 도메인을 토폴로지의 특정 인스턴스로 정의합니다. 또한 적격 도메인을 nodeAffinityPolicy 및 nodeTaintsPolicy의 요구 사항을 충족하는 도메인으로 정의합니다. 예를 들어 TopologyKey가 "kubernetes.io/hostname"인 경우 각 노드는 해당 토폴로지의 도메인입니다. 그리고 TopologyKey가 "topology.kubernetes.io/zone"인 경우 각 영역은 해당 토폴로지의 도메인입니다. 필수 필드입니다.

whenUnsatisfiable

string

whenUnsatisfiable은 spread 제약 조건을 충족하지 않는 경우 Pod를 처리하는 방법을 나타냅니다. - DoNotSchedule (default)은 스케줄러에 일정하지 않도록 지시합니다. - ScheduleAnyway는 모든 위치에서 Pod를 예약하도록 하지만 skew를 줄이는 데 도움이 되는 토폴로지에 더 높은 우선순위를 부여합니다. 제약 조건은 해당 Pod에 대한 가능한 모든 노드 할당이 일부 토폴로지에서 "MaxSkew"를 위반하는 경우에만 들어오는 Pod의 "Unsatisfiable"으로 간주됩니다. 예를 들어 3-zone 클러스터에서 MaxSkew는 1로 설정되고, 3/1/1: | zone1 | zone2 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | WhenUnsatisfiable이 설정된 경우, 들어오는 Pod는 zone2(zone3)로만 영역 2(zone3)로 설정되어 있고, 3/1/1: | zone1 | zone1 | zone3 | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | P | WhenUnsatisfiable이 DoNotSchedule으로 설정된 경우 들어오는 Pod는 zone2(zone3)로만 영역(zone3)으로 예약할 수 있습니다. 즉, 클러스터의 불균형을 여전히 조정할 수 있지만 스케줄러로 인해 더 많은 불균형이 발생하지 않습니다. 필수 필드입니다.

가능한 enum 값: - "DoNotSchedule" 은 제약 조건이 충족되지 않는 경우 Pod를 예약하지 않도록 스케줄러에 지시합니다. - "ScheduleAnyway" 는 제약 조건이 충족되지 않은 경우에도 스케줄러에 Pod를 예약하도록 지시합니다.

15.1.229. .spec.template.spec.volumes

설명
Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
유형
array

15.1.230. .spec.template.spec.volumes[]

설명
volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

awsElasticBlockStore

object

AWS의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

azureDisk

object

AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.

azureFile

object

AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.

cephfs

object

Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.

cinder

object

Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

configMap

object

ConfigMap을 볼륨에 조정합니다.

대상 ConfigMap의 Data 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. ConfigMap 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

csi

object

외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다.

downwardAPI

object

DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다.

emptyDir

object

Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

임시

object

일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다.

fc

object

파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

flexVolume

object

FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다.

flocker

object

Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.

gcePersistentDisk

object

Google Compute Engine의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

gitRepo

object

git 리포지토리의 콘텐츠로 채워지는 볼륨을 나타냅니다. Git 리포지토리 볼륨은 소유권 관리를 지원하지 않습니다. Git 리포지터리 볼륨은 SELinux 레이블 재지정을 지원합니다.

DEPRECATED: GitRepo는 더 이상 사용되지 않습니다. Git 리포지토리를 사용하여 컨테이너를 프로비저닝하려면 git을 사용하여 리포지터리를 복제하는 EmptyDir을 EmptyContainer에 마운트한 다음 EmptyDir을 Pod의 컨테이너에 마운트합니다.

GlusterFS

object

Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

hostPath

object

Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

iscsi

object

ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

name

string

볼륨의 이름입니다. DNS_LABEL이어야 하며 Pod 내에서 고유해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

nfs

object

Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

persistentVolumeClaim

object

PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다.

photonPersistentDisk

object

Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.

portworxVolume

object

PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.

예상됨

object

예상 볼륨 소스를 나타냅니다.

quobyte

object

Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

rbd

object

Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

scaleIO

object

scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.

Secret

object

시크릿을 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

storageos

object

StorageOS 영구 볼륨 리소스를 나타냅니다.

vsphereVolume

object

vSphere 볼륨 리소스를 나타냅니다.

15.1.231. .spec.template.spec.volumes[].awsElasticBlockStore

설명

AWS의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

파티션

integer

partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음).

readOnly

boolean

readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

volumeID는 AWS(Amazon EBS 볼륨)의 영구 디스크 리소스의 고유 ID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

15.1.232. .spec.template.spec.volumes[].azureDisk

설명
AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
유형
object
필수 항목
  • diskName
  • diskURI
속성유형설명

cachingMode

string

cachingMode는 Host Caching 모드입니다: None, Read Only, Read Write.

diskName

string

diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다.

diskURI

string

diskURI는 Blob 스토리지의 데이터 디스크 URI입니다.

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

kind

string

종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다.

readOnly

boolean

Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

15.1.233. .spec.template.spec.volumes[].azureFile

설명
AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
유형
object
필수 항목
  • secretName
  • shareName
속성유형설명

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretName

string

secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다.

shareName

string

sharename은 azure share Name입니다.

15.1.234. .spec.template.spec.volumes[].cephfs

설명
Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
유형
object
필수 항목
  • 모니터
속성유형설명

모니터

배열(문자열)

모니터는 필수 항목입니다. 모니터는 Ceph 모니터 모음입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

path는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다.

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

user

string

사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

15.1.235. .spec.template.spec.volumes[].cephfs.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.236. .spec.template.spec.volumes[].cinder

설명
Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

volumeID

string

cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

15.1.237. .spec.template.spec.volumes[].cinder.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.238. .spec.template.spec.volumes[].configMap

설명

ConfigMap을 볼륨에 조정합니다.

대상 ConfigMap의 Data 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. ConfigMap 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
속성유형설명

defaultMode

integer

defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

items

array

지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

선택 사항: ConfigMap 또는 해당 키를 정의해야 하는지 여부 지정

15.1.239. .spec.template.spec.volumes[].configMap.items

설명
지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

15.1.240. .spec.template.spec.volumes[].configMap.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

15.1.241. .spec.template.spec.volumes[].csi

설명
외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다.
유형
object
필수 항목
  • 드라이버
속성유형설명

드라이버

string

driver는 이 볼륨을 처리하는 CSI 드라이버의 이름입니다. 클러스터에 등록된 대로 올바른 이름은 관리자에게 문의하십시오.

fsType

string

마운트할 fstype. Ex. "ext4", "xfs", "ntfs". 제공되지 않는 경우 빈 값은 적용할 기본 파일 시스템을 결정하는 연결된 CSI 드라이버에 전달됩니다.

nodePublishSecretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

readOnly

boolean

readonly는 볼륨에 대한 읽기 전용 구성을 지정합니다. 기본값은 false(읽기/쓰기)입니다.

volumeAttributes

오브젝트(문자열)

volumeAttributes는 CSI 드라이버로 전달되는 드라이버별 속성을 저장합니다. 지원되는 값은 드라이버 설명서를 참조하십시오.

15.1.242. .spec.template.spec.volumes[].csi.nodePublishSecretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.243. .spec.template.spec.volumes[].downwardAPI

설명
DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다.
유형
object
속성유형설명

defaultMode

integer

선택 사항: 기본적으로 생성된 파일에서 사용할 모드 비트입니다. 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 선택 사항: 모드 비트여야 합니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

items

array

items는 Downward API 볼륨 파일 목록입니다.

items[]

object

DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.

15.1.244. .spec.template.spec.volumes[].downwardAPI.items

설명
items는 Downward API 볼륨 파일 목록입니다.
유형
array

15.1.245. .spec.template.spec.volumes[].downwardAPI.items[]

설명
DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.
유형
object
필수 항목
  • path
속성유형설명

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

mode

integer

선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

15.1.246. .spec.template.spec.volumes[].downwardAPI.items[].fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

15.1.247. .spec.template.spec.volumes[].downwardAPI.items[].resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

15.1.248. .spec.template.spec.volumes[].emptyDir

설명
Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
속성유형설명

중간

string

medium는 이 디렉터리를 백업해야 하는 스토리지 미디어 유형을 나타냅니다. 기본값은 ""이며 이는 노드의 기본 미디어를 사용하는 것을 의미합니다. 빈 문자열(기본값) 또는 메모리여야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#emptydir

sizeLimit

수량

sizeLimit은 이 EmptyDir 볼륨에 필요한 총 로컬 스토리지 양입니다. 크기 제한은 메모리 미디어에도 적용할 수 있습니다. 메모리 매체 EmptyDir의 최대 사용량은 여기에 지정된 SizeLimit와 Pod의 모든 컨테이너의 메모리 제한 합계 사이의 최소 값입니다. 기본값은 nil이며 이는 제한이 정의되지 않음을 의미합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/volumes#emptydir

15.1.249. .spec.template.spec.volumes[].ephemeral

설명
일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다.
유형
object
속성유형설명

volumeClaimTemplate

object

PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다.

15.1.250. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate

설명
PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다.
유형
object
필수 항목
  • spec
속성유형설명

메타데이터

ObjectMeta

해당 라벨을 생성할 때 PVC에 복사할 레이블 및 주석이 포함될 수 있습니다. 다른 필드는 허용되지 않으며 검증 중에 거부됩니다.

spec

object

PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.

15.1.251. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec

설명
PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.
유형
object
속성유형설명

accessModes

배열(문자열)

accessModes에는 볼륨에 필요한 액세스 모드가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

dataSource

object

TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

dataSourceRef

object

TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

resources

object

resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.

선택기

LabelSelector

selector는 바인딩에 대해 고려할 볼륨에 대한 레이블 쿼리입니다.

storageClassName

string

storageClassName은 클레임에 필요한 StorageClass의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1

volumeMode

string

volumeMode는 클레임에 필요한 볼륨 유형을 정의합니다. claim 사양에 포함되지 않은 경우 Filesystem의 값이 포함됩니다.

volumeName

string

volumeName은 이 클레임을 지원하는 PersistentVolume에 대한 바인딩 참조입니다.

15.1.252. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource

설명
TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiGroup

string

APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.

kind

string

kind는 참조되는 리소스 유형입니다.

name

string

name은 참조되는 리소스의 이름입니다.

15.1.253. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef

설명
TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • kind
  • name
속성유형설명

apiGroup

string

APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다.

kind

string

kind는 참조되는 리소스 유형입니다.

name

string

name은 참조되는 리소스의 이름입니다.

15.1.254. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources

설명
resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
유형
object
속성유형설명

limits

오브젝트(Quantity)

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

오브젝트(Quantity)

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

15.1.255. .spec.template.spec.volumes[].fc

설명
파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

lun

integer

LUN은 선택 사항입니다. FC 대상 lun 번호

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

targetWWNs

배열(문자열)

targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN)

wwids

배열(문자열)

WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다.

15.1.256. .spec.template.spec.volumes[].flexVolume

설명
FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • 드라이버
속성유형설명

드라이버

string

driver는 이 볼륨에 사용할 드라이버의 이름입니다.

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다.

options

오브젝트(문자열)

옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다.

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

15.1.257. .spec.template.spec.volumes[].flexVolume.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.258. .spec.template.spec.volumes[].flocker

설명
Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
유형
object
속성유형설명

datasetName

string

DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다.

datasetUUID

string

datasetUUID는 데이터 세트의 UUID입니다. Flocker 데이터 세트의 고유 식별자입니다.

15.1.259. .spec.template.spec.volumes[].gcePersistentDisk

설명

Google Compute Engine의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
필수 항목
  • pdName
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

파티션

integer

partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

string

pdName은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

15.1.260. .spec.template.spec.volumes[].gitRepo

설명

git 리포지토리의 콘텐츠로 채워지는 볼륨을 나타냅니다. Git 리포지토리 볼륨은 소유권 관리를 지원하지 않습니다. Git 리포지터리 볼륨은 SELinux 레이블 재지정을 지원합니다.

DEPRECATED: GitRepo는 더 이상 사용되지 않습니다. Git 리포지토리를 사용하여 컨테이너를 프로비저닝하려면 git을 사용하여 리포지터리를 복제하는 EmptyDir을 EmptyContainer에 마운트한 다음 EmptyDir을 Pod의 컨테이너에 마운트합니다.

유형
object
필수 항목
  • 리포지토리
속성유형설명

디렉터리

string

디렉터리는 대상 디렉터리 이름입니다. 포함하거나 '..'로 시작하지 않아야 합니다. '.'가 제공되면 볼륨 디렉터리가 git 리포지토리가 됩니다. 지정하지 않으면 볼륨에 지정된 이름이 있는 하위 디렉터리에 git 리포지토리가 포함됩니다.

리포지토리

string

리포지터리는 URL입니다.

버전

string

개정 버전은 지정된 버전의 커밋 해시입니다.

15.1.261. .spec.template.spec.volumes[].glusterfs

설명
Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • 끝점
  • path
속성유형설명

끝점

string

엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 Glusterfs 볼륨을 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

15.1.262. .spec.template.spec.volumes[].hostPath

설명
Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • path
속성유형설명

path

string

호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

HostPath Volume 기본값을 "" 추가 정보: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

15.1.263. .spec.template.spec.volumes[].iscsi

설명
ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • targetPortal
  • IQN
  • lun
속성유형설명

chapAuthDiscovery

boolean

chapAuthDiscovery는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다.

chapAuthSession

boolean

chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다.

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다.

IQN

string

IQN은 대상 iSCSI 정규화된 이름입니다.

iscsiInterface

string

iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다.

lun

integer

LUN은 iSCSI 대상 Lun 번호를 나타냅니다.

포털

배열(문자열)

포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260).

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

targetPortal

string

targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260).

15.1.264. .spec.template.spec.volumes[].iscsi.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.265. .spec.template.spec.volumes[].nfs

설명
Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • server
  • path
속성유형설명

path

string

NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

서버는 NFS 서버의 호스트 이름 또는 IP 주소입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

15.1.266. .spec.template.spec.volumes[].persistentVolumeClaim

설명
PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다.
유형
object
필수 항목
  • claimName
속성유형설명

claimName

string

claimName은 이 볼륨을 사용하는 Pod와 동일한 네임스페이스에 있는 PersistentVolumeClaim의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

readOnly

boolean

ReadOnly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본 false.

15.1.267. .spec.template.spec.volumes[].photonPersistentDisk

설명
Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
유형
object
필수 항목
  • pdID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

pdID

string

pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다.

15.1.268. .spec.template.spec.volumes[].portworxVolume

설명
PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. Ex. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

volumeID

string

volumeID는 Portworx 볼륨을 고유하게 식별합니다.

15.1.269. .spec.template.spec.volumes[].projected

설명
예상 볼륨 소스를 나타냅니다.
유형
object
속성유형설명

defaultMode

integer

defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

소스

array

소스는 볼륨 프로젝션의 목록입니다.

sources[]

object

다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션

15.1.270. .spec.template.spec.volumes[].projected.sources

설명
소스는 볼륨 프로젝션의 목록입니다.
유형
array

15.1.271. .spec.template.spec.volumes[].projected.sources[]

설명
다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션
유형
object
속성유형설명

configMap

object

ConfigMap을 예상 볼륨에 조정합니다.

대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다.

downwardAPI

object

예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다.

Secret

object

시크릿을 예상 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다.

serviceAccountToken

object

ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다.

15.1.272. .spec.template.spec.volumes[].projected.sources[].configMap

설명

ConfigMap을 예상 볼륨에 조정합니다.

대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다.

유형
object
속성유형설명

items

array

지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

선택 사항: ConfigMap 또는 해당 키를 정의해야 하는지 여부 지정

15.1.273. .spec.template.spec.volumes[].projected.sources[].configMap.items

설명
지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

15.1.274. .spec.template.spec.volumes[].projected.sources[].configMap.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

15.1.275. .spec.template.spec.volumes[].projected.sources[].downwardAPI

설명
예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다.
유형
object
속성유형설명

items

array

items는 DownwardAPIVolume 파일 목록입니다.

items[]

object

DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.

15.1.276. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items

설명
items는 DownwardAPIVolume 파일 목록입니다.
유형
array

15.1.277. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[]

설명
DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.
유형
object
필수 항목
  • path
속성유형설명

fieldRef

object

ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.

mode

integer

선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다.

resourceFieldRef

object

ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.

15.1.278. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef

설명
ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
유형
object
필수 항목
  • fieldPath
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 API 버전에서 선택할 필드의 경로입니다.

15.1.279. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef

설명
ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
유형
object
필수 항목
  • resource
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

수량

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

15.1.280. .spec.template.spec.volumes[].projected.sources[].secret

설명

시크릿을 예상 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다.

유형
object
속성유형설명

items

array

지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

optional

boolean

선택적 필드는 Secret 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

15.1.281. .spec.template.spec.volumes[].projected.sources[].secret.items

설명
지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

15.1.282. .spec.template.spec.volumes[].projected.sources[].secret.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

15.1.283. .spec.template.spec.volumes[].projected.sources[].serviceAccountToken

설명
ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다.
유형
object
필수 항목
  • path
속성유형설명

대상

string

audience는 토큰의 의도된 대상입니다. 토큰 수신자는 토큰 대상에 지정된 식별자로 자신을 식별해야 하며, 그렇지 않으면 토큰을 거부해야 합니다. 오디언스는 기본적으로 apiserver의 식별자입니다.

expirationSeconds

integer

expirationSeconds는 서비스 계정 토큰의 유효 기간입니다. 토큰이 만료되면 kubelet 볼륨 플러그인은 서비스 계정 토큰을 사전에 순환합니다. 토큰이 수명의 80% 이상을 경과했거나 24시간 이상된 경우 kubelet은 토큰을 순환하기 시작합니다.Defaults는 1시간 이상이며 최소 10분이어야 합니다.

path

string

path는 토큰을 프로젝션할 파일의 마운트 지점을 기준으로 하는 경로입니다.

15.1.284. .spec.template.spec.volumes[].quobyte

설명
Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • 레지스트리
  • volume
속성유형설명

group

string

볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다.

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다.

레지스트리

string

registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨)

tenant

string

백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다.

user

string

사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다.

volume

string

volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다.

15.1.285. .spec.template.spec.volumes[].rbd

설명
Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • 모니터
  • image
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd

image

string

image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

키 링

string

인증 키는 RBDUser의 키 링의 경로입니다. 기본값은 /etc/ceph/keyring입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

모니터

배열(문자열)

모니터는 Ceph 모니터의 컬렉션입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

pool

string

pool은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

user

string

사용자는 rados 사용자 이름입니다. 기본값은 admin입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

15.1.286. .spec.template.spec.volumes[].rbd.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.287. .spec.template.spec.volumes[].scaleIO

설명
scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.
유형
object
필수 항목
  • gateway
  • system
  • secretRef
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다.

gateway

string

Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다.

protectionDomain

string

protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다.

readOnly

boolean

Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

sslEnabled

boolean

sslEnabled Flag enable/disable SSL communication with Gateway, default false

storageMode

string

storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다.

storagePool

string

StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다.

system

string

시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다.

volumeName

string

volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다.

15.1.288. .spec.template.spec.volumes[].scaleIO.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.289. .spec.template.spec.volumes[].secret

설명

시크릿을 볼륨에 조정합니다.

대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
속성유형설명

defaultMode

integer

defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

items

array

지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.

items[]

object

문자열 키를 볼륨 내 경로에 매핑합니다.

optional

boolean

선택적 필드는 Secret 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

secretName

string

secretName은 사용할 Pod의 네임스페이스의 시크릿 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret

15.1.290. .spec.template.spec.volumes[].secret.items

설명
지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
유형
array

15.1.291. .spec.template.spec.volumes[].secret.items[]

설명
문자열 키를 볼륨 내 경로에 매핑합니다.
유형
object
필수 항목
  • key
  • path
속성유형설명

key

string

key는 프로젝트의 핵심입니다.

mode

integer

mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다.

path

string

path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다.

15.1.292. .spec.template.spec.volumes[].storageos

설명
StorageOS 영구 볼륨 리소스를 나타냅니다.
유형
object
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

volumeName

string

volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다.

volumeNamespace

string

volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다.

15.1.293. .spec.template.spec.volumes[].storageos.secretRef

설명
LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

15.1.294. .spec.template.spec.volumes[].vsphereVolume

설명
vSphere 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • volumePath
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

storagePolicyID

string

storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다.

storagePolicyName

string

storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다.

volumePath

string

volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다.

15.1.295. .status

설명
ReplicationControllerStatus는 복제 컨트롤러의 현재 상태를 나타냅니다.
유형
object
필수 항목
  • replicas
속성유형설명

availableReplicas

integer

이 복제 컨트롤러에 대해 사용 가능한 복제본 수(최소 minReadySeconds) 수입니다.

conditions

array

복제 컨트롤러의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

ReplicationControllerCondition은 특정 시점에서 복제 컨트롤러의 상태를 설명합니다.

fullyLabeledReplicas

integer

복제 컨트롤러의 Pod 템플릿 레이블과 일치하는 라벨이 있는 Pod 수입니다.

observedGeneration

integer

observedGeneration은 가장 최근에 관찰된 복제 컨트롤러의 생성을 반영합니다.

readyReplicas

integer

이 복제 컨트롤러에 대해 준비된 복제본 수입니다.

replicas

integer

복제본은 가장 최근에 모호한 복제본 수입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#what-is-a-replicationcontroller

15.1.296. .status.conditions

설명
복제 컨트롤러의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

15.1.297. .status.conditions[]

설명
ReplicationControllerCondition은 특정 시점에서 복제 컨트롤러의 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

복제 컨트롤러 조건 유형입니다.

15.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /api/v1/replicationcontrollers

    • GET: ReplicationController 유형의 오브젝트 목록 또는 감시
  • /api/v1/watch/replicationcontrollers

    • GET: individual changes to a list of ReplicationController. deprecated: 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /api/v1/namespaces/{namespace}/replicationcontrollers

    • DELETE: ReplicationController의 컬렉션 삭제
    • GET: ReplicationController 유형의 오브젝트 목록 또는 감시
    • POST: ReplicationController 생성
  • /api/v1/watch/namespaces/{namespace}/replicationcontrollers

    • GET: individual changes to a list of ReplicationController. deprecated: 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

    • DELETE: ReplicationController 삭제
    • GET: 지정된 ReplicationController 읽기
    • PATCH: 지정된 ReplicationController를 부분적으로 업데이트
    • PUT: 지정된 ReplicationController를 교체
  • /api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name}

    • GET: ReplicationController 유형의 오브젝트 변경 사항을 조사합니다. 더 이상 사용되지 않는 오브젝트: 'fieldSelector' 매개 변수를 사용하여 목록 작업과 함께 'watch' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

    • GET: 지정된 ReplicationController의 읽기
    • PATCH: 지정된 ReplicationController의 부분적으로 업데이트
    • PUT: 지정된 ReplicationController의 상태

15.2.1. /api/v1/replicationcontrollers

표 15.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicationController 유형의 오브젝트 나열 또는 감시
표 15.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationControllerList schema

401 - 무단

15.2.2. /api/v1/watch/replicationcontrollers

표 15.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicationController. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 15.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

15.2.3. /api/v1/namespaces/{namespace}/replicationcontrollers

표 15.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 15.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
ReplicationController의 컬렉션 삭제
표 15.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 15.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 15.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ReplicationController 유형의 오브젝트 나열 또는 감시
표 15.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 15.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationControllerList schema

401 - 무단

HTTP 방법
POST
설명
ReplicationController 만들기
표 15.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 15.13. 본문 매개변수
매개변수유형설명

body

ReplicationController 스키마

 
표 15.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController 스키마

201 - 생성됨

ReplicationController 스키마

202 - 승인됨

ReplicationController 스키마

401 - 무단

15.2.4. /api/v1/watch/namespaces/{namespace}/replicationcontrollers

표 15.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 15.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicationController. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 15.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

15.2.5. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

표 15.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

ReplicationController의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 15.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
ReplicationController 삭제
표 15.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 15.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 15.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ReplicationController 읽기
표 15.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ReplicationController를 부분적으로 업데이트
표 15.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 15.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 15.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController schema

201 - 생성됨

ReplicationController schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ReplicationController를 교체
표 15.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 15.28. 본문 매개변수
매개변수유형설명

body

ReplicationController schema

 
표 15.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController schema

201 - 생성됨

ReplicationController schema

401 - 무단

15.2.6. /api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name}

표 15.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

ReplicationController의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 15.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicationController. deprecated 유형의 개체 변경 사항을 감시합니다. 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링되어 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 15.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

15.2.7. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

표 15.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

ReplicationController의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 15.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 ReplicationController의 읽기 상태
표 15.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ReplicationController의 상태를 부분적으로 업데이트
표 15.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 15.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 15.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController 스키마

201 - 생성됨

ReplicationController 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ReplicationController의 상태 교체
표 15.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 15.40. 본문 매개변수
매개변수유형설명

body

ReplicationController 스키마

 
표 15.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicationController 스키마

201 - 생성됨

ReplicationController 스키마

401 - 무단

16장. PersistentVolume [v1]

설명
PV(PersistentVolume)는 관리자가 프로비저닝한 스토리지 리소스입니다. 이는 노드와 유사합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes
유형
object

16.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

PersistentVolumeSpec은 영구 볼륨의 사양입니다.

status

object

PersistentVolumeStatus는 영구 볼륨의 현재 상태입니다.

16.1.1. .spec

설명
PersistentVolumeSpec은 영구 볼륨의 사양입니다.
유형
object
속성유형설명

accessModes

배열(문자열)

accessModes에는 볼륨을 마운트할 수 있는 모든 방법이 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes

awsElasticBlockStore

object

AWS의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

azureDisk

object

AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.

azureFile

object

AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.

capacity

오브젝트(Quantity)

capacity는 영구 볼륨의 리소스 및 용량에 대한 설명입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity

cephfs

object

Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.

cinder

object

Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

claimRef

object

ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.

csi

object

외부 CSI 볼륨 드라이버(베타 기능)에서 관리하는 스토리지를 나타냅니다.

fc

object

파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

flexVolume

object

exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 영구 볼륨 리소스를 나타냅니다.

flocker

object

Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.

gcePersistentDisk

object

Google Compute Engine의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

GlusterFS

object

Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

hostPath

object

Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

iscsi

object

ISCSIPersistentVolumeSource는 ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

로컬

object

local은 노드 유사성을 사용하여 직접 연결된 스토리지를 나타냅니다(베타 기능)

mountOptions

배열(문자열)

mountOptions는 마운트 옵션 목록입니다(예: ["ro", "soft"]). 검증되지 않음 - 마운트가 유효하지 않은 경우 간단히 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options

nfs

object

Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

nodeAffinity

object

VolumeNodeAffinity는 이 볼륨에 액세스할 수 있는 노드를 제한하는 제약 조건을 정의합니다.

persistentVolumeReclaimPolicy

string

persistentVolumeReclaimPolicy는 클레임에서 릴리스될 때 영구 볼륨에 어떤 일이 발생하는지 정의합니다. 유효한 옵션은 Retain(수동으로 생성된 PersistentVolumes의 기본값), Delete( dynamically provisioned PersistentVolumes) 및 Recycle(더 이상 사용되지 않음)입니다. 이 PersistentVolume 기본 볼륨 플러그인에서 recycle를 지원해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming

가능한 열거 값: - "삭제" 는 릴리스 시 해당 클레임에서 볼륨이 Kubernetes에서 삭제됨을 의미합니다. 볼륨 플러그인은 Deletion을 지원해야 합니다. - "Recycle" 은 볼륨이 클레임에서 릴리스 시 바인딩되지 않은 영구 볼륨 풀로 다시 재활용됨을 의미합니다. 볼륨 플러그인은 Recycling을 지원해야 합니다. - "Retain" 은 관리자가 수동 회수를 위해 볼륨이 현재 단계(Released)에 남아 있음을 의미합니다. 기본 정책은 Retain입니다.

photonPersistentDisk

object

Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.

portworxVolume

object

PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.

quobyte

object

Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.

rbd

object

Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

scaleIO

object

scaleIOPersistentVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.

storageClassName

string

storageClassName은 이 영구 볼륨이 속한 StorageClass의 이름입니다. 빈 값은 이 볼륨이 StorageClass에 속하지 않음을 의미합니다.

storageos

object

StorageOS 영구 볼륨 리소스를 나타냅니다.

volumeMode

string

volumeMode는 볼륨이 포맷된 파일 시스템과 함께 사용되는지 또는 원시 블록 상태로 유지되도록 하는지를 정의합니다. spec에 포함되지 않은 경우 Filesystem의 값이 포함됩니다.

vsphereVolume

object

vSphere 볼륨 리소스를 나타냅니다.

16.1.2. .spec.awsElasticBlockStore

설명

AWS의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

파티션

integer

partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음).

readOnly

boolean

readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

volumeID

string

volumeID는 AWS(Amazon EBS 볼륨)의 영구 디스크 리소스의 고유 ID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

16.1.3. .spec.azureDisk

설명
AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
유형
object
필수 항목
  • diskName
  • diskURI
속성유형설명

cachingMode

string

cachingMode는 Host Caching 모드입니다: None, Read Only, Read Write.

diskName

string

diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다.

diskURI

string

diskURI는 Blob 스토리지의 데이터 디스크 URI입니다.

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

kind

string

종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다.

readOnly

boolean

Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

16.1.4. .spec.azureFile

설명
AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
유형
object
필수 항목
  • secretName
  • shareName
속성유형설명

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretName

string

secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다.

secretNamespace

string

secretNamespace는 Azure Storage 계정 이름이 포함된 시크릿의 네임스페이스이며 Key 기본값은 Pod와 동일합니다.

shareName

string

공유 이름은 azure Share Name입니다.

16.1.5. .spec.cephfs

설명
Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
유형
object
필수 항목
  • 모니터
속성유형설명

모니터

배열(문자열)

모니터는 필수 항목입니다. 모니터는 Ceph 모니터 모음입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

path

string

path는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다.

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretFile

string

secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

secretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

user

string

사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it

16.1.6. .spec.cephfs.secretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.7. .spec.cinder

설명
Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

마운트할 fstype 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

secretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

volumeID

string

cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md

16.1.8. .spec.cinder.secretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.9. .spec.claimRef

설명
ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

16.1.10. .spec.csi

설명
외부 CSI 볼륨 드라이버(베타 기능)에서 관리하는 스토리지를 나타냅니다.
유형
object
필수 항목
  • 드라이버
  • volumeHandle
속성유형설명

controllerExpandSecretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

controllerPublishSecretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

드라이버

string

driver는 이 볼륨에 사용할 드라이버의 이름입니다. 필수 항목입니다.

fsType

string

마운트할 fstype. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs".

nodeExpandSecretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

nodePublishSecretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

nodeStageSecretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

readOnly

boolean

ControllerPublishVolumeRequest에 전달할 읽기 전용 값입니다. 기본값은 false(읽기/쓰기)입니다.

volumeAttributes

오브젝트(문자열)

게시할 볼륨의 volumeAttributes입니다.

volumeHandle

string

volumeHandle은 모든 후속 호출에서 볼륨을 참조하기 위해 CSI 볼륨 플러그인의 CreateVolume에서 반환한 고유한 볼륨 이름입니다. 필수 항목입니다.

16.1.11. .spec.csi.controllerExpandSecretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.12. .spec.csi.controllerPublishSecretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.13. .spec.csi.nodeExpandSecretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.14. .spec.csi.nodePublishSecretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.15. .spec.csi.nodeStageSecretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.16. .spec.fc

설명
파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

lun

integer

LUN은 선택 사항입니다. FC 대상 lun 번호

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

targetWWNs

배열(문자열)

targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN)

wwids

배열(문자열)

WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다.

16.1.17. .spec.flexVolume

설명
exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 영구 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • 드라이버
속성유형설명

드라이버

string

driver는 이 볼륨에 사용할 드라이버의 이름입니다.

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다.

options

오브젝트(문자열)

옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다.

readOnly

boolean

readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

16.1.18. .spec.flexVolume.secretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.19. .spec.flocker

설명
Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
유형
object
속성유형설명

datasetName

string

DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다.

datasetUUID

string

datasetUUID는 데이터 세트의 UUID입니다. Flocker 데이터 세트의 고유 식별자입니다.

16.1.20. .spec.gcePersistentDisk

설명

Google Compute Engine의 영구 디스크 리소스를 나타냅니다.

컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.

유형
object
필수 항목
  • pdName
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

파티션

integer

partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

pdName

string

pdName은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

16.1.21. .spec.glusterfs

설명
Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • 끝점
  • path
속성유형설명

끝점

string

엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

endpointsNamespace

string

endpointNamespace는 Glusterfs 끝점이 포함된 네임스페이스입니다. 이 필드가 비어 있으면 EndpointNamespace의 기본값은 바인딩된 PVC와 동일한 네임스페이스로 설정됩니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

path

string

path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 Glusterfs 볼륨을 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

16.1.22. .spec.hostPath

설명
Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • path
속성유형설명

path

string

호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath

type

string

HostPath Volume 기본값을 "" 추가 정보: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

16.1.23. .spec.iscsi

설명
ISCSIPersistentVolumeSource는 ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • targetPortal
  • IQN
  • lun
속성유형설명

chapAuthDiscovery

boolean

chapAuthDiscovery는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다.

chapAuthSession

boolean

chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다.

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi

initiatorName

string

initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다.

iqn

string

IQN은 대상 iSCSI 정규화된 이름입니다.

iscsiInterface

string

iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다.

LUN

integer

LUN은 iSCSI 대상 Lun 번호입니다.

포털

배열(문자열)

포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260).

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다.

secretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

targetPortal

string

targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260).

16.1.24. .spec.iscsi.secretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.25. .spec.local

설명
local은 노드 유사성을 사용하여 직접 연결된 스토리지를 나타냅니다(베타 기능)
유형
object
필수 항목
  • path
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 경로가 블록 장치인 경우에만 적용됩니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 지정되지 않은 경우 파일 시스템을 자동 선택하는 것입니다.

path

string

노드의 전체 볼륨 경로입니다. 디렉터리 또는 블록 장치(디스크, 파티션, …​)일 수 있습니다.

16.1.26. .spec.nfs

설명
Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • server
  • path
속성유형설명

path

string

NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

server

string

서버는 NFS 서버의 호스트 이름 또는 IP 주소입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs

16.1.27. .spec.nodeAffinity

설명
VolumeNodeAffinity는 이 볼륨에 액세스할 수 있는 노드를 제한하는 제약 조건을 정의합니다.
유형
object
속성유형설명

필수 항목

object

노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.

16.1.28. .spec.nodeAffinity.required

설명
노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
유형
object
필수 항목
  • nodeSelectorTerms
속성유형설명

nodeSelectorTerms

array

필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.

nodeSelectorTerms[]

object

null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.

16.1.29. .spec.nodeAffinity.required.nodeSelectorTerms

설명
필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다.
유형
array

16.1.30. .spec.nodeAffinity.required.nodeSelectorTerms[]

설명
null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
유형
object
속성유형설명

matchExpressions

array

노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.

matchExpressions[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchFields

array

노드의 필드별 노드 선택기 요구 사항 목록입니다.

matchFields[]

object

노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

16.1.31. .spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions

설명
노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
유형
array

16.1.32. .spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

16.1.33. .spec.nodeAffinity.required.nodeSelectorTerms[].matchFields

설명
노드의 필드별 노드 선택기 요구 사항 목록입니다.
유형
array

16.1.34. .spec.nodeAffinity.required.nodeSelectorTerms[].matchFields[]

설명
노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
유형
object
필수 항목
  • key
  • operator
속성유형설명

key

string

선택기가 적용되는 라벨 키입니다.

operator

string

값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.

가능한 열거 값: - "DoesNotExist" - "Exists" - "Gt" - "In" - "Lt" - "NotIn"

배열(문자열)

문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

16.1.35. .spec.photonPersistentDisk

설명
Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
유형
object
필수 항목
  • pdID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

pdID

string

pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다.

16.1.36. .spec.portworxVolume

설명
PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • volumeID
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. Ex. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

volumeID

string

volumeID는 Portworx 볼륨을 고유하게 식별합니다.

16.1.37. .spec.quobyte

설명
Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
유형
object
필수 항목
  • 레지스트리
  • volume
속성유형설명

group

string

볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다.

readOnly

boolean

여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다.

레지스트리

string

registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨)

tenant

string

백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다.

user

string

사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다.

volume

string

volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다.

16.1.38. .spec.rbd

설명
Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
유형
object
필수 항목
  • 모니터
  • image
속성유형설명

fsType

string

fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd

image

string

image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

키 링

string

인증 키는 RBDUser의 키 링의 경로입니다. 기본값은 /etc/ceph/keyring입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

모니터

배열(문자열)

모니터는 Ceph 모니터의 컬렉션입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

pool

string

pool은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

readOnly

boolean

여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

secretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

user

string

사용자는 rados 사용자 이름입니다. 기본값은 admin입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it

16.1.39. .spec.rbd.secretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.40. .spec.scaleIO

설명
scaleIOPersistentVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.
유형
object
필수 항목
  • gateway
  • system
  • secretRef
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다.

gateway

string

Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다.

protectionDomain

string

protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

sslEnabled

boolean

sslEnabled는 게이트웨이와 SSL 통신을 활성화/비활성화하는 플래그이며 기본 false

storageMode

string

storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다.

storagePool

string

StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다.

system

string

시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다.

volumeName

string

volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다.

16.1.41. .spec.scaleIO.secretRef

설명
SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
유형
object
속성유형설명

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

16.1.42. .spec.storageos

설명
StorageOS 영구 볼륨 리소스를 나타냅니다.
유형
object
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

readOnly

boolean

readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다.

secretRef

object

ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.

volumeName

string

volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다.

volumeNamespace

string

volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다.

16.1.43. .spec.storageos.secretRef

설명
ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
속성유형설명

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

16.1.44. .spec.vsphereVolume

설명
vSphere 볼륨 리소스를 나타냅니다.
유형
object
필수 항목
  • volumePath
속성유형설명

fsType

string

fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다.

storagePolicyID

string

storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다.

storagePolicyName

string

storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다.

volumePath

string

volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다.

16.1.45. .status

설명
PersistentVolumeStatus는 영구 볼륨의 현재 상태입니다.
유형
object
속성유형설명

message

string

message는 볼륨이 이 상태에 있는 이유에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

phase

string

phase는 볼륨을 사용할 수 있는지, 클레임에 바인딩되었는지 또는 클레임에 의해 해제되었는지를 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase

가능한 enum 값: - 아직 사용 가능한 볼륨이 아직 바인딩되지 않은 PersistentVolumes에 사용되는 "Available" 은 binder에 의해 유지되며 PersistentVolumeClaims와 일치하며, 바인딩되는 PersistentVolumes에 사용되는 "Bound", PersistentVolumes에 사용되는 "Failed" 는 PersistentVolumes에 의해 해제되거나 해제된 후 올바르게 재활용되거나 삭제됩니다. 사용할 수 없는 PersistentVolumes에 사용되는 "Pending" - PersistentVolumes에 사용되는 "Released" 는 바인딩된 PersistentVolumeClaim이 해제된 볼륨을 재활용해야 하는 클레임이 사용되어야 합니다. 이 단계는 영구 볼륨 클레임 바인더에서 리소스를 회수하기 위해 다른 프로세스에 신호를 보내는 데 사용됩니다.

reason

string

이유는 오류를 설명하는 짧은 CamelCase 문자열이며 CLI에서 머신 구문 분석 및 tidy 표시를 의미합니다.

16.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /api/v1/persistentvolumes

    • DELETE: PersistentVolume 컬렉션 삭제
    • GET: PersistentVolume 유형의 오브젝트를 나열하거나 조사
    • POST: PersistentVolume 생성
  • /api/v1/watch/persistentvolumes

    • GET: PersistentVolume. deprecated 목록의 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /api/v1/persistentvolumes/{name}

    • DELETE: PersistentVolume 삭제
    • GET: 지정된 PersistentVolume 읽기
    • PATCH: 지정된 PersistentVolume을 부분적으로 업데이트
    • PUT: 지정된 PersistentVolume을 교체
  • /api/v1/watch/persistentvolumes/{name}

    • GET: PersistentVolume. deprecated 오브젝트의 변경 사항을 감시합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /api/v1/persistentvolumes/{name}/status

    • GET: 지정된 PersistentVolume의 읽기 상태
    • PATCH: 지정된 PersistentVolume의 부분적으로 업데이트
    • PUT: 지정된 PersistentVolume의 상태

16.2.1. /api/v1/persistentvolumes

표 16.1. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
PersistentVolume의 컬렉션 삭제
표 16.2. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 16.3. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 16.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
PersistentVolume 유형의 오브젝트 나열 또는 감시
표 16.5. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 16.6. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolumeList 스키마

401 - 무단

HTTP 방법
POST
설명
PersistentVolume 생성
표 16.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.8. 본문 매개변수
매개변수유형설명

body

PersistentVolume 스키마

 
표 16.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

201 - 생성됨

PersistentVolume 스키마

202 - 승인됨

PersistentVolume 스키마

401 - 무단

16.2.2. /api/v1/watch/persistentvolumes

표 16.10. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
PersistentVolume. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 16.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

16.2.3. /api/v1/persistentvolumes/{name}

표 16.12. 글로벌 경로 매개변수
매개변수유형설명

name

string

PersistentVolume의 이름

표 16.13. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
PersistentVolume 삭제
표 16.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 16.15. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 16.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

202 - 승인됨

PersistentVolume 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 PersistentVolume 읽기
표 16.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 PersistentVolume을 부분적으로 업데이트
표 16.18. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 16.19. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 16.20. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

201 - 생성됨

PersistentVolume 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 PersistentVolume을 교체
표 16.21. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.22. 본문 매개변수
매개변수유형설명

body

PersistentVolume 스키마

 
표 16.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

201 - 생성됨

PersistentVolume 스키마

401 - 무단

16.2.4. /api/v1/watch/persistentvolumes/{name}

표 16.24. 글로벌 경로 매개변수
매개변수유형설명

name

string

PersistentVolume의 이름

표 16.25. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
PersistentVolume. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 16.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

16.2.5. /api/v1/persistentvolumes/{name}/status

표 16.27. 글로벌 경로 매개변수
매개변수유형설명

name

string

PersistentVolume의 이름

표 16.28. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 PersistentVolume의 읽기 상태
표 16.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 PersistentVolume의 부분적으로 업데이트 상태
표 16.30. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 16.31. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 16.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

201 - 생성됨

PersistentVolume 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 PersistentVolume의 상태 교체
표 16.33. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 16.34. 본문 매개변수
매개변수유형설명

body

PersistentVolume 스키마

 
표 16.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

PersistentVolume 스키마

201 - 생성됨

PersistentVolume 스키마

401 - 무단

17장. ReplicaSet [apps/v1]

설명
ReplicaSet은 지정된 수의 Pod 복제본이 지정된 시간에 실행되도록 합니다.
유형
object

17.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

ReplicaSet의 라벨이 비어 있으면 ReplicaSet에서 관리하는 Pod와 동일하게 설정됩니다. 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

ReplicaSetSpec은 ReplicaSet의 사양입니다.

status

object

ReplicaSetStatus는 ReplicaSet의 현재 상태를 나타냅니다.

17.1.1. .spec

설명
ReplicaSetSpec은 ReplicaSet의 사양입니다.
유형
object
필수 항목
  • 선택기
속성유형설명

minReadySeconds

integer

컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)을 사용할 수 있습니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨)

replicas

integer

replicas는 원하는 복제본 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller

선택기

LabelSelector

selector는 복제본 수와 일치해야 하는 Pod의 레이블 쿼리입니다. 이 복제본 세트에서 제어하려면 일치해야 하는 레이블 키와 값입니다. Pod 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

템플릿

PodTemplateSpec

템플릿은 충분하지 않은 복제본이 감지되면 생성되는 Pod를 설명하는 오브젝트입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template

17.1.2. .status

설명
ReplicaSetStatus는 ReplicaSet의 현재 상태를 나타냅니다.
유형
object
필수 항목
  • replicas
속성유형설명

availableReplicas

integer

이 복제본 세트의 사용 가능한 복제본 수(최소 minReadySeconds) 수입니다.

conditions

array

복제본 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

ReplicaSetCondition은 특정 시점에서 복제본 세트의 상태를 설명합니다.

fullyLabeledReplicas

integer

replicaset의 Pod 템플릿 레이블과 일치하는 라벨이 있는 Pod 수입니다.

observedGeneration

integer

observedGeneration은 가장 최근에 관찰된 ReplicaSet의 생성을 반영합니다.

readyReplicas

integer

readyReplicas는 Ready 상태에서 이 ReplicaSet이 대상으로 하는 Pod 수입니다.

replicas

integer

복제본은 가장 최근에 모호한 복제본 수입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller

17.1.3. .status.conditions

설명
복제본 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

17.1.4. .status.conditions[]

설명
ReplicaSetCondition은 특정 시점에서 복제본 세트의 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

복제본 세트 조건의 유형입니다.

17.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps/v1/replicasets

    • GET: 종류의 ReplicaSet 오브젝트 목록 또는 감시
  • /apis/apps/v1/watch/replicasets

    • GET: individual changes to a list of ReplicaSet. deprecated: 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/replicasets

    • DELETE: ReplicaSet의 컬렉션 삭제
    • GET: 종류의 ReplicaSet 오브젝트 목록 또는 감시
    • POST: ReplicaSet 생성
  • /apis/apps/v1/watch/namespaces/{namespace}/replicasets

    • GET: individual changes to a list of ReplicaSet. deprecated: 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

    • DELETE: ReplicaSet 삭제
    • GET: 지정된 ReplicaSet 읽기
    • PATCH: 지정된 ReplicaSet을 부분적으로 업데이트
    • PUT: 지정된 ReplicaSet을 교체
  • /apis/apps/v1/watch/namespaces/{namespace}/replicasets/{name}

    • GET: kind ReplicaSet. deprecated 개체의 변경 사항을 조사합니다. 더 이상 사용되지 않는 'watch' 매개 변수를 목록 작업과 함께 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
  • /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

    • GET: 지정된 ReplicaSet의 읽기 상태
    • PATCH: 지정된 ReplicaSet의 부분 업데이트 상태
    • PUT: 지정된 ReplicaSet의 상태

17.2.1. /apis/apps/v1/replicasets

표 17.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicaSet 오브젝트 나열 또는 감시
표 17.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSetList schema

401 - 무단

17.2.2. /apis/apps/v1/watch/replicasets

표 17.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicaSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 17.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

17.2.3. /apis/apps/v1/namespaces/{namespace}/replicasets

표 17.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 17.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
ReplicaSet의 컬렉션 삭제
표 17.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 17.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 17.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ReplicaSet 오브젝트 나열 또는 감시
표 17.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 17.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSetList schema

401 - 무단

HTTP 방법
POST
설명
ReplicaSet 생성
표 17.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.13. 본문 매개변수
매개변수유형설명

body

ReplicaSet 스키마

 
표 17.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

201 - 생성됨

ReplicaSet 스키마

202 - 승인됨

ReplicaSet 스키마

401 - 무단

17.2.4. /apis/apps/v1/watch/namespaces/{namespace}/replicasets

표 17.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 17.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
ReplicaSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 17.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

17.2.5. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

표 17.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

ReplicaSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 17.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
ReplicaSet 삭제
표 17.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 17.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 17.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 ReplicaSet 읽기
표 17.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ReplicaSet을 부분적으로 업데이트
표 17.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 17.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 17.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

201 - 생성됨

ReplicaSet 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ReplicaSet을 교체
표 17.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.28. 본문 매개변수
매개변수유형설명

body

ReplicaSet 스키마

 
표 17.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

201 - 생성됨

ReplicaSet 스키마

401 - 무단

17.2.6. /apis/apps/v1/watch/namespaces/{namespace}/replicasets/{name}

표 17.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

ReplicaSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 17.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
더 이상 사용되지 않는 ReplicaSet의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 17.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

17.2.7. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

표 17.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

ReplicaSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 17.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 ReplicaSet의 읽기 상태
표 17.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ReplicaSet의 부분적으로 업데이트 상태
표 17.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 17.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 17.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

201 - 생성됨

ReplicaSet 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ReplicaSet의 상태 교체
표 17.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 17.40. 본문 매개변수
매개변수유형설명

body

ReplicaSet 스키마

 
표 17.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ReplicaSet 스키마

201 - 생성됨

ReplicaSet 스키마

401 - 무단

18장. StatefulSet [apps/v1]

설명

StatefulSet은 일관된 ID가 있는 Pod 세트를 나타냅니다. ID는 다음과 같이 정의됩니다. - 네트워크: 단일 안정적인 DNS 및 호스트 이름. - 스토리지: 요청된 만큼 많은 VolumeClaims입니다.

StatefulSet은 지정된 네트워크 ID가 항상 동일한 스토리지 ID에 매핑되도록 합니다.

유형
object

18.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

string

kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

StatefulSetSpec은 StatefulSet의 사양입니다.

status

object

StatefulSetStatus는 StatefulSet의 현재 상태를 나타냅니다.

18.1.1. .spec

설명
StatefulSetSpec은 StatefulSet의 사양입니다.
유형
object
필수 항목
  • 선택기
  • 템플릿
  • serviceName
속성유형설명

minReadySeconds

integer

새로 생성된 Pod를 사용할 수 있는 컨테이너 충돌 없이 준비해야 하는 최소 시간(초)입니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨)

persistentVolumeClaimRetentionPolicy

object

StatefulSetPersistentVolumeClaimRetentionPolicy는 StatefulSet VolumeClaimTemplates에서 생성된 PVC에 사용되는 정책을 설명합니다.

podManagementPolicy

string

podManagementPolicy는 초기 확장 중에 포드를 생성하는 방법, 노드에서 Pod를 교체할 때 또는 축소할 때 제어합니다. 기본 정책은 OrderedReady 입니다. 여기서 Pod는 증가 순서(pod-0, pod-1 등)로 생성되고 컨트롤러는 계속하기 전에 각 Pod가 준비될 때까지 기다립니다. 축소하면 Pod가 반대 순서로 제거됩니다. 대체 정책은 대기 없이 원하는 규모와 일치하도록 병렬로 Pod를 만드는 Parallel 이며 축소 시 모든 Pod가 한 번에 삭제됩니다.

가능한 enum 값: - "OrderedReady" 는 이전 Pod가 준비되거나 종료된 경우에만 진행되도록 스케일링 및 축소 시 주문을 엄격하게 늘립니다. 언제든지 하나의 Pod가 변경됩니다. - "Parallel" 은 상태 저장 세트 복제본 수가 변경되는 즉시 Pod를 생성 및 삭제하고 Pod가 준비되거나 종료될 때까지 기다리지 않습니다.

replicas

integer

replicas는 지정된 템플릿의 원하는 복제본 수입니다. 이러한 복제본은 동일한 템플릿을 인스턴스화한다는 점에서 복제본이지만 개별 복제본에는 일관된 ID도 있습니다. 지정되지 않은 경우 기본값은 1입니다.

revisionHistoryLimit

integer

revisionHistoryLimit은 StatefulSet의 버전 기록에서 유지 관리할 최대 버전 수입니다. 개정 내역은 현재 적용된 StatefulSetSpec 버전으로 표시되지 않는 모든 버전으로 구성됩니다. 기본값은 10입니다.

선택기

LabelSelector

selector는 복제본 수와 일치해야 하는 Pod의 레이블 쿼리입니다. Pod 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

serviceName

string

ServiceName은 이 StatefulSet을 관리하는 서비스의 이름입니다. 이 서비스는 StatefulSet 앞에 있어야 하며 세트의 네트워크 ID를 담당합니다. Pod는 statefulSet 컨트롤러에서 "pod-specific-string-string"을 관리하는 pod-specific-string.serviceName.default.svc.cluster.local 패턴을 따르는 DNS/호스트를 가져옵니다.

템플릿

PodTemplateSpec

템플릿은 충분하지 않은 복제본이 감지되면 생성되는 Pod를 설명하는 오브젝트입니다. StatefulSet에서 샘플링된 각 pod는 이 템플릿을 수행하지만 StatefulSet의 나머지 부분에서 고유한 ID가 있습니다.

updateStrategy

object

StatefulSetUpdateStrategy는 StatefulSet 컨트롤러가 업데이트를 수행하는 데 사용할 전략을 나타냅니다. 지정된 전략에 대한 업데이트를 수행하는 데 필요한 추가 매개변수가 포함되어 있습니다.

volumeClaimTemplates

배열(PersistentVolumeClaim)

VolumeClaimTemplates는 Pod가 참조할 수 있는 클레임 목록입니다. StatefulSet 컨트롤러는 Pod의 ID를 유지 관리하는 방식으로 네트워크 ID를 클레임에 매핑합니다. 이 목록의 모든 클레임에는 템플릿의 하나의 컨테이너에 일치하는 (이름별) volumeMount가 하나 이상 있어야 합니다. 이 목록의 클레임은 템플릿의 모든 볼륨보다 우선하며 이름이 같습니다.

18.1.2. .spec.persistentVolumeClaimRetentionPolicy

설명
StatefulSetPersistentVolumeClaimRetentionPolicy는 StatefulSet VolumeClaimTemplates에서 생성된 PVC에 사용되는 정책을 설명합니다.
유형
object
속성유형설명

whenDeleted

string

WhenDeleted는 StatefulSet VolumeClaimTemplates를 삭제할 때 StatefulSet VolumeClaimTemplates에서 생성된 PVC에 어떤 일이 발생하는지 지정합니다. Retain 의 기본 정책으로 인해 PVC가 StatefulSet 삭제의 영향을 받지 않습니다. Delete 정책으로 인해 해당 PVC가 삭제됩니다.

whenScaled

string

WhenScaled StatefulSet VolumeClaimTemplates 상태 저장 설정이 축소될 때 PVC에 발생하는 작업을 지정합니다. Retain 의 기본 정책으로 인해 PVC가 스케일 다운의 영향을 받지 않습니다. Delete 정책으로 인해 복제본 수 이상의 초과 Pod에 대한 연결된 PVC가 삭제됩니다.

18.1.3. .spec.updateStrategy

설명
StatefulSetUpdateStrategy는 StatefulSet 컨트롤러가 업데이트를 수행하는 데 사용할 전략을 나타냅니다. 지정된 전략에 대한 업데이트를 수행하는 데 필요한 추가 매개변수가 포함되어 있습니다.
유형
object
속성유형설명

rollingUpdate

object

RollingUpdateStatefulSetStrategy는 RollingUpdateStatefulSetStrategyType의 매개변수를 전달하는 데 사용됩니다.

type

string

type은 StatefulSetUpdateStrategy 유형을 나타냅니다. 기본값은 RollingUpdate입니다.

가능한 enum 값: - "OnDelete" 는 레거시 동작을 트리거합니다. 버전 추적 및 순서가 지정된 롤링 재시작은 비활성화되어 있습니다. Pod는 수동으로 삭제할 때 StatefulSetSpec에서 다시 생성됩니다. 이 전략으로 스케일링 작업을 수행하면 StatefulSet의 currentRevision에 표시된 특정 버전을 지정합니다. - "RollingUpdate" 는 StatefulSet 순서 제약 조건과 관련하여 StatefulSet의 모든 Pod에 업데이트가 적용됨을 나타냅니다. 이 전략을 사용하여 스케일링 작업을 수행하면 StatefulSet의 updateRevision으로 표시된 사양 버전에서 새 Pod가 생성됩니다.

18.1.4. .spec.updateStrategy.rollingUpdate

설명
RollingUpdateStatefulSetStrategy는 RollingUpdateStatefulSetStrategyType의 매개변수를 전달하는 데 사용됩니다.
유형
object
속성유형설명

maxUnavailable

IntOrString

업데이트 중에 사용할 수 없는 최대 Pod 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. 이 값은 0이 될 수 없습니다. 기본값은 1입니다. 이 필드는 알파 수준이며 MaxUnavailableStatefulSet 기능을 활성화하는 서버에서만 적용됩니다. 이 필드는 0~Replicas-1 범위의 모든 Pod에 적용됩니다. 즉, 0에서 Replicas-1 사이의 범위에 사용할 수 없는 Pod가 있는 경우 MaxUnavailable으로 계산됩니다.

파티션

integer

partition은 업데이트를 위해 StatefulSet을 분할해야 하는 ordinal을 나타냅니다. 롤링 업데이트 중에 ordinal Replicas-1에서 Partition으로 모든 Pod가 업데이트됩니다. ordinal Partition-1에서 0으로의 모든 Pod는 변경되지 않은 상태로 유지됩니다. 이 기능은 카나리아 기반 배포를 수행할 수 있는 데 유용합니다. 기본값은 0입니다.

18.1.5. .status

설명
StatefulSetStatus는 StatefulSet의 현재 상태를 나타냅니다.
유형
object
필수 항목
  • replicas
속성유형설명

availableReplicas

integer

이 statefulset에서 대상으로 하는 사용 가능한 총 Pod 수(최소 minReadySeconds) 수입니다.

collisionCount

integer

collisionCount는 StatefulSet의 해시 충돌 수입니다. StatefulSet 컨트롤러는 최신 ControllerRevision의 이름을 생성해야 하는 경우 이 필드를 충돌 방지 메커니즘으로 사용합니다.

conditions

array

상태 저장 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.

conditions[]

object

StatefulSetCondition은 특정 시점에서 상태 저장 설정 상태를 설명합니다.

currentReplicas

integer

currentReplicas는 currentRevision으로 표시된 StatefulSet 버전에서 StatefulSet 컨트롤러에서 생성한 Pod 수입니다.

currentRevision

string

currentRevision은 비어 있지 않은 경우 [0,currentReplicas) 순서로 Pod를 생성하는 데 사용되는 StatefulSet 버전을 나타냅니다.

observedGeneration

integer

observedGeneration은 이 StatefulSet에서 관찰되는 최신 세대입니다. StatefulSet의 생성은 API 서버에서 변경 시 업데이트되는 StatefulSet의 생성에 해당합니다.

readyReplicas

integer

readyReplicas는 Ready Condition을 사용하여 이 StatefulSet에 대해 생성된 Pod 수입니다.

replicas

integer

replicas는 StatefulSet 컨트롤러에서 생성한 Pod 수입니다.

updateRevision

string

updateRevision은 비어 있지 않은 경우 [replicas-updatedReplicas,replicas) 순서로 포드를 생성하는 데 사용되는 StatefulSet 버전을 나타냅니다.

updatedReplicas

integer

updatedReplicas는 updateRevision으로 표시된 StatefulSet 버전에서 StatefulSet 컨트롤러에서 생성한 Pod 수입니다.

18.1.6. .status.conditions

설명
상태 저장 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
유형
array

18.1.7. .status.conditions[]

설명
StatefulSetCondition은 특정 시점에서 상태 저장 설정 상태를 설명합니다.
유형
object
필수 항목
  • type
  • status
속성유형설명

lastTransitionTime

시간

조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다.

message

string

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

reason

string

조건의 마지막 전환 이유는 다음과 같습니다.

status

string

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

type

string

상태 저장 설정 조건의 유형입니다.

18.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

  • /apis/apps/v1/statefulsets

    • GET: StatefulSet 유형의 오브젝트 목록 또는 감시
  • /apis/apps/v1/watch/statefulsets

    • GET: StatefulSet. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/statefulsets

    • DELETE: StatefulSet의 컬렉션 삭제
    • GET: StatefulSet 유형의 오브젝트 목록 또는 감시
    • POST: StatefulSet을 생성
  • /apis/apps/v1/watch/namespaces/{namespace}/statefulsets

    • GET: StatefulSet. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
  • /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}

    • DELETE: StatefulSet 삭제
    • GET: 지정된 StatefulSet을 읽습니다.
    • PATCH: 지정된 StatefulSet을 부분적으로 업데이트
    • PUT: 지정된 StatefulSet을 바꿉니다.
  • /apis/apps/v1/watch/namespaces/{namespace}/statefulsets/{name}

    • GET: StatefulSet. deprecated 개체 변경 사항을 감시합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 단일 항목으로 필터링합니다.
  • /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status

    • GET: 지정된 StatefulSet의 읽기 상태
    • PATCH: 지정된 StatefulSet의 부분적으로 업데이트 상태
    • PUT: 지정된 StatefulSet의 상태

18.2.1. /apis/apps/v1/statefulsets

표 18.1. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
StatefulSet 유형의 오브젝트 나열 또는 감시
표 18.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSetList 스키마

401 - 무단

18.2.2. /apis/apps/v1/watch/statefulsets

표 18.3. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
StatefulSet. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 18.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

18.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets

표 18.5. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 18.6. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
StatefulSet의 컬렉션 삭제
표 18.7. 쿼리 매개변수
매개변수유형설명

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

제한

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

표 18.8. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 18.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
StatefulSet 유형의 오브젝트 나열 또는 감시
표 18.10. 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

표 18.11. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSetList 스키마

401 - 무단

HTTP 방법
POST
설명
StatefulSet 만들기
표 18.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.13. 본문 매개변수
매개변수유형설명

body

StatefulSet 스키마

 
표 18.14. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

201 - 생성됨

StatefulSet 스키마

202 - 승인됨

StatefulSet 스키마

401 - 무단

18.2.4. /apis/apps/v1/watch/namespaces/{namespace}/statefulsets

표 18.15. 글로벌 경로 매개변수
매개변수유형설명

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 18.16. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
StatefulSet. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 18.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

18.2.5. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}

표 18.18. 글로벌 경로 매개변수
매개변수유형설명

name

string

StatefulSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 18.19. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
DELETE
설명
StatefulSet 삭제
표 18.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

gracePeriodSeconds

integer

오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다.

orphanDependents

boolean

더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다.

propagationPolicy

string

가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다.

표 18.21. 본문 매개변수
매개변수유형설명

body

DeleteOptions 스키마

 
표 18.22. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 StatefulSet 읽기
표 18.23. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 StatefulSet을 부분적으로 업데이트
표 18.24. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 18.25. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 18.26. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

201 - 생성됨

StatefulSet 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 StatefulSet을 바꿉니다.
표 18.27. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.28. 본문 매개변수
매개변수유형설명

body

StatefulSet 스키마

 
표 18.29. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

201 - 생성됨

StatefulSet 스키마

401 - 무단

18.2.6. /apis/apps/v1/watch/namespaces/{namespace}/statefulsets/{name}

표 18.30. 글로벌 경로 매개변수
매개변수유형설명

name

string

StatefulSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 18.31. 글로벌 쿼리 매개변수
매개변수유형설명

allowWatchBookmarks

boolean

AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다.

계속

string

서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다.

watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다.

fieldSelector

string

반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다.

labelSelector

string

라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다.

limit

integer

제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 continue 필드를 동일한 초기 쿼리와 함께 사용하여 다음 결과 집합을 검색할 수 있는 값으로 설정합니다. 제한을 설정하면 모든 요청된 오브젝트가 필터링되는 경우 요청된 양의 항목(최대 0 항목)보다 적은 수를 반환하고 클라이언트는 continue 필드의 존재만 사용하여 더 많은 결과를 사용할 수 있는지 확인해야 합니다. 서버는 limit 인수를 지원하지 않도록 선택할 수 있으며 사용 가능한 모든 결과를 반환합니다. 제한이 지정되고 continue 필드가 비어 있으면 클라이언트는 더 이상 결과를 사용할 수 없다고 가정할 수 있습니다. watch가 true인 경우 이 필드는 지원되지 않습니다.

이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다.

string

'true'인 경우 출력이 상당히 인쇄됩니다.

resourceVersion

string

resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오.

기본값이 설정되지 않음

resourceVersionMatch

string

resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

기본값이 설정되지 않음

timeoutSeconds

integer

list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다.

watch

boolean

설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다.

HTTP 방법
GET
설명
StatefulSet. deprecated 개체 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
표 18.32. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

18.2.7. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status

표 18.33. 글로벌 경로 매개변수
매개변수유형설명

name

string

StatefulSet의 이름

네임스페이스

string

팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위

표 18.34. 글로벌 쿼리 매개변수
매개변수유형설명

string

'true'인 경우 출력이 상당히 인쇄됩니다.

HTTP 방법
GET
설명
지정된 StatefulSet의 읽기 상태
표 18.35. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 StatefulSet의 부분적으로 업데이트 상태
표 18.36. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

force

boolean

강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다.

표 18.37. 본문 매개변수
매개변수유형설명

body

패치 스키마

 
표 18.38. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

201 - 생성됨

StatefulSet 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 StatefulSet의 상태 교체
표 18.39. 쿼리 매개변수
매개변수유형설명

dryRun

string

존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

fieldManager

string

Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다.

fieldValidation

string

FieldValidation은 ServerSideFieldValidation 기능 게이트가 활성화된 경우 알 수 없거나 중복된 필드가 포함된 요청의 오브젝트(POST/PUT/PATCH)를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. 이는 v1.23 이전의 기본 동작이며 ServerSideFieldValidation 기능 게이트가 비활성화된 경우의 기본 동작입니다. -경고: 오브젝트에서 삭제된 각 알 수 없는 필드에 대한 표준 경고 응답 헤더를 통해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. ServerSideFieldValidation 기능 게이트가 활성화된 경우 기본값입니다. - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 18.40. 본문 매개변수
매개변수유형설명

body

StatefulSet 스키마

 
표 18.41. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

StatefulSet 스키마

201 - 생성됨

StatefulSet 스키마

401 - 무단

Legal Notice

Copyright © 2024 Red Hat, Inc.

OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).

Modified versions must remove all Red Hat trademarks.

Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.

Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.