워크로드 API
워크로드 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은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| BuildConfigSpec에서는 빌드 생성 시기와 방법을 설명합니다. |
|
| BuildConfigStatus에는 빌드 구성 오브젝트의 현재 상태가 포함됩니다. |
2.1.1. .spec
- 설명
- BuildConfigSpec에서는 빌드 생성 시기와 방법을 설명합니다.
- 유형
-
object
- 필수 항목
-
전략
-
속성 | 유형 | 설명 |
---|---|---|
|
| completionDeadlineSeconds는 시스템에서 빌드 Pod가 예약되는 시점부터 계산되는 선택적 기간(초)입니다. 시스템이 빌드를 적극적으로 종료하려고 시도하기 전에 빌드가 노드에서 활성화될 수 있습니다. 값은 양의 정수여야 합니다. |
|
| failedBuildsHistoryLimit은 유지할 수 없는 이전 빌드 수입니다. BuildConfig가 생성되면 이 값을 설정하지 않으면 가장 최근 실패한 빌드 5개가 유지됩니다. BuildConfig가 생성된 후 제거된 경우 실패한 모든 빌드가 유지됩니다. |
|
| mountTrustedCA 바인딩은 클러스터의 프록시 구성에 정의된 대로 클러스터의 신뢰할 수 있는 인증 기관을 빌드에 마운트합니다. 이를 통해 개인 아티팩트 리포지토리 및 HTTPS 프록시와 같은 사용자 정의 PKI 인증 기관에서 서명한 빌드 신뢰 구성 요소 내의 프로세스를 수행할 수 있습니다.
이 필드가 true로 설정되면 빌드 내의 |
|
| nodeSelector는 빌드 Pod가 노드에 적합한 경우 클러스터의 기본 빌드 노드 선택기 값으로 재정의할 수 있는 선택기입니다. 빈 맵 또는 값이 있는 맵으로 설정하면 기본 빌드 노드 선택기 값이 무시됩니다. |
|
| BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다. |
|
| BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다. 후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.
후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 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 슬라이스에 인수를 추가하는 것과 동일합니다. 스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다. |
| 리소스는 빌드를 실행하기 위해 리소스 요구 사항을 계산합니다. | |
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| runPolicy는 이 빌드 구성에서 생성된 새 빌드가 실행을 위해 예약되는 방법을 설명합니다. 지정하지 않으면 선택 사항입니다. 기본값은 "Serial"입니다. |
|
| ServiceAccount는 이 빌드에서 생성한 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. Pod는 ServiceAccount에서 참조하는 시크릿을 사용할 수 있습니다. |
|
| BuildSource는 빌드에 사용되는 SCM입니다. |
|
| BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다. |
|
| successfulBuildsHistoryLimit은 유지할 이전 빌드 수입니다. BuildConfig가 생성되면 이 값을 설정하지 않으면 가장 최근의 빌드 5개가 유지됩니다. BuildConfig가 생성된 후 제거된 경우 모든 성공적인 빌드가 유지됩니다. |
|
| 트리거는 BuildConfig에서 새 빌드를 시작하는 방법을 결정합니다. 트리거가 정의되지 않은 경우 명시적 클라이언트 빌드 생성으로 인해 새 빌드가 발생할 수 있습니다. |
|
| BuildTriggerPolicy는 새 Build를 생성하는 단일 트리거에 대한 정책을 설명합니다. |
2.1.2. .spec.output
- 설명
- BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다. |
|
| ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다. |
| pushSecret은 사용 가능한 인증 Docker Registry(또는 Docker Hub)에 대한 Docker 푸시를 실행하는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
| 이 빌드의 출력을 내보낼 선택적 위치를 정의하려면 다음을 수행합니다. kind는 'ImageStreamTag' 또는 'DockerImage' 중 하나여야 합니다. 이 값은 내보낼 컨테이너 이미지 리포지토리를 찾는 데 사용됩니다. ImageStreamTag의 경우 Namespace를 지정하지 않는 한 ImageStreamTag는 빌드의 네임스페이스에서 검색됩니다. |
2.1.3. .spec.output.imageLabels
- 설명
- imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.
- 유형
-
array
2.1.4. .spec.output.imageLabels[]
- 설명
- ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다. |
|
| value는 레이블의 리터럴 값을 정의합니다. |
2.1.5. .spec.postCommit
- 설명
BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.
후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.
후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며
rake test --verbose
를 실행합니다.쉘 스크립트:
"postCommit": { "script": "rake test --verbose", }
The above is a convenient form which is equivalent to:
"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }
이미지 진입점으로서의 명령:
"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.
기본 진입점에 인수를 전달합니다.
"postCommit": { "args": ["rake", "test", "--verbose"] }
This form is only useful if the image entrypoint can handle arguments.
인수가 있는 쉘 스크립트:
"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.
인수가 있는 명령:
"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }
This form is equivalent to appending the arguments to the Command slice.
스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 인수는 Command, Script 또는 컨테이너 이미지의 기본 진입점에 제공되는 인수 목록입니다. 인수는 명령을 실행한 직후에 배치됩니다. |
|
|
명령은 실행할 명령입니다. 스크립트로 지정할 수 없습니다. 이미지에 |
|
|
script는 |
2.1.6. .spec.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
2.1.7. .spec.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
2.1.8. .spec.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
2.1.9. .spec.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
2.1.10. .spec.source
- 설명
- BuildSource는 빌드에 사용되는 SCM입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다. |
|
| ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다. |
|
| ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다. |
|
| contextDir은 애플리케이션의 소스 코드가 있는 하위 디렉터리를 지정합니다. 그러면 리포지토리의 root가 아닌 다른 디렉터리에 빌드 가능한 소스가 있을 수 있습니다. |
|
| Dockerfile은 빌드해야 하는 Dockerfile의 원시 콘텐츠입니다. 이 옵션을 지정하면 전략 기본 이미지를 기반으로 FROM을 수정하고 전략 환경의 추가 ENV 스탠자가 FROM 뒤에 추가되지만 나머지 Dockerfile 스탠자 전에 추가됩니다. Dockerfile 소스 유형은 git과 같은 다른 옵션과 함께 사용할 수 있습니다. 이 경우 Git 리포지터리에 컨텍스트 dir에서 대체된 모든 Dockerfile이 있습니다. |
|
| GitBuildSource는 Git SCM의 매개변수를 정의합니다. |
|
| 이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다. |
|
| ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조). |
|
| 보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다. |
|
| SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다. |
| sourceSecret은 프라이빗 리포지토리 복제를 위한 인증을 설정하는 데 사용되는 보안의 이름입니다. 보안에는 원격 리포지토리에 대한 유효한 인증 정보가 포함되어 있습니다. 여기서 데이터의 키는 사용할 인증 방법을 나타내며 value는 base64로 인코딩된 인증 정보입니다. 지원되는 인증 방법은 ssh-privatekey입니다. | |
|
| 허용할 빌드 입력 유형 |
2.1.11. .spec.source.binary
- 설명
- BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 |
2.1.12. .spec.source.configMaps
- 설명
- ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.
- 유형
-
array
2.1.13. .spec.source.configMaps[]
- 설명
- ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
- 유형
-
object
- 필수 항목
-
configMap
-
속성 | 유형 | 설명 |
---|---|---|
| ConfigMap은 빌드에서 사용하려는 기존 구성 맵에 대한 참조입니다. | |
|
| destinationDir은 configmap의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다. |
2.1.14. .spec.source.git
- 설명
- GitBuildSource는 Git SCM의 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
URI
-
속성 | 유형 | 설명 |
---|---|---|
|
| httpProxy는 http를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다. |
|
| httpsProxy는 https를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다. |
|
| noProxy는 프록시를 사용하지 않아야 하는 도메인 목록입니다. |
|
| ref는 빌드할 분기/태그/참조입니다. |
|
| URI는 빌드될 소스를 가리킵니다. 소스 구조는 실행할 빌드 유형에 따라 달라집니다. |
2.1.15. .spec.source.images
- 설명
- 이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.
- 유형
-
array
2.1.16. .spec.source.images[]
- 설명
- ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
|
| 다중 단계 컨테이너 이미지 빌드 중에 이 소스를 사용할 이미지 이름 목록입니다. 예를 들어 "COPY --from=nginx:latest"를 사용하는 Dockerfile은 먼저 이 필드에 "nginx:latest"가 있는 이미지 소스를 직접 가져오기 전에 확인합니다. Dockerfile에서 이미지 소스를 참조하지 않으면 무시됩니다. 이 필드와 경로는 모두 설정될 수 있으며, 이 경우 콘텐츠가 두 번 사용됩니다. |
| 에서 소스를 복사할 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 참조입니다. | |
|
| 경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다. |
|
| ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다. |
| pullSecret은 레지스트리에서 이미지를 가져오는 데 사용할 보안에 대한 참조로, OpenShift 레지스트리에서 이미지를 가져오는 경우 이 필드를 설정할 필요가 없습니다. |
2.1.17. .spec.source.images[].paths
- 설명
- 경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.
- 유형
-
array
2.1.18. .spec.source.images[].paths[]
- 설명
- ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.
- 유형
-
object
- 필수 항목
-
sourcePath
-
destinationDir
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationDir은 이미지에서 복사한 파일이 배치되는 빌드 디렉터리 내의 상대 디렉터리입니다. |
|
| SourcePath는 빌드 디렉터리에 복사할 이미지 내부의 파일 또는 디렉터리의 절대 경로입니다. 소스 경로가 /.로 종료되면 디렉터리의 콘텐츠가 복사되지만 디렉터리 자체는 대상에 생성되지 않습니다. |
2.1.19. .spec.source.secrets
- 설명
- 보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.
- 유형
-
array
2.1.20. .spec.source.secrets[]
- 설명
- SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
- 유형
-
object
- 필수 항목
-
Secret
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationDir은 시크릿의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 나중에 스크립트가 완료되면 삽입된 모든 파일이 0 길이로 잘립니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다. |
| Secret은 빌드에서 사용하려는 기존 보안에 대한 참조입니다. |
2.1.21. .spec.strategy
- 설명
- BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다. |
|
| DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다. |
|
| JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용 |
|
| SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다. |
|
| 유형은 빌드 전략의 종류입니다. |
2.1.22. .spec.strategy.customStrategy
- 설명
- CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
|
| buildAPIVersion은 Build 오브젝트 직렬화 및 사용자 정의 빌더에 대해 요청된 API 버전입니다. |
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| exposeDockerSocket을 사용하면 컨테이너 내부에서 Docker 명령(및 컨테이너 이미지 빌드)을 실행할 수 있습니다. |
|
| forcePull은 컨트롤러가 항상 빌더의 이미지를 가져오도록 빌드 Pod를 구성해야 하는지 또는 로컬에 없는 경우에만 가져오기를 수행해야 하는지 설명합니다. |
| 에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. | |
| pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
|
| 보안은 빌드 Pod에 포함될 추가 보안 목록입니다. |
|
| SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다. |
2.1.23. .spec.strategy.customStrategy.secrets
- 설명
- 보안은 빌드 Pod에 포함될 추가 보안 목록입니다.
- 유형
-
array
2.1.24. .spec.strategy.customStrategy.secrets[]
- 설명
- SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.
- 유형
-
object
- 필수 항목
-
secretSource
-
mountPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| mountPath는 시크릿을 마운트할 경로입니다. |
| secretSource는 보안에 대한 참조입니다. |
2.1.25. .spec.strategy.dockerStrategy
- 설명
- DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| buildArgs에는 Dockerfile에서 해결할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 을 참조하십시오. 참고: 'name' 및 '값' 필드만 지원됩니다. 'valueFrom' 필드의 설정은 모두 무시됩니다. | |
|
|
dockerfilePath는 컨텍스트 루트(contextDir)를 기준으로 컨테이너 이미지를 빌드하는 데 사용할 Dockerfile의 경로입니다. 설정되지 않은 경우 기본값은 |
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다. |
| 에서 빌드의 Dockerfile의 FROM 이미지를 재정의하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. Dockerfile에서 다중 단계 빌드를 사용하는 경우 파일의 마지막 FROM 지시문에 있는 이미지를 대체합니다. | |
|
| imageOptimizationPolicy는 이미지 빌드에 소요되는 최종 크기 또는 시간을 줄이기 위해 이미지를 빌드할 때 사용할 수 있는 최적화를 설명합니다. 기본 정책은 '없음'으로, 최종 빌드 이미지가 컨테이너 이미지 빌드 API에서 생성한 이미지와 동일합니다. 실험적 정책 'SkipLayers'는 각 이미지 단계 사이에 새 계층을 커밋하지 않으며 Dockerfile에서 '없음' 정책과의 호환성을 제공할 수 없는 경우 실패합니다. 추가 실험 정책 'SkipLayersAndWarn'은 'SkipLayers'와 동일하지만 호환성을 유지할 수 없는 경우 경고합니다. |
|
| noCache true로 설정하면 --no-cache=true 플래그를 사용하여 컨테이너 이미지 빌드를 실행해야 함을 나타냅니다. |
| pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
|
| volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다. |
|
| BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다. |
|
| name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다. |
2.1.28. .spec.strategy.dockerStrategy.volumes[].mounts
- 설명
- mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
- 유형
-
array
2.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[]
- 설명
- BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
destinationPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다. |
2.1.30. .spec.strategy.dockerStrategy.volumes[].source
- 설명
- BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다. | |
| CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다. | |
| secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap |
2.1.31. .spec.strategy.jenkinsPipelineStrategy
- 설명
- JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| env에는 빌드 파이프라인에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| Jenkinsfile은 Jenkins 파이프라인 빌드를 정의하는 Jenkinsfile의 선택적 원시 콘텐츠를 정의합니다. |
|
| jenkinsfilePath는 컨텍스트 루트(contextDir)를 기준으로 파이프라인을 구성하는 데 사용할 Jenkinsfile의 선택적 경로입니다. JenkinsfilePath 및 Jenkinsfile 둘 다 지정되지 않은 경우 기본값은 지정된 contextDir의 루트에서 Jenkinsfile으로 설정됩니다. |
2.1.32. .spec.strategy.sourceStrategy
- 설명
- SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다. |
| 에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. | |
|
| 증분 플래그는 true인 경우 소스 빌드가 증분 빌드를 수행하도록 강제 적용합니다. |
| pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
|
| 스크립트는 소스 스크립트의 위치입니다. |
|
| volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다. |
|
| BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다. |
|
| name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다. |
2.1.35. .spec.strategy.sourceStrategy.volumes[].mounts
- 설명
- mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
- 유형
-
array
2.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[]
- 설명
- BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
destinationPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다. |
2.1.37. .spec.strategy.sourceStrategy.volumes[].source
- 설명
- BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다. | |
| CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다. | |
| secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap |
2.1.38. .spec.triggers
- 설명
- 트리거는 BuildConfig에서 새 빌드를 시작하는 방법을 결정합니다. 트리거가 정의되지 않은 경우 명시적 클라이언트 빌드 생성으로 인해 새 빌드가 발생할 수 있습니다.
- 유형
-
array
2.1.39. .spec.triggers[]
- 설명
- BuildTriggerPolicy는 새 Build를 생성하는 단일 트리거에 대한 정책을 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다. |
|
| WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다. |
|
| WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다. |
|
| WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다. |
|
| ImageChangeTrigger를 사용하면 ImageStream이 변경될 때 빌드를 트리거할 수 있습니다. |
|
| 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는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다. |
|
| 요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다. |
|
| SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다. |
2.1.41. .spec.triggers[].bitbucket.secretReference
- 설명
- SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다. |
2.1.42. .spec.triggers[].generic
- 설명
- WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다. |
|
| 요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다. |
|
| SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다. |
2.1.43. .spec.triggers[].generic.secretReference
- 설명
- SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다. |
2.1.44. .spec.triggers[].github
- 설명
- WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다. |
|
| 요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다. |
|
| SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다. |
2.1.45. .spec.triggers[].github.secretReference
- 설명
- SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다. |
2.1.46. .spec.triggers[].gitlab
- 설명
- WebHookTrigger는 Webhook 유형을 사용하여 호출되는 트리거입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowEnv는 Webhook가 환경 변수를 설정할 수 있는지 여부를 결정합니다. GenericWebHook에 대해서만 true로 설정할 수 있습니다. |
|
| 요청의 유효성을 검사하는 데 사용되는 시크릿입니다. deprecated: 대신 SecretReference를 사용합니다. |
|
| SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다. |
2.1.47. .spec.triggers[].gitlab.secretReference
- 설명
- SecretLocalReference에는 사용 중인 로컬 보안을 가리키는 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조 중인 동일한 네임스페이스에 있는 리소스의 이름입니다. |
2.1.48. .spec.triggers[].imageChange
- 설명
- ImageChangeTrigger를 사용하면 ImageStream이 변경될 때 빌드를 트리거할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 에서 은 업데이트될 때 빌드를 트리거하는 ImageStreamTag에 대한 참조입니다. From이 지정되지 않으면 빌드 전략의 From 이미지가 사용됩니다. 빈 From 참조가 있는 ImageChangeTrigger 하나만 빌드 구성에서 허용됩니다. | |
|
| lastTriggeredImageID는 ImageChangeController에서 내부적으로 사용하여 빌드에 마지막으로 사용된 이미지 ID를 저장합니다. 이 필드는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 더 이상 사용되지 않음 |
|
| 이 트리거를 일시적으로 비활성화하면 paused가 적용됩니다. 선택 사항입니다. |
2.1.49. .status
- 설명
- BuildConfigStatus에는 빌드 구성 오브젝트의 현재 상태가 포함됩니다.
- 유형
-
object
- 필수 항목
-
lastVersion
-
속성 | 유형 | 설명 |
---|---|---|
|
| imageChangeTriggers는 lastTriggeredImageID에 대한 OpenShift APIServer에서 조정하는 값을 포함하여 BuildConfigSpec에 지정된 ImageChangeTrigger의 런타임 상태를 캡처합니다. spec의 각 이미지 변경 트리거에 대해 이 배열에 단일 항목이 있습니다. 각 트리거 상태는 트리거의 소스 역할을 하는 ImageStreamTag를 참조합니다. |
|
| ImageChangeTriggerStatus는 BuildConfigSpec.Triggers 구조에 지정된 관련 ImageChangeTrigger 정책의 최신 확인된 상태를 추적합니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| ImageStreamTagReference는 네임스페이스 및 이름으로 이미지 변경 트리거의 ImageStreamTag를 참조합니다. |
| lastTriggerTime은 이 특정 ImageStreamTag가 빌드가 시작되는 마지막 시간입니다. 이 필드는 이 트리거가 특별히 Build를 시작한 경우에만 업데이트됩니다. | |
|
| lastTriggeredImageID는 이 BuildConfig의 Build가 시작될 때 ImageStreamTag의 sha/id를 나타냅니다. 이 ImageStreamTag가 Build가 시작된 이유가 아니더라도 lastTriggeredImageID가 이 BuildConfig에 대한 Build가 시작될 때마다 업데이트됩니다. |
2.1.52. .status.imageChangeTriggers[].from
- 설명
- ImageStreamTagReference는 네임스페이스 및 이름으로 이미지 변경 트리거의 ImageStreamTag를 참조합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 ImageChangeTrigger에 대한 ImageStreamTag의 이름입니다. |
|
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- BuildConfig 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
2.2.2. /apis/build.openshift.io/v1/watch/buildconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- BuildConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
2.2.3. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- BuildConfig 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- BuildConfig 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- BuildConfig 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
2.2.4. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- BuildConfig 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
2.2.5. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| BuildConfig 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- BuildConfig 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 BuildConfig 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 BuildConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 BuildConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
2.2.6. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/buildconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| BuildConfig 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 BuildConfig 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3장. Build [build.openshift.io/v1]
- 설명
빌드에서는 새 배포 가능 이미지를 생성하는 데 필요한 입력과 실행 상태 및 빌드를 실행한 Pod에 대한 참조를 캡슐화합니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
3.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| BuildSpec에는 빌드를 나타내는 정보와 빌드에 대한 추가 정보가 있습니다. |
|
| BuildStatus에는 빌드 상태가 포함되어 있습니다. |
3.1.1. .spec
- 설명
- BuildSpec에는 빌드를 나타내는 정보와 빌드에 대한 추가 정보가 있습니다.
- 유형
-
object
- 필수 항목
-
전략
-
속성 | 유형 | 설명 |
---|---|---|
|
| completionDeadlineSeconds는 시스템에서 빌드 Pod가 예약되는 시점부터 계산되는 선택적 기간(초)입니다. 시스템이 빌드를 적극적으로 종료하려고 시도하기 전에 빌드가 노드에서 활성화될 수 있습니다. 값은 양의 정수여야 합니다. |
|
| mountTrustedCA 바인딩은 클러스터의 프록시 구성에 정의된 대로 클러스터의 신뢰할 수 있는 인증 기관을 빌드에 마운트합니다. 이를 통해 개인 아티팩트 리포지토리 및 HTTPS 프록시와 같은 사용자 정의 PKI 인증 기관에서 서명한 빌드 신뢰 구성 요소 내의 프로세스를 수행할 수 있습니다.
이 필드가 true로 설정되면 빌드 내의 |
|
| nodeSelector는 빌드 Pod가 노드에 적합한 경우 클러스터의 기본 빌드 노드 선택기 값으로 재정의할 수 있는 선택기입니다. 빈 맵 또는 값이 있는 맵으로 설정하면 기본 빌드 노드 선택기 값이 무시됩니다. |
|
| BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다. |
|
| BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다. 후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.
후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며 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 슬라이스에 인수를 추가하는 것과 동일합니다. 스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다. |
| 리소스는 빌드를 실행하기 위해 리소스 요구 사항을 계산합니다. | |
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| ServiceAccount는 이 빌드에서 생성한 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. Pod는 ServiceAccount에서 참조하는 시크릿을 사용할 수 있습니다. |
|
| BuildSource는 빌드에 사용되는 SCM입니다. |
|
| BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다. |
|
| TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다. |
|
| BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다. |
3.1.2. .spec.output
- 설명
- BuildOutput은 빌드 전략에 입력되며 전략에서 생성해야 하는 컨테이너 이미지를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다. |
|
| ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다. |
| pushSecret은 사용 가능한 인증 Docker Registry(또는 Docker Hub)에 대한 Docker 푸시를 실행하는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
| 이 빌드의 출력을 내보낼 선택적 위치를 정의하려면 다음을 수행합니다. kind는 'ImageStreamTag' 또는 'DockerImage' 중 하나여야 합니다. 이 값은 내보낼 컨테이너 이미지 리포지토리를 찾는 데 사용됩니다. ImageStreamTag의 경우 Namespace를 지정하지 않는 한 ImageStreamTag는 빌드의 네임스페이스에서 검색됩니다. |
3.1.3. .spec.output.imageLabels
- 설명
- imageLabels는 결과 이미지에 적용되는 라벨 목록을 정의합니다. 이름이 동일한 레이블이 여러 개인 경우 목록의 마지막 레이블이 사용됩니다.
- 유형
-
array
3.1.4. .spec.output.imageLabels[]
- 설명
- ImageLabel은 결과 이미지에 적용되는 레이블을 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다. |
|
| value는 레이블의 리터럴 값을 정의합니다. |
3.1.5. .spec.postCommit
- 설명
BuildPostCommitSpec에는 빌드 게시 커밋 후크 사양이 있습니다. 후크는 이미지의 마지막 계층을 커밋한 직후, 이미지가 레지스트리로 푸시되기 전에 빌드 출력 이미지를 실행하는 임시 컨테이너에서 명령을 실행합니다. 명령은 이미지의 WORKDIR로 설정된 현재 작업 디렉터리($PWD)를 사용하여 실행됩니다.
후크 실행이 실패하면 빌드가 실패로 표시됩니다. 스크립트 또는 명령에서 0이 아닌 종료 코드를 반환하거나 임시 컨테이너 시작과 관련된 다른 오류가 있는 경우 실패합니다.
후크를 구성하는 방법에는 5가지가 있습니다. 예를 들어 아래의 모든 양식은 동일하며
rake test --verbose
를 실행합니다.쉘 스크립트:
"postCommit": { "script": "rake test --verbose", }
The above is a convenient form which is equivalent to:
"postCommit": { "command": ["/bin/sh", "-ic"], "args": ["rake test --verbose"] }
이미지 진입점으로서의 명령:
"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.
기본 진입점에 인수를 전달합니다.
"postCommit": { "args": ["rake", "test", "--verbose"] }
This form is only useful if the image entrypoint can handle arguments.
인수가 있는 쉘 스크립트:
"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.
인수가 있는 명령:
"postCommit": { "command": ["rake", "test"], "args": ["--verbose"] }
This form is equivalent to appending the arguments to the Command slice.
스크립트와 명령을 동시에 제공하는 것은 유효하지 않습니다. 필드가 지정되지 않은 경우 후크가 실행되지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 인수는 Command, Script 또는 컨테이너 이미지의 기본 진입점에 제공되는 인수 목록입니다. 인수는 명령을 실행한 직후에 배치됩니다. |
|
|
명령은 실행할 명령입니다. 스크립트로 지정할 수 없습니다. 이미지에 |
|
|
script는 |
3.1.6. .spec.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
3.1.7. .spec.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
3.1.8. .spec.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.9. .spec.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.10. .spec.source
- 설명
- BuildSource는 빌드에 사용되는 SCM입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다. |
|
| ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다. |
|
| ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다. |
|
| contextDir은 애플리케이션의 소스 코드가 있는 하위 디렉터리를 지정합니다. 그러면 리포지토리의 root가 아닌 다른 디렉터리에 빌드 가능한 소스가 있을 수 있습니다. |
|
| Dockerfile은 빌드해야 하는 Dockerfile의 원시 콘텐츠입니다. 이 옵션을 지정하면 전략 기본 이미지를 기반으로 FROM을 수정하고 전략 환경의 추가 ENV 스탠자가 FROM 뒤에 추가되지만 나머지 Dockerfile 스탠자 전에 추가됩니다. Dockerfile 소스 유형은 git과 같은 다른 옵션과 함께 사용할 수 있습니다. 이 경우 Git 리포지터리에 컨텍스트 dir에서 대체된 모든 Dockerfile이 있습니다. |
|
| GitBuildSource는 Git SCM의 매개변수를 정의합니다. |
|
| 이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다. |
|
| ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조). |
|
| 보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다. |
|
| SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다. |
| sourceSecret은 프라이빗 리포지토리 복제를 위한 인증을 설정하는 데 사용되는 보안의 이름입니다. 보안에는 원격 리포지토리에 대한 유효한 인증 정보가 포함되어 있습니다. 여기서 데이터의 키는 사용할 인증 방법을 나타내며 value는 base64로 인코딩된 인증 정보입니다. 지원되는 인증 방법은 ssh-privatekey입니다. | |
|
| 허용할 빌드 입력 유형 |
3.1.11. .spec.source.binary
- 설명
- BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 |
3.1.12. .spec.source.configMaps
- 설명
- ConfigMaps는 빌드에 사용할 configMaps 및 해당 대상 목록을 나타냅니다.
- 유형
-
array
3.1.13. .spec.source.configMaps[]
- 설명
- ConfigMapBuildSource는 빌드 시에만 사용할 configmap 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조한 configmap의 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
- 유형
-
object
- 필수 항목
-
configMap
-
속성 | 유형 | 설명 |
---|---|---|
| ConfigMap은 빌드에서 사용하려는 기존 구성 맵에 대한 참조입니다. | |
|
| destinationDir은 configmap의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다. |
3.1.14. .spec.source.git
- 설명
- GitBuildSource는 Git SCM의 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
URI
-
속성 | 유형 | 설명 |
---|---|---|
|
| httpProxy는 http를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다. |
|
| httpsProxy는 https를 통해 git 리포지터리에 도달하는 데 사용되는 프록시입니다. |
|
| noProxy는 프록시를 사용하지 않아야 하는 도메인 목록입니다. |
|
| ref는 빌드할 분기/태그/참조입니다. |
|
| URI는 빌드될 소스를 가리킵니다. 소스 구조는 실행할 빌드 유형에 따라 달라집니다. |
3.1.15. .spec.source.images
- 설명
- 이미지는 빌드의 소스를 제공하는 데 사용할 이미지 세트를 설명합니다.
- 유형
-
array
3.1.16. .spec.source.images[]
- 설명
- ImageSource는 이미지에서 추출되거나 다중 단계 빌드 중에 사용할 빌드 소스를 설명하는 데 사용됩니다. ImageStreamTag 유형, ImageStreamImage 또는 DockerImage의 참조가 사용될 수 있습니다. 외부 레지스트리에서 이미지를 가져오도록 풀 시크릿을 지정하거나 내부 레지스트리에서 가져오는 경우 기본 서비스 계정 시크릿을 덮어쓸 수 있습니다. 이미지 소스를 사용하여 이미지에서 콘텐츠를 추출하여 리포지토리 소스와 함께 빌드 컨텍스트에 배치하거나 다중 단계 컨테이너 이미지 빌드 중에 직접 사용하여 리포지토리 소스의 콘텐츠를 덮어쓰지 않고 복사할 수 있습니다('paths' 및 'as' 필드 참조).
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
|
| 다중 단계 컨테이너 이미지 빌드 중에 이 소스를 사용할 이미지 이름 목록입니다. 예를 들어 "COPY --from=nginx:latest"를 사용하는 Dockerfile은 먼저 이 필드에 "nginx:latest"가 있는 이미지 소스를 직접 가져오기 전에 확인합니다. Dockerfile에서 이미지 소스를 참조하지 않으면 무시됩니다. 이 필드와 경로는 모두 설정될 수 있으며, 이 경우 콘텐츠가 두 번 사용됩니다. |
| 에서 소스를 복사할 ImageStreamTag, ImageStreamImage 또는 DockerImage에 대한 참조입니다. | |
|
| 경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다. |
|
| ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다. |
| pullSecret은 레지스트리에서 이미지를 가져오는 데 사용할 보안에 대한 참조로, OpenShift 레지스트리에서 이미지를 가져오는 경우 이 필드를 설정할 필요가 없습니다. |
3.1.17. .spec.source.images[].paths
- 설명
- 경로는 이미지에서 복사할 소스 및 대상 경로 목록입니다. 이 콘텐츠는 빌드를 시작하기 전에 빌드 컨텍스트로 복사됩니다. 경로가 설정되지 않은 경우 빌드 컨텍스트가 변경되지 않습니다.
- 유형
-
array
3.1.18. .spec.source.images[].paths[]
- 설명
- ImageSourcePath는 소스 이미지와 빌드 디렉터리 내의 해당 대상에서 복사할 경로를 설명합니다.
- 유형
-
object
- 필수 항목
-
sourcePath
-
destinationDir
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationDir은 이미지에서 복사한 파일이 배치되는 빌드 디렉터리 내의 상대 디렉터리입니다. |
|
| SourcePath는 빌드 디렉터리에 복사할 이미지 내부의 파일 또는 디렉터리의 절대 경로입니다. 소스 경로가 /.로 종료되면 디렉터리의 콘텐츠가 복사되지만 디렉터리 자체는 대상에 생성되지 않습니다. |
3.1.19. .spec.source.secrets
- 설명
- 보안은 빌드에만 사용할 보안 및 해당 대상 목록을 나타냅니다.
- 유형
-
array
3.1.20. .spec.source.secrets[]
- 설명
- SecretBuildSource는 빌드 시에만 사용할 시크릿 및 해당 대상 디렉터리를 설명합니다. 여기에서 참조하는 시크릿 콘텐츠는 마운트 대신 대상 디렉터리에 복사됩니다.
- 유형
-
object
- 필수 항목
-
Secret
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationDir은 시크릿의 파일을 빌드 시간에 사용할 수 있어야 하는 디렉터리입니다. Source 빌드 전략의 경우 assemble 스크립트가 실행되는 컨테이너에 삽입됩니다. 나중에 스크립트가 완료되면 삽입된 모든 파일이 0 길이로 잘립니다. 컨테이너 이미지 빌드 전략의 경우 Dockerfile이 있는 빌드 디렉터리에 복사되므로 사용자는 컨테이너 이미지 빌드 중에 이를 ADD하거나 COPY할 수 있습니다. |
| Secret은 빌드에서 사용하려는 기존 보안에 대한 참조입니다. |
3.1.21. .spec.strategy
- 설명
- BuildStrategy에는 빌드를 수행하는 방법에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다. |
|
| DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다. |
|
| JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용 |
|
| SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다. |
|
| 유형은 빌드 전략의 종류입니다. |
3.1.22. .spec.strategy.customStrategy
- 설명
- CustomBuildStrategy는 사용자 정의 빌드와 관련된 입력 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
|
| buildAPIVersion은 Build 오브젝트 직렬화 및 사용자 정의 빌더에 대해 요청된 API 버전입니다. |
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| exposeDockerSocket을 사용하면 컨테이너 내부에서 Docker 명령(및 컨테이너 이미지 빌드)을 실행할 수 있습니다. |
|
| forcePull은 컨트롤러가 항상 빌더의 이미지를 가져오도록 빌드 Pod를 구성해야 하는지 또는 로컬에 없는 경우에만 가져오기를 수행해야 하는지 설명합니다. |
| 에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. | |
| pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
|
| 보안은 빌드 Pod에 포함될 추가 보안 목록입니다. |
|
| SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다. |
3.1.23. .spec.strategy.customStrategy.secrets
- 설명
- 보안은 빌드 Pod에 포함될 추가 보안 목록입니다.
- 유형
-
array
3.1.24. .spec.strategy.customStrategy.secrets[]
- 설명
- SecretSpec은 빌드 Pod 및 해당 마운트 지점에 포함할 보안을 지정합니다.
- 유형
-
object
- 필수 항목
-
secretSource
-
mountPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| mountPath는 시크릿을 마운트할 경로입니다. |
| secretSource는 보안에 대한 참조입니다. |
3.1.25. .spec.strategy.dockerStrategy
- 설명
- DockerBuildStrategy는 컨테이너 이미지 빌드와 관련된 입력 매개변수를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| buildArgs에는 Dockerfile에서 해결할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 을 참조하십시오. 참고: 'name' 및 '값' 필드만 지원됩니다. 'valueFrom' 필드의 설정은 모두 무시됩니다. | |
|
|
dockerfilePath는 컨텍스트 루트(contextDir)를 기준으로 컨테이너 이미지를 빌드하는 데 사용할 Dockerfile의 경로입니다. 설정되지 않은 경우 기본값은 |
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다. |
| 에서 빌드의 Dockerfile의 FROM 이미지를 재정의하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. Dockerfile에서 다중 단계 빌드를 사용하는 경우 파일의 마지막 FROM 지시문에 있는 이미지를 대체합니다. | |
|
| imageOptimizationPolicy는 이미지 빌드에 소요되는 최종 크기 또는 시간을 줄이기 위해 이미지를 빌드할 때 사용할 수 있는 최적화를 설명합니다. 기본 정책은 '없음'으로, 최종 빌드 이미지가 컨테이너 이미지 빌드 API에서 생성한 이미지와 동일합니다. 실험적 정책 'SkipLayers'는 각 이미지 단계 사이에 새 계층을 커밋하지 않으며 Dockerfile에서 '없음' 정책과의 호환성을 제공할 수 없는 경우 실패합니다. 추가 실험 정책 'SkipLayersAndWarn'은 'SkipLayers'와 동일하지만 호환성을 유지할 수 없는 경우 경고합니다. |
|
| noCache true로 설정하면 --no-cache=true 플래그를 사용하여 컨테이너 이미지 빌드를 실행해야 함을 나타냅니다. |
| pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
|
| volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다. |
|
| BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다. |
|
| name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다. |
3.1.28. .spec.strategy.dockerStrategy.volumes[].mounts
- 설명
- mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
- 유형
-
array
3.1.29. .spec.strategy.dockerStrategy.volumes[].mounts[]
- 설명
- BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
destinationPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다. |
3.1.30. .spec.strategy.dockerStrategy.volumes[].source
- 설명
- BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다. | |
| CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다. | |
| secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap |
3.1.31. .spec.strategy.jenkinsPipelineStrategy
- 설명
- JenkinsPipelineBuildStrategy에는 Jenkins Pipeline 빌드와 관련된 매개변수가 포함되어 있습니다. 더 이상 사용되지 않음: OpenShift Pipelines 사용
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| env에는 빌드 파이프라인에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| Jenkinsfile은 Jenkins 파이프라인 빌드를 정의하는 Jenkinsfile의 선택적 원시 콘텐츠를 정의합니다. |
|
| jenkinsfilePath는 컨텍스트 루트(contextDir)를 기준으로 파이프라인을 구성하는 데 사용할 Jenkinsfile의 선택적 경로입니다. JenkinsfilePath 및 Jenkinsfile 둘 다 지정되지 않은 경우 기본값은 지정된 contextDir의 루트에서 Jenkinsfile으로 설정됩니다. |
3.1.32. .spec.strategy.sourceStrategy
- 설명
- SourceBuildStrategy는 소스 빌드와 관련된 입력 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
|
| forcePull은 빌더가 빌드 전에 레지스트리에서 이미지를 가져와야 하는지 여부를 설명합니다. |
| 에서 컨테이너 이미지를 가져와야 하는 DockerImage, ImageStreamTag 또는 ImageStreamImage에 대한 참조입니다. | |
|
| 증분 플래그는 true인 경우 소스 빌드가 증분 빌드를 수행하도록 강제 적용합니다. |
| pullSecret은 개인 Docker 레지스트리에서 컨테이너 이미지를 가져오는 데 인증을 설정하는 데 사용되는 보안의 이름입니다. | |
|
| 스크립트는 소스 스크립트의 위치입니다. |
|
| volumes는 빌드 런타임 환경에 마운트할 수 있는 입력 볼륨 목록입니다. 빌드에서는 Kubernetes 볼륨 소스의 하위 집합만 지원됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다. |
|
| BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다. |
|
| name은 이 BuildVolume의 고유 식별자입니다. Kubernetes DNS 레이블 표준을 준수하고 Pod 내에서 고유해야 합니다. 빌드 컨트롤러에서 추가한 이름과 충돌하면 오류가 발생한 이름을 자세히 설명하는 오류 메시지가 있는 빌드가 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다. |
3.1.35. .spec.strategy.sourceStrategy.volumes[].mounts
- 설명
- mount는 이미지 빌드 컨테이너의 볼륨 위치를 나타냅니다.
- 유형
-
array
3.1.36. .spec.strategy.sourceStrategy.volumes[].mounts[]
- 설명
- BuildVolumeMount는 buildah의 런타임 환경에서 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
destinationPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| destinationPath는 볼륨을 마운트해야 하는 buildah 런타임 환경 내의 경로입니다. 빌드 이미지 내의 일시적인 마운트와 백업 볼륨은 모두 읽기 전용입니다. 절대 경로여야 합니다. '..' 또는 ':'를 포함하지 않아야 하며, 빌드 컨트롤러에서 추가한 것과 충돌하는 빌더 프로세스 경로에서 생성한 대상 경로와 충돌하면 오류가 발생한 경로를 자세히 설명하는 오류 메시지가 표시된 오류 메시지가 표시됩니다. |
3.1.37. .spec.strategy.sourceStrategy.volumes[].source
- 설명
- BuildVolumeSource는 지원되는 유형 중 하나만 마운트할 볼륨의 소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| ConfigMap은 이 볼륨을 채워야 하는 ConfigMap을 나타냅니다. | |
| CSI는 이 기능을 지원하는 외부 CSI 드라이버에서 제공하는 임시 스토리지를 나타냅니다. | |
| secret은 이 볼륨을 채워야 하는 보안을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#secret | |
|
| type은 볼륨 소스의 BuildVolumeSourceType입니다. 유형은 채워진 볼륨 소스와 일치해야 합니다. 유효한 유형은 다음과 같습니다: Secret, ConfigMap |
3.1.38. .spec.triggeredBy
- 설명
- TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.
- 유형
-
array
3.1.39. .spec.triggeredBy[]
- 설명
- BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다. |
|
| GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다. |
|
| GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다. |
|
| GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다. |
|
| ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다. |
|
| message는 빌드가 트리거된 이유에 대한 사람이 읽을 수 있는 메시지를 저장하는 데 사용됩니다. 예: "Manually triggered by user", "Configuration change",etc. |
3.1.40. .spec.triggeredBy[].bitbucketWebHook
- 설명
- BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
3.1.41. .spec.triggeredBy[].bitbucketWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
3.1.42. .spec.triggeredBy[].bitbucketWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
3.1.43. .spec.triggeredBy[].bitbucketWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.44. .spec.triggeredBy[].bitbucketWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.45. .spec.triggeredBy[].genericWebHook
- 설명
- GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
3.1.46. .spec.triggeredBy[].genericWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
3.1.47. .spec.triggeredBy[].genericWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
3.1.48. .spec.triggeredBy[].genericWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.49. .spec.triggeredBy[].genericWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.50. .spec.triggeredBy[].githubWebHook
- 설명
- GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
3.1.51. .spec.triggeredBy[].githubWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
3.1.52. .spec.triggeredBy[].githubWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
3.1.53. .spec.triggeredBy[].githubWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.54. .spec.triggeredBy[].githubWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.55. .spec.triggeredBy[].gitlabWebHook
- 설명
- GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
3.1.56. .spec.triggeredBy[].gitlabWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
3.1.57. .spec.triggeredBy[].gitlabWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
3.1.58. .spec.triggeredBy[].gitlabWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.59. .spec.triggeredBy[].gitlabWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
3.1.60. .spec.triggeredBy[].imageChangeBuild
- 설명
- ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| fromRef에는 빌드를 트리거한 이미지에 대한 자세한 정보가 포함되어 있습니다. | |
|
| ImageId는 새 빌드를 트리거한 이미지의 ID입니다. |
3.1.61. .status
- 설명
- BuildStatus에는 빌드 상태가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
phase
-
속성 | 유형 | 설명 |
---|---|---|
|
| 취소된 이벤트는 빌드에 대해 취소 이벤트가 트리거되었는지 여부를 나타냅니다. |
| completionTimestamp는 빌드 실패 또는 성공 여부에 관계없이 이 빌드가 완료된 서버 시간을 나타내는 타임스탬프입니다. 빌드를 실행하는 Pod가 종료된 시간을 반영합니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. | |
|
| 조건은 빌드의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| BuildCondition은 특정 시점에서 빌드 상태를 설명합니다. |
| config는 이 Build가 기반으로 하는 BuildConfig에 대한 ObjectReference입니다. | |
|
| duration에는 빌드 시간을 설명하는 time.Duration 오브젝트가 포함됩니다. |
|
| logSnippet은 빌드 로그의 마지막 몇 줄입니다. 이 값은 실패한 빌드에만 설정됩니다. |
|
| message는 빌드의 상태가 이 상태에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| BuildStatusOutput에는 빌드된 이미지의 상태가 포함됩니다. |
|
| outputDockerImageReference에는 이 빌드에서 빌드할 컨테이너 이미지에 대한 참조가 포함되어 있습니다. 해당 값은 Build.Spec.Output.To에서 계산되며 이미지를 푸시하고 가져오는 데 사용할 수 있도록 레지스트리 주소를 포함해야 합니다. |
|
| 단계는 빌드 라이프사이클의 지점입니다. 가능한 값은 "New", "Pending", "Running", "Complete", "Failed", "Error", "Cancelled"입니다. |
|
| 이유는 오류를 설명하는 짧은 CamelCase 문자열이며 CLI에서 머신 구문 분석 및 tidy 표시를 의미합니다. |
|
| 스테이지에는 시작 시간, 기간(밀리초) 및 각 단계 내에서 발생한 단계를 포함하여 빌드 중에 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다. |
|
| StageInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다. |
| startTimestamp는 이 빌드가 Pod에서 실행되기 시작한 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. |
3.1.62. .status.conditions
- 설명
- 조건은 빌드의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
3.1.63. .status.conditions[]
- 설명
- BuildCondition은 특정 시점에서 빌드 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
| 이 조건이 마지막으로 업데이트된 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 빌드 조건 유형입니다. |
3.1.64. .status.output
- 설명
- BuildStatusOutput에는 빌드된 이미지의 상태가 포함됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| BuildStatusOutputTo는 푸시해야 하는 이미지 레지스트리와 관련하여 빌드된 이미지의 상태를 설명합니다. |
3.1.65. .status.output.to
- 설명
- BuildStatusOutputTo는 푸시해야 하는 이미지 레지스트리와 관련하여 빌드된 이미지의 상태를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| imageDigest는 빌드된 컨테이너 이미지의 다이제스트입니다. 다이제스트는 푸시된 레지스트리에서 이미지를 고유하게 식별합니다. 이 필드는 푸시가 성공적으로 완료된 경우에도 이 필드가 항상 설정되지 않을 수 있습니다. 예를 들어 레지스트리에서 다이제스트를 반환하지 않거나 빌더가 이해할 수 없는 형식으로 반환하는 경우입니다. |
3.1.66. .status.stages
- 설명
- 스테이지에는 시작 시간, 기간(밀리초) 및 각 단계 내에서 발생한 단계를 포함하여 빌드 중에 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
array
3.1.67. .status.stages[]
- 설명
- StageInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| durationMilliseconds는 스테이지가 밀리초 단위로 완료하는 데 걸리는 시간을 식별합니다. 참고: 스테이지 기간은 명시적 빌드 단계에서 모든 작업이 고려되는 것은 아니므로 스테이지 내의 단계 기간의 합계를 초과할 수 있습니다. |
|
| name은 수행되는 각 빌드 단계의 고유 식별자입니다. |
| StartTime은 이 단계가 시작될 때 서버 시간을 나타내는 타임스탬프입니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. | |
|
| 단계에는 시작 시간 및 지속 시간(밀리초)을 포함하여 빌드 단계에서 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다. |
|
| StepInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다. |
3.1.68. .status.stages[].steps
- 설명
- 단계에는 시작 시간 및 지속 시간(밀리초)을 포함하여 빌드 단계에서 발생하는 각 단계에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
array
3.1.69. .status.stages[].steps[]
- 설명
- StepInfo에는 빌드 단계에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| durationMilliseconds는 단계가 밀리초 단위로 완료하는 데 걸리는 시간을 식별합니다. |
|
| name은 각 빌드 단계의 고유 식별자입니다. |
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Build 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3.2.2. /apis/build.openshift.io/v1/watch/builds
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Build. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3.2.3. /apis/build.openshift.io/v1/namespaces/{namespace}/builds
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 빌드 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- Build 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 빌드 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
3.2.4. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Build. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3.2.5. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 빌드 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 빌드 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Build를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 빌드로 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3.2.6. /apis/build.openshift.io/v1/watch/namespaces/{namespace}/builds/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Build. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3.2.7. /apis/build.openshift.io/v1/namespaces/{namespace}/builds/{name}/details
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
PUT
- 설명
- 지정된 빌드의 세부 정보 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3.2.8. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| path는 Pod에 대한 현재 프록시 요청에 사용할 URL 경로입니다. |
- HTTP 방법
-
POST
- 설명
- BuildConfig의 Webhook에 POST 요청 연결
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
3.2.9. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/webhooks/{path}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
|
| 리소스 경로 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| path는 Pod에 대한 현재 프록시 요청에 사용할 URL 경로입니다. |
- HTTP 방법
-
POST
- 설명
- BuildConfig의 Webhook에 POST 요청 연결
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
4장. BuildLog [build.openshift.io/v1]
- 설명
BuildLog는 빌드 로그 리디렉션과 연결된 (사용되지 않음) 리소스입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
4.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| BuildLog의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 로그를 스트리밍할 수 있는 cointainer입니다. Pod에 컨테이너가 한 개 있는 경우에만 기본값은 컨테이너입니다. |
|
| true인 경우 빌드가 종료될 때까지 빌드 로그를 스트리밍해야 합니다. |
|
| insecureSkipTLSVerifyBackend는 apiserver가 연결된 백엔드의 제공 인증서의 유효성을 확인하지 않아야 함을 나타냅니다. 이렇게 하면 apiserver와 백엔드 간에 HTTPS 연결이 안전하지 않습니다. 즉, apiserver에서 수신 중인 로그 데이터를 실제 kubelet에서 확인할 수 없습니다. kubelet이 apiserver의 TLS 인증 정보를 확인하도록 구성된 경우 실제 kubelet에 대한 연결이 중간 공격의 사람에 취약하지 않습니다(예: 공격자가 실제 kubelet에서 들어오는 실제 로그 데이터를 가로챌 수 없음). |
|
| limitBytes, If set 은 로그 출력을 종료하기 전에 서버에서 읽을 바이트 수입니다. 이는 완전한 최종 로깅 행을 표시하지 않을 수 있으며 지정된 제한보다 약간 많거나 적을 수 있습니다. |
|
| nowait true인 경우 빌드를 아직 사용할 수 없는 경우에도 호출이 즉시 반환됩니다. 그렇지 않으면 서버는 빌드가 시작될 때까지 기다립니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| 이전 빌드 로그를 반환합니다. 기본값은 false입니다. |
|
| sinceSeconds는 로그를 표시하는 현재 시간 이전의 상대 시간(초)입니다. 이 값이 Pod를 시작한 시간보다 앞면 Pod 시작 이후의 로그만 반환됩니다. 이 값이 향후이면 로그가 반환되지 않습니다. sinceSeconds 또는 sinceTime 중 하나만 지정할 수 있습니다. |
|
| taillines, If set, is the number of lines from the end of the logs to show. 지정하지 않으면 컨테이너 생성 또는 sinceSeconds 또는 sinceTime에서 로그가 표시됩니다. |
|
| 타임스탬프(true인 경우)는 모든 로그 출력의 시작 부분에 RFC3339 또는 RFC3339Nano 타임스탬프를 추가합니다. 기본값은 false입니다. |
|
| 로그를 볼 빌드 버전입니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 빌드의 로그 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
5장. BuildRequest [build.openshift.io/v1]
- 설명
BuildRequest는 빌드 생성기에 매개변수를 전달하는 데 사용되는 리소스입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
5.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다. |
|
| DockerStrategyOptions에는 컨테이너 이미지 빌드를 위한 추가 전략 옵션이 포함되어 있습니다. |
| env에는 빌더 컨테이너에 전달할 추가 환경 변수가 포함되어 있습니다. | |
| 에서 빌드를 트리거한 ImageStreamTag에 대한 참조입니다. | |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| lastVersion(선택 사항)은 빌드를 생성하는 데 사용된 BuildConfig의 LastVersion입니다. 생성기의 BuildConfig가 일치하지 않으면 빌드가 생성되지 않습니다. |
| ||
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| SourceStrategyOptions에는 소스 빌드에 대한 추가 전략 옵션이 포함되어 있습니다. |
|
| TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다. |
|
| BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다. |
| triggeredByImage는 이 빌드를 트리거한 이미지입니다. |
5.1.1. .binary
- 설명
- BinaryBuildSource는 파일을 추출하여 빌드 소스로 사용할 Docker 및 소스 빌드 전략에 사용할 바이너리 파일을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
Asfile은 제공된 바이너리 입력이 빌드 입력 내에서 단일 파일로 간주되어야 함을 나타냅니다. 예를 들어 "webapp.war"를 지정하면 빌더에 제공된 바이너리가 |
5.1.2. .dockerStrategyOptions
- 설명
- DockerStrategyOptions에는 컨테이너 이미지 빌드를 위한 추가 전략 옵션이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| args에는 Docker로 전달할 빌드 인수가 포함되어 있습니다. 자세한 내용은 https://docs.docker.com/engine/reference/builder/#/arg 에서 참조하십시오. | |
|
| noCache는 빌드 구성의 docker-strategy noCache 옵션을 덮어씁니다. |
5.1.3. .revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
5.1.4. .revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
5.1.5. .revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.6. .revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.7. .sourceStrategyOptions
- 설명
- SourceStrategyOptions에는 소스 빌드에 대한 추가 전략 옵션이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 빌드 구성의 source-strategy 증분 옵션을 점진적으로 덮어씁니다. |
5.1.8. .triggeredBy
- 설명
- TriggerBy는 빌드 구성에 대한 최신 업데이트를 시작하고 해당 트리거에 대한 정보를 포함하는 트리거를 설명합니다.
- 유형
-
array
5.1.9. .triggeredBy[]
- 설명
- BuildTriggerCause는 트리거된 빌드에 대한 정보를 보유합니다. oc describe에서 각 빌드 및 빌드 구성에 대한 빌드 트리거 데이터를 표시하는 데 사용됩니다. 또한 빌드 구성에서 최신 업데이트로 이어지는 트리거를 설명하는 데도 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다. |
|
| GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다. |
|
| GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다. |
|
| GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다. |
|
| ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다. |
|
| message는 빌드가 트리거된 이유에 대한 사람이 읽을 수 있는 메시지를 저장하는 데 사용됩니다. 예: "Manually triggered by user", "Configuration change",etc. |
5.1.10. .triggeredBy[].bitbucketWebHook
- 설명
- BitbucketWebHookCause에는 빌드를 트리거한 Bitbucket Webhook에 대한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
5.1.11. .triggeredBy[].bitbucketWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
5.1.12. .triggeredBy[].bitbucketWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
5.1.13. .triggeredBy[].bitbucketWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.14. .triggeredBy[].bitbucketWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.15. .triggeredBy[].genericWebHook
- 설명
- GenericWebHookCause는 빌드를 트리거한 일반 웹 후크에 대한 정보를 보유합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
5.1.16. .triggeredBy[].genericWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
5.1.17. .triggeredBy[].genericWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
5.1.18. .triggeredBy[].genericWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.19. .triggeredBy[].genericWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.20. .triggeredBy[].githubWebHook
- 설명
- GitHubWebHookCause에는 빌드를 트리거한 GitHub Webhook에 대한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
5.1.21. .triggeredBy[].githubWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
5.1.22. .triggeredBy[].githubWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
5.1.23. .triggeredBy[].githubWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.24. .triggeredBy[].githubWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.25. .triggeredBy[].gitlabWebHook
- 설명
- GitLabWebHookCause에는 빌드를 트리거한 GitLab Webhook에 대한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다. |
|
| secret은 빌드를 트리거한 난독 처리된 Webhook 시크릿입니다. |
5.1.26. .triggeredBy[].gitlabWebHook.revision
- 설명
- SourceRevision은 빌드 소스의 버전 또는 커밋 정보입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다. |
|
| 빌드 소스의 유형은 '소스', 'Dockerfile', 'Binary' 또는 'Images' 중 하나일 수 있습니다. |
5.1.27. .triggeredBy[].gitlabWebHook.revision.git
- 설명
- GitSourceRevision은 빌드 Git 소스의 커밋 정보입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| 커밋은 특정 커밋을 식별하는 커밋 해시입니다. |
|
| SourceControlUser는 소스 제어 사용자 ID를 정의합니다. |
|
| message는 특정 커밋에 대한 설명입니다. |
5.1.28. .triggeredBy[].gitlabWebHook.revision.git.author
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.29. .triggeredBy[].gitlabWebHook.revision.git.committer
- 설명
- SourceControlUser는 소스 제어 사용자 ID를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스 제어 사용자의 이메일 |
|
| 소스 제어 사용자의 이름 |
5.1.30. .triggeredBy[].imageChangeBuild
- 설명
- ImageChangeCause에는 빌드를 트리거한 이미지에 대한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| fromRef에는 빌드를 트리거한 이미지에 대한 자세한 정보가 포함되어 있습니다. | |
|
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| BuildRequest의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- 빌드 복제본 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
5.2.2. /apis/build.openshift.io/v1/namespaces/{namespace}/buildconfigs/{name}/instantiate
매개변수 | 유형 | 설명 |
---|---|---|
|
| BuildRequest의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- BuildConfig의 인스턴스화 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
6장. CronJob [batch/v1]
- 설명
- CronJob은 단일 cron 작업의 구성을 나타냅니다.
- 유형
-
object
6.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| CronJobSpec은 작업 실행이 어떻게 보이고 실제로 실행될 시기를 설명합니다. |
|
| CronJobStatus는 cron 작업의 현재 상태를 나타냅니다. |
6.1.1. .spec
- 설명
- CronJobSpec은 작업 실행이 어떻게 보이고 실제로 실행될 시기를 설명합니다.
- 유형
-
object
- 필수 항목
-
스케줄
-
jobTemplate
-
속성 | 유형 | 설명 |
---|---|---|
|
| 작업의 동시 실행을 처리하는 방법을 지정합니다. 유효한 값은 다음과 같습니다. - "허용"(기본값): CronJobs를 동시에 실행할 수 있습니다. - "Forbid": 동시 실행을 금지하고 이전 실행이 완료되지 않은 경우 다음 실행을 건너뜁니다. - "Replace": 현재 실행 중인 작업을 취소하고 새 작업으로 교체합니다.
가능한 enum 값: - |
|
| 유지해야 하는 실패한 작업 수입니다. 값은 음수가 아닌 정수여야 합니다. 기본값은 1입니다. |
|
| JobTemplateSpec은 템플릿에서 만들 때 작업이 수행해야 하는 데이터를 설명합니다. |
|
| Cron 형식의 스케줄입니다. https://en.wikipedia.org/wiki/Cron 을 참조하십시오. |
|
| 어떤 이유로든 예약된 시간을 놓치는 경우 작업을 시작하는 선택적 데드라인(초)입니다. 누락된 작업 실행은 실패한 작업으로 간주됩니다. |
|
| 유지해야 하는 성공한 작업 수입니다. 값은 음수가 아닌 정수여야 합니다. 기본값은 3입니다. |
|
| 이 플래그는 컨트롤러에 후속 실행을 일시 중지하도록 지시합니다. 이미 시작된 실행에는 적용되지 않습니다. 기본값은 false입니다. |
|
|
지정된 스케줄의 시간대 이름, 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 베타 필드이며 |
6.1.2. .spec.jobTemplate
- 설명
- JobTemplateSpec은 템플릿에서 만들 때 작업이 수행해야 하는 데이터를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 이 템플릿에서 생성된 작업의 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다. |
6.1.3. .spec.jobTemplate.spec
- 설명
- JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다.
- 유형
-
object
- 필수 항목
-
템플릿
-
속성 | 유형 | 설명 |
---|---|---|
|
| 작업을 종료하기 전에 작업이 지속적으로 활성화될 수 있는 startTime에 대한 시간(초)을 지정합니다. value는 양의 정수여야 합니다. 작업이 일시 중지된 경우(생성 또는 업데이트를 통해) 작업을 다시 시작할 때 이 타이머는 효과적으로 중지되고 재설정됩니다. |
|
| 이 작업을 실패로 표시하기 전에 재시도 횟수를 지정합니다. 기본값은 6입니다. |
|
|
CompletionMode는 Pod 완료 방법을 지정합니다.
나중에 더 많은 완료 모드를 추가할 수 있습니다. 작업 컨트롤러에서 인식하지 못하는 모드를 관찰하는 경우 버전 스큐로 인해 업그레이드 중에 가능한 경우 컨트롤러는 작업에 대한 업데이트를 건너뜁니다. |
|
| 작업을 실행해야 하는 성공적으로 완료된 Pod 수를 지정합니다. nil로 설정하면 Pod의 성공이 모든 Pod의 성공과 병렬 처리가 긍정적인 값을 갖도록 허용됨을 의미합니다. 1로 설정하면 병렬 처리가 1로 제한되고 해당 Pod의 성공이 작업이 성공했음을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
|
manualSelector는 Pod 라벨 및 Pod 선택기 생성을 제어합니다. 수행 중인 작업을 확신하지 않는 한 |
|
| 작업이 지정된 시간에 실행해야 하는 최대 Pod 수를 지정합니다. steady 상태에서 실행되는 실제 Pod 수는 (.spec.completions - .status.successful) < .spec.parallelism)인 경우, 즉, 수행할 작업이 최대 병렬 처리보다 적을 때 이 수보다 적습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
| PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다. |
| Pod 수와 일치해야 하는 Pod에 대한 라벨 쿼리입니다. 일반적으로 시스템은 이 필드를 설정합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
|
| suspend는 작업 컨트롤러에서 Pod를 생성해야 하는지 여부를 지정합니다. suspend를 true로 설정하여 작업이 생성되면 작업 컨트롤러에서 Pod를 생성하지 않습니다. 생성 후 작업이 일시 중지되면(즉, 플래그가 false에서 true로 전환됨) 작업 컨트롤러에서 이 작업과 연결된 활성 Pod를 모두 삭제합니다. 사용자는 이를 정상적으로 처리하도록 워크로드를 설계해야 합니다. 작업을 일시 중지하면 작업의 StartTime 필드가 재설정되고 ActiveDeadlineSeconds 타이머도 효과적으로 재설정됩니다. 기본값은 false입니다. |
| 작업을 실행할 때 생성할 Pod를 설명합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ | |
|
| ttlSecondsAfterFinished는 완료된 작업(완료 또는 실패)의 수명을 제한합니다. 작업이 완료된 후 ttlSecondsAfterFinished 필드가 설정되면 자동으로 삭제할 수 있습니다. 작업이 삭제되면 해당 라이프사이클 보장(예: 종료자)이 적용됩니다. 이 필드가 설정되지 않으면 작업이 자동으로 삭제되지 않습니다. 이 필드를 0으로 설정하면 작업이 완료된 직후에 삭제할 수 있습니다. |
6.1.4. .spec.jobTemplate.spec.podFailurePolicy
- 설명
- PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다.
- 유형
-
object
- 필수 항목
-
규칙
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod 실패 정책 규칙 목록입니다. 규칙은 순서대로 평가됩니다. 규칙이 Pod 실패와 일치하면 나머지 규칙은 무시됩니다. Pod 실패와 일치하는 규칙이 없으면 기본 처리가 적용됩니다. Pod 실패 카운터가 증가되고 backoffLimit에 대해 확인됩니다. 최대 20개의 요소가 허용됩니다. |
|
| 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
- 필수 항목
-
작업
-
속성 | 유형 | 설명 |
---|---|---|
|
| 요구 사항이 충족되면 Pod 실패 시 수행된 작업을 지정합니다. 가능한 값은 - FailJob: Pod의 작업이 Failed로 표시되고 실행 중인 모든 Pod가 종료되었음을 나타냅니다. - Ignore: 는 .backoffLimit를 향하는 카운터가 증가되지 않고 교체 Pod가 생성됨을 나타냅니다. - Count:는 Pod가 기본적으로 처리됨을 나타냅니다(.backLimit에 대한 카운터가 증가됨을 나타냅니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 규칙을 건너뛰어 알 수 없는 작업에 응답해야 합니다.
가능한 enum 값: - |
|
| PodFailurePolicyOnExitCodesRequirement는 컨테이너 종료 코드를 기반으로 실패한 Pod를 처리하기 위한 요구 사항을 설명합니다. 특히 Pod 상태의 .status.containerStatuses 및 .status.initContainerStatuses 필드에 각각 표시되는 각 앱 컨테이너 및 init 컨테이너 상태에 대해 .state.terminated.exitCode를 조회합니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. |
|
| Pod 조건에 대한 요구 사항을 나타냅니다. 요구 사항은 Pod 상태 패턴 목록으로 표시됩니다. 하나 이상의 패턴이 실제 Pod 조건과 일치하는 경우 요구 사항이 충족됩니다. 최대 20개의 요소가 허용됩니다. |
|
| 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
-
값
-
속성 | 유형 | 설명 |
---|---|---|
|
| 지정된 이름으로 컨테이너의 종료 코드를 검사를 제한합니다. null인 경우 규칙이 모든 컨테이너에 적용됩니다. 지정하면 Pod 템플릿의 컨테이너 또는 initContainer 이름과 일치해야 합니다. |
|
| 컨테이너 종료 코드와 지정된 값 간의 관계를 나타냅니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. 가능한 값은 다음과 같습니다. - In: 하나 이상의 컨테이너 종료 코드( 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개인 경우 여러 개)가 지정된 값 세트에 있는 경우 여러 컨테이너가 충족됩니다. - NotIn: NotIn: 컨테이너 종료 코드 중 하나 이상이 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개 있는 경우 요구 사항이 충족됩니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 요구 사항이 충족되지 않았음을 가정하여 알 수 없는 Operator에 반응해야 합니다.
가능한 열거 값: - |
|
| 값 집합을 지정합니다. 반환된 각 컨테이너 종료 코드(여러 컨테이너의 경우 여러 개)가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필요한 Pod 상태 상태를 지정합니다. Pod 조건과 일치하려면 지정된 상태가 Pod 조건 상태와 같아야 합니다. 기본값은 True입니다. |
|
| 필요한 Pod 조건 유형을 지정합니다. Pod 조건과 일치하려면 지정된 유형이 Pod 조건 유형과 같아야 합니다. |
6.1.10. .status
- 설명
- CronJobStatus는 cron 작업의 현재 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 현재 실행 중인 작업에 대한 포인터 목록입니다. | |
| 작업이 성공적으로 예약된 마지막 시간이었습니다. | |
| 작업이 마지막으로 완료된 시점의 정보입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- CronJob 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.2. /apis/batch/v1/watch/cronjobs
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- CronJob. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.3. /apis/batch/v1/namespaces/{namespace}/cronjobs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- CronJob 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- CronJob 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- CronJob 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
6.2.4. /apis/batch/v1/watch/namespaces/{namespace}/cronjobs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- CronJob. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.5. /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| CronJob의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- delete a CronJob
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 CronJob 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CronJob을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 CronJob을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6.2.6. /apis/batch/v1/watch/namespaces/{namespace}/cronjobs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| CronJob의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- CronJob. deprecated 유형의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
6.2.7. /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| CronJob의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 CronJob의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 CronJob의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 CronJob의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7장. DaemonSet [apps/v1]
- 설명
- DaemonSet은 데몬 세트의 구성을 나타냅니다.
- 유형
-
object
7.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| DaemonSetSpec은 데몬 세트의 사양입니다. |
|
| DaemonSetStatus는 데몬 세트의 현재 상태를 나타냅니다. |
7.1.1. .spec
- 설명
- DaemonSetSpec은 데몬 세트의 사양입니다.
- 유형
-
object
- 필수 항목
-
선택기
-
템플릿
-
속성 | 유형 | 설명 |
---|---|---|
|
| 새로 생성된 DaemonSet Pod가 컨테이너 충돌 없이 준비해야 하는 최소 시간(초)을 사용할 수 있는 것으로 간주해야 합니다. 기본값은 0입니다(포드가 준비되는 즉시 사용 가능한 것으로 간주됨). |
|
| 롤백을 허용하기 위해 보유할 이전 기록 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 10입니다. |
| 데몬 세트에서 관리하는 Pod에 대한 라벨 쿼리입니다. 제어하려면 일치해야합니다. Pod 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
| 생성할 Pod를 설명하는 오브젝트입니다. DaemonSet은 템플릿의 노드 선택기와 일치하는 모든 노드에서 (또는 노드 선택기를 지정하지 않은 경우 모든 노드에서) 정확히 하나의 복사본을 생성합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template | |
|
| DaemonSetUpdateStrategy는 DaemonSet의 업데이트 전략을 제어하는 데 사용되는 구조입니다. |
7.1.2. .spec.updateStrategy
- 설명
- DaemonSetUpdateStrategy는 DaemonSet의 업데이트 전략을 제어하는 데 사용되는 구조입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 데몬 세트 롤링 업데이트의 원하는 동작을 제어하는 사양입니다. |
|
| 데몬 세트 업데이트 유형입니다. "RollingUpdate" 또는 "OnDelete"일 수 있습니다. 기본값은 RollingUpdate입니다.
가능한 enum 값: - |
7.1.3. .spec.updateStrategy.rollingUpdate
- 설명
- 데몬 세트 롤링 업데이트의 원하는 동작을 제어하는 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 업데이트 중 업데이트된 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가 급증 제한을 고려하지 않고 해당 노드에 즉시 생성됩니다. 서지 허용은 지정된 노드에서 데몬 세트에서 사용하는 리소스가 두 배가 될 수 있음을 의미합니다. 따라서 준비 상태 점검이 실패하면 리소스 집약적 데몬 세트에서 두 배로 증가할 수 있으므로 중단 중에 제거가 발생할 수 있습니다. | |
| 업데이트 중에 사용할 수 없는 최대 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| DaemonSet의 해시 충돌 수입니다. DaemonSet 컨트롤러는 최신 ControllerRevision의 이름을 생성해야 하는 경우 이 필드를 충돌 방지 메커니즘으로 사용합니다. |
|
| DaemonSet의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| DaemonSetCondition은 특정 시점에서 DaemonSet의 상태를 설명합니다. |
|
| 데몬 Pod가 1개 이상 실행되고 데몬 Pod를 실행해야 하는 노드 수입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/ |
|
| 데몬 Pod를 실행해야 하는 총 노드 수입니다(임시 Pod를 올바르게 실행하는 노드 포함). 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/ |
|
| 데몬 Pod를 실행하고 하나 이상의 데몬 Pod를 실행하고 사용할 수 있는 노드 수(최소 spec.minReadySeconds 이상) |
|
| 데몬 Pod를 실행 중이지만 데몬 Pod를 실행하지 않는 노드 수입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/ |
|
| numberReady는 데몬 Pod를 실행해야 하며 Ready 상태에서 하나 이상의 데몬 Pod를 실행해야 하는 노드 수입니다. |
|
| 데몬 Pod를 실행해야 하며 데몬 Pod가 실행되지 않고 사용 가능한 데몬 Pod가 없는 노드 수입니다(최소 spec.minReadySeconds 이상) |
|
| 데몬 세트 컨트롤러에서 관찰하는 최신 생성입니다. |
|
| 업데이트된 데몬 Pod를 실행 중인 총 노드 수 |
7.1.5. .status.conditions
- 설명
- DaemonSet의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
7.1.6. .status.conditions[]
- 설명
- DaemonSetCondition은 특정 시점에서 DaemonSet의 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 일련의 DaemonSet 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
7.2.2. /apis/apps/v1/watch/daemonsets
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- DaemonSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
7.2.3. /apis/apps/v1/namespaces/{namespace}/daemonsets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- DaemonSet 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 일련의 DaemonSet 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- DaemonSet 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
7.2.4. /apis/apps/v1/watch/namespaces/{namespace}/daemonsets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- DaemonSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
7.2.5. /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| DaemonSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- DaemonSet 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 DaemonSet 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 DaemonSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 DaemonSet을 교체합니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7.2.6. /apis/apps/v1/watch/namespaces/{namespace}/daemonsets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| DaemonSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 유형의 DaemonSet 개체를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
7.2.7. /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| DaemonSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 DaemonSet의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 DaemonSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 DaemonSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8장. 배포 [apps/v1]
- 설명
- 배포를 사용하면 Pod 및 ReplicaSet에 대한 선언적 업데이트가 활성화됩니다.
- 유형
-
object
8.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| DeploymentSpec은 원하는 배포 동작의 사양입니다. |
|
| DeploymentStatus는 가장 최근에 관찰된 배포 상태입니다. |
8.1.1. .spec
- 설명
- DeploymentSpec은 원하는 배포 동작의 사양입니다.
- 유형
-
object
- 필수 항목
-
선택기
-
템플릿
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)을 사용할 수 있습니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨) |
|
| 배포가 일시 중지되었음을 나타냅니다. |
|
| 배포가 실패로 간주되기 전에 진행할 수 있는 최대 시간(초)입니다. 배포 컨트롤러는 실패한 배포를 계속 처리하고 ProgressDeadlineExceeded 이유가 있는 조건이 배포 상태에 표시됩니다. 배포가 일시 중지되는 동안 진행 상황을 추정하지 않습니다. 기본값은 600입니다. |
|
| 원하는 Pod 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다. |
|
| 롤백을 허용하기 위해 보유할 이전 ReplicaSet 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 10입니다. |
| Pod의 라벨 선택기입니다. 이 과정에서 선택한 Pod가 있는 기존 ReplicaSet은 이 배포의 영향을 받는 것입니다. Pod 템플릿의 레이블과 일치해야 합니다. | |
|
| DeploymentStrategy는 기존 Pod를 새 Pod로 교체하는 방법을 설명합니다. |
| 템플릿은 생성할 Pod를 설명합니다. |
8.1.2. .spec.strategy
- 설명
- DeploymentStrategy는 기존 Pod를 새 Pod로 교체하는 방법을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 롤링 업데이트의 원하는 동작을 제어하는 사양입니다. |
|
| 배포 유형입니다. "Recreate" 또는 "RollingUpdate"일 수 있습니다. 기본값은 RollingUpdate입니다.
가능한 enum 값: - |
8.1.3. .spec.strategy.rollingUpdate
- 설명
- 롤링 업데이트의 원하는 동작을 제어하는 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 원하는 Pod 수 이상으로 예약할 수 있는 최대 Pod 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. MaxUnavailable이 0인 경우 이 값은 0이 될 수 없습니다. 절대 수는 백분율로 반올림하여 계산됩니다. 기본값은 25%입니다. 예: 이 값을 30 %로 설정하면 롤링 업데이트가 시작될 때 새 ReplicaSet을 즉시 확장할 수 있으므로 이전 Pod와 새 Pod의 총 수가 원하는 Pod의30%를 초과하지 않습니다. 이전 Pod가 종료되면 새 ReplicaSet을 추가로 확장할 수 있으므로 업데이트 중에 언제든지 실행 중인 총 Pod 수가 원하는 Pod의 최대 192.0.2.%가 되도록 할 수 있습니다. | |
| 업데이트 중에 사용할 수 없는 최대 Pod 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. MaxSurge가 0인 경우 이 값은 0이 될 수 없습니다. 기본값은 25%입니다. 예: 이 값을 30%로 설정하면 롤링 업데이트가 시작될 때 이전 ReplicaSet을 원하는 Pod의 70%로 즉시 축소할 수 있습니다. 새 Pod가 준비되면 이전 ReplicaSet을 추가로 축소한 후 새 ReplicaSet을 확장하여 업데이트 중에 항상 사용 가능한 총 Pod 수가 필요한 Pod의 70% 이상인지 확인할 수 있습니다. |
8.1.4. .status
- 설명
- DeploymentStatus는 가장 최근에 관찰된 배포 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이 배포를 대상으로 하는 사용 가능한 총 Pod 수(최소 minReadySeconds) 수입니다. |
|
| 배포에 대한 해시 충돌 수입니다. 배포 컨트롤러는 최신 ReplicaSet의 이름을 생성해야 하는 경우 이 필드를 충돌 방지 메커니즘으로 사용합니다. |
|
| 배포의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| DeploymentCondition은 특정 시점에서 배포 상태를 설명합니다. |
|
| 배포 컨트롤러에서 관찰하는 생성입니다. |
|
| ReadyReplicas는 이 배포에서 Ready 상태가 되는 Pod 수입니다. |
|
| 이 배포를 대상으로 하는 총 종료되지 않은 Pod 수입니다(해당 레이블은 선택기와 일치). |
|
| 이 배포에서 대상으로 하는 총 사용 불가능한 Pod 수입니다. 이는 배포에 필요한 총 Pod 수에 100% 사용 가능한 용량이 있습니다. 실행 중이지만 아직 사용할 수 없는 Pod 또는 아직 생성되지 않은 Pod일 수 있습니다. |
|
| 원하는 템플릿 사양이 있는 이 배포를 대상으로 하는 총 종료되지 않은 Pod 수입니다. |
8.1.5. .status.conditions
- 설명
- 배포의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
8.1.6. .status.conditions[]
- 설명
- DeploymentCondition은 특정 시점에서 배포 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
| 이 조건이 마지막으로 업데이트된 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 배포 조건 유형입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 배포 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.2. /apis/apps/v1/watch/deployments
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.3. /apis/apps/v1/namespaces/{namespace}/deployments
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 배포 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 배포 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 배포 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
8.2.4. /apis/apps/v1/watch/namespaces/{namespace}/deployments
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Deployment. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.5. /apis/apps/v1/namespaces/{namespace}/deployments/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 배포 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 배포 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 배포 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 배포를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 배포 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8.2.6. /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 배포 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 유형의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.7. /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 배포 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 배포의 상태 확인
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 배포의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 배포의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9장. DeploymentConfig [apps.openshift.io/v1]
- 설명
배포 구성은 Pod에 대한 템플릿을 정의하고 새 이미지 또는 구성 변경 배포를 관리합니다. 단일 배포 구성은 일반적으로 단일 마이크로 서비스와 유사합니다. 전체 재시작, 사용자 정의 롤링 업데이트, 완전히 사용자 지정 동작, 사전 및 배포 후 후크를 비롯한 다양한 배포 패턴을 지원할 수 있습니다. 각 개별 배포는 복제 컨트롤러로 표시됩니다.
구성이 변경되거나 이미지 스트림의 태그가 변경되면 배포가 "triggered"됩니다. 배포를 수동으로 제어할 수 있도록 트리거를 비활성화할 수 있습니다. "전략"은 배포 수행 방법을 결정하고 언제든지 변경될 수 있습니다.
latestVersion
필드는 새로운 배포가 어떤 수단에 의해 트리거될 때 업데이트됩니다.호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
9.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ||
|
| DeploymentConfigSpec은 원하는 배포 상태를 나타냅니다. |
|
| DeploymentConfigStatus는 현재 배포 상태를 나타냅니다. |
9.1.1. .spec
- 설명
- DeploymentConfigSpec은 원하는 배포 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| minReadySeconds는 컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)입니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨) |
|
| paused는 배포 구성이 일시 중지되어 다른 트리거로 인한 템플릿 변경이나 템플릿 변경에 대한 새 배포가 발생하지 않음을 나타냅니다. |
|
| replicas는 원하는 복제본 수입니다. |
|
| RevisionHistoryLimit은 롤백을 허용하도록 유지할 이전 ReplicationController 수입니다. 이 필드는 명시적 0과 지정되지 않은 경우를 구분할 수 있는 포인터입니다. 기본값은 10입니다. (기존 리소스가 아닌 새 그룹 API 리소스를 통해 생성된 DeploymentConfig에만 적용됩니다.) |
|
| selector는 Replicas 수와 일치해야 하는 Pod의 레이블 쿼리입니다. |
|
| DeploymentStrategy는 배포를 수행하는 방법을 설명합니다. |
| 템플릿은 충분하지 않은 복제본이 감지되면 생성되는 Pod를 설명하는 오브젝트입니다. | |
|
| test는 배포가 실행되는 경우를 제외하고 이 배포 구성에 복제본이 0인지 확인합니다. 이를 통해 배포 구성을 연속 배포 테스트로 사용할 수 있습니다. 이미지 트리거, 배포를 실행한 다음 성공 또는 실패합니다. 전략 후 후크 및 작업 후 작업을 사용하여 성공적인 배포를 작업과 통합할 수 있습니다. |
|
| Trigger가 DeploymentConfig에 대한 업데이트로 인해 새 배포가 생성되는 방식을 결정합니다. 트리거가 정의되지 않은 경우 새 LatestVersion을 사용하여 DeploymentConfig에 대한 명시적 클라이언트 업데이트로 인해 새 배포가 발생할 수 있습니다. null인 경우 기본적으로 구성 변경 트리거가 있습니다. |
|
| DeploymentTriggerPolicy는 새 배포를 생성하는 단일 트리거에 대한 정책을 설명합니다. |
9.1.2. .spec.strategy
- 설명
- DeploymentStrategy는 배포를 수행하는 방법을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| activeDeadlineSeconds는 시스템이 적극적으로 종료하려고 시도하기 전에 이 배포 구성의 배포자 Pod가 노드에서 활성화될 수 있는 시간(초)입니다. |
|
| 주석은 사용자 정의 배포자 및 후크 Pod 사전/게스트 포드의 라이프사이클에 추가된 키, 값 쌍 세트입니다. |
|
| CustomDeploymentStrategyParams는 사용자 정의 배포 전략에 대한 입력입니다. |
|
| 레이블은 사용자 정의 배포자 및 후크 사전/게스트 포드의 라이프사이클에 추가된 키, 값 쌍 세트입니다. |
|
| RecreateDeploymentStrategyParams는 Recreate 배포 전략에 대한 입력입니다. |
| 리소스에는 배포 및 후크를 실행하기 위한 리소스 요구 사항이 포함되어 있습니다. | |
|
| RollingDeploymentStrategyParams는 롤링 배포 전략에 대한 입력입니다. |
|
| type은 배포 전략의 이름입니다. |
9.1.3. .spec.strategy.customParams
- 설명
- CustomDeploymentStrategyParams는 사용자 정의 배포 전략에 대한 입력입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 선택 사항이며 컨테이너 이미지의 CMD를 덮어씁니다. |
| 환경에는 이미지용으로 컨테이너에 제공할 환경이 있습니다. | |
|
| image는 배포를 수행할 수 있는 컨테이너 이미지를 지정합니다. |
9.1.4. .spec.strategy.recreateParams
- 설명
- RecreateDeploymentStrategyParams는 Recreate 배포 전략에 대한 입력입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다. |
|
| LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다. |
|
| LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다. |
|
| timeoutSeconds는 포기하기 전에 업데이트를 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다. |
9.1.5. .spec.strategy.recreateParams.mid
- 설명
- LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
failurePolicy
-
속성 | 유형 | 설명 |
---|---|---|
|
| ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다. |
|
| failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다. |
|
| TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다. |
|
| TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다. |
9.1.6. .spec.strategy.recreateParams.mid.execNewPod
- 설명
- ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
- 유형
-
object
- 필수 항목
-
command
-
containerName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 작업 명령 및 해당 인수입니다. |
|
| containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다. |
| env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다. | |
|
| 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은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다. |
| to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다. |
9.1.9. .spec.strategy.recreateParams.post
- 설명
- LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
failurePolicy
-
속성 | 유형 | 설명 |
---|---|---|
|
| ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다. |
|
| failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다. |
|
| TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다. |
|
| TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다. |
9.1.10. .spec.strategy.recreateParams.post.execNewPod
- 설명
- ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
- 유형
-
object
- 필수 항목
-
command
-
containerName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 작업 명령 및 해당 인수입니다. |
|
| containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다. |
| env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다. | |
|
| 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은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다. |
| to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다. |
9.1.13. .spec.strategy.recreateParams.pre
- 설명
- LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
failurePolicy
-
속성 | 유형 | 설명 |
---|---|---|
|
| ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다. |
|
| failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다. |
|
| TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다. |
|
| TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다. |
9.1.14. .spec.strategy.recreateParams.pre.execNewPod
- 설명
- ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
- 유형
-
object
- 필수 항목
-
command
-
containerName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 작업 명령 및 해당 인수입니다. |
|
| containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다. |
| env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다. | |
|
| 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은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다. |
| to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다. |
9.1.17. .spec.strategy.rollingParams
- 설명
- RollingDeploymentStrategyParams는 롤링 배포 전략에 대한 입력입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| IntervalSeconds는 업데이트 후 배포 상태를 폴링할 때까지 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다. |
| maxSurge는 원래 Pod 수 이상으로 예약할 수 있는 최대 Pod 수입니다. 값은 절대 번호(예: 5) 또는 업데이트 시작 시 총 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. MaxUnavailable이 0인 경우 이 값은 0이 될 수 없습니다. 기본적으로 25%가 사용됩니다. 예: 이 값을 30%로 설정하면 롤링 업데이트가 시작될 때 즉시 새 RC를 30%까지 확장할 수 있습니다. 이전 Pod가 종료되면 새 RC를 추가로 확장할 수 있으므로 업데이트 중에 언제든지 실행 중인 총 Pod 수가 원래 Pod의 최대 controlPlane%가 되도록 할 수 있습니다. | |
| maxUnavailable은 업데이트 중에 사용할 수 없는 최대 Pod 수입니다. 값은 절대 번호(예: 5) 또는 업데이트 시작 시 총 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. MaxSurge가 0인 경우 이 값은 0이 될 수 없습니다. 기본적으로 25%가 사용됩니다. 예: 이 값을 30%로 설정하면 롤링 업데이트가 시작될 때 즉시 이전 RC를 30%까지 축소할 수 있습니다. 새 Pod가 준비되면 이전 RC를 추가로 축소한 후 새 RC를 확장하여 업데이트 중에 원래 Pod 수의 70% 이상을 사용할 수 있습니다. | |
|
| LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다. |
|
| LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다. |
|
| timeoutSeconds는 포기하기 전에 업데이트를 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다. |
|
| UpdatePeriodSeconds는 개별 Pod 업데이트 간에 대기하는 시간입니다. 값이 nil이면 기본값이 사용됩니다. |
9.1.18. .spec.strategy.rollingParams.post
- 설명
- LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
failurePolicy
-
속성 | 유형 | 설명 |
---|---|---|
|
| ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다. |
|
| failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다. |
|
| TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다. |
|
| TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다. |
9.1.19. .spec.strategy.rollingParams.post.execNewPod
- 설명
- ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
- 유형
-
object
- 필수 항목
-
command
-
containerName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 작업 명령 및 해당 인수입니다. |
|
| containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다. |
| env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다. | |
|
| 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은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다. |
| to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다. |
9.1.22. .spec.strategy.rollingParams.pre
- 설명
- LifecycleHook은 특정 배포 라이프사이클 작업을 정의합니다. 언제든지 하나의 작업 유형만 지정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
failurePolicy
-
속성 | 유형 | 설명 |
---|---|---|
|
| ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다. |
|
| failurePolicy는 후크가 실패하는 경우 수행할 작업을 지정합니다. |
|
| TagImages는 배포자에게 컨테이너 아래에 참조된 현재 이미지를 이미지 스트림 태그에 태그하도록 지시합니다. |
|
| TagImageHook은 특정 컨테이너의 이미지를 ImageStreamTag에 태그하는 요청입니다. |
9.1.23. .spec.strategy.rollingParams.pre.execNewPod
- 설명
- ExecNewPodHook은 배포 템플릿의 일부로 간주되는 지정된 컨테이너를 기반으로 새 Pod에서 명령을 실행하는 후크 구현입니다.
- 유형
-
object
- 필수 항목
-
command
-
containerName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 작업 명령 및 해당 인수입니다. |
|
| containername은 배포 Pod 템플릿의 컨테이너 이름입니다. 이때 컨테이너 이미지는 후크 Pod의 컨테이너에 사용됩니다. |
| env는 후크 Pod의 컨테이너에 제공하는 환경 변수 세트입니다. | |
|
| 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은 배포 구성의 컨테이너 이름입니다. 이미지 값이 태그 소스로 사용됩니다. 단일 컨테이너만 있는 경우 이 값은 해당 컨테이너의 이름으로 설정됩니다. |
| to는 컨테이너의 이미지를 설정하는 대상 ImageStreamTag입니다. |
9.1.26. .spec.triggers
- 설명
- Trigger가 DeploymentConfig에 대한 업데이트로 인해 새 배포가 생성되는 방식을 결정합니다. 트리거가 정의되지 않은 경우 새 LatestVersion을 사용하여 DeploymentConfig에 대한 명시적 클라이언트 업데이트로 인해 새 배포가 발생할 수 있습니다. null인 경우 기본적으로 구성 변경 트리거가 있습니다.
- 유형
-
array
9.1.27. .spec.triggers[]
- 설명
- DeploymentTriggerPolicy는 새 배포를 생성하는 단일 트리거에 대한 정책을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DeploymentTriggerImageChangeParams는 ImageChange 트리거에 대한 매개변수를 나타냅니다. |
|
| 트리거의 유형 |
9.1.28. .spec.triggers[].imageChangeParams
- 설명
- DeploymentTriggerImageChangeParams는 ImageChange 트리거에 대한 매개변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
|
| 자동이란 새 태그 값을 탐지하면 pod 템플릿 내에서 이미지가 업데이트되어야 합니다. |
|
| ContainerNames는 Pod에서 지정된 컨테이너 이름 세트로 태그 업데이트를 제한하는 데 사용됩니다. 여러 트리거가 동일한 컨테이너를 가리키는 경우 결과 동작이 정의되지 않습니다. 향후 API 버전에서는 검증 오류가 발생합니다. ContainerNames에서 유효한 컨테이너를 가리키지 않으면 트리거가 무시됩니다. 향후 API 버전에서는 검증 오류가 발생합니다. |
| 에서 변경 사항을 조사할 이미지 스트림 태그에 대한 참조입니다. from.Name은 유일한 필수 하위 필드입니다 - From.Namespace가 비어 있으면 현재 배포 트리거의 네임스페이스가 사용됩니다. | |
|
| LastTriggeredImage는 트리거할 마지막 이미지입니다. |
9.1.29. .status
- 설명
- DeploymentConfigStatus는 현재 배포 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
latestVersion
-
observedGeneration
-
replicas
-
updatedReplicas
-
availableReplicas
-
unavailableReplicas
-
속성 | 유형 | 설명 |
---|---|---|
|
| AvailableReplicas는 이 배포 구성에서 대상으로 하는 총 사용 가능한 Pod 수입니다. |
|
| conditions는 배포 구성의 현재 상태를 확인할 수 있는 최신 상태를 나타냅니다. |
|
| DeploymentCondition은 특정 시점에서 배포 구성 상태를 설명합니다. |
|
| Deployment Details는 배포 원인에 대한 정보를 캡처합니다. |
|
| LatestVersion은 배포 구성과 연결된 현재 배포가 동기화되지 않았는지 확인하는 데 사용됩니다. |
|
| observedGeneration은 배포 구성 컨트롤러에서 관찰하는 최신 생성입니다. |
|
| 이 배포에서 대상으로 하는 총 준비된 Pod 수입니다. |
|
| replicas는 이 배포 구성에서 대상으로 하는 총 Pod 수입니다. |
|
| UnavailableReplicas는 이 배포 구성에서 대상으로 하는 사용 불가능한 총 Pod 수입니다. |
|
| UpdatedReplicas는 원하는 템플릿 사양이 있는 이 배포 구성에서 대상으로 하는 종료되지 않은 총 Pod 수입니다. |
9.1.30. .status.conditions
- 설명
- conditions는 배포 구성의 현재 상태를 확인할 수 있는 최신 상태를 나타냅니다.
- 유형
-
array
9.1.31. .status.conditions[]
- 설명
- DeploymentCondition은 특정 시점에서 배포 구성 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
| 이 조건이 마지막으로 업데이트된 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 배포 조건 유형입니다. |
9.1.32. .status.details
- 설명
- Deployment Details는 배포 원인에 대한 정보를 캡처합니다.
- 유형
-
object
- 필수 항목
-
원인
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이는 새 배포를 생성하기 위한 모든 원인과 연결된 확장된 데이터입니다. |
|
| DeploymentCause는 배포의 특정 원인에 대한 정보를 캡처합니다. |
|
| message는 사용자가 이 배포가 수동으로 트리거된 경우 변경 메시지입니다. |
9.1.33. .status.details.causes
- 설명
- 이는 새 배포를 생성하기 위한 모든 원인과 연결된 확장된 데이터입니다.
- 유형
-
array
9.1.34. .status.details.causes[]
- 설명
- DeploymentCause는 배포의 특정 원인에 대한 정보를 캡처합니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| DeploymentCauseImageTrigger는 이미지 변경 트리거에서 발생하는 배포 원인에 대한 세부 정보를 나타냅니다. |
|
| 새 배포가 생성된 트리거의 유형 |
9.1.35. .status.details.causes[].imageTrigger
- 설명
- DeploymentCauseImageTrigger는 이미지 변경 트리거에서 발생하는 배포 원인에 대한 세부 정보를 나타냅니다.
- 유형
-
object
- 필수 항목
-
from
-
속성 | 유형 | 설명 |
---|---|---|
| 에서 배포를 트리거한 변경된 오브젝트에 대한 참조입니다. 이 필드에는 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- DeploymentConfig 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.2. /apis/apps.openshift.io/v1/watch/deploymentconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- DeploymentConfig. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.3. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- DeploymentConfig 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- DeploymentConfig 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- DeploymentConfig 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
9.2.4. /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- DeploymentConfig. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.5. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| DeploymentConfig의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- DeploymentConfig 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 DeploymentConfig 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 DeploymentConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 DeploymentConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9.2.6. /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| DeploymentConfig의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- DeploymentConfig. deprecated 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.7. /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| DeploymentConfig의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 DeploymentConfig의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 DeploymentConfig의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 DeploymentConfig의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10장. DeploymentConfigRollback [apps.openshift.io/v1]
- 설명
DeploymentConfigRollback은 롤백 생성에 대한 입력을 제공합니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
spec
-
10.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 롤백할 배포 구성의 이름입니다. |
|
| DeploymentConfigRollbackSpec은 롤백 생성 옵션을 나타냅니다. |
|
| UpdatedAnnotations는 배포 구성에 추가될 새 주석 세트입니다. |
10.1.1. .spec
- 설명
- DeploymentConfigRollbackSpec은 롤백 생성 옵션을 나타냅니다.
- 유형
-
object
- 필수 항목
-
from
-
includeTriggers
-
includeTemplate
-
includeReplicationMeta
-
includeStrategy
-
속성 | 유형 | 설명 |
---|---|---|
| 배포인 ReplicationController를 가리킵니다. | |
|
| IncludeReplicationMeta 는 복제본 수와 선택기를 포함할지 여부를 지정합니다. |
|
| IncludeStrategy는 배포 전략을 포함할지 여부를 지정합니다. |
|
| IncludeTemplate은 PodTemplateSpec을 포함할지 여부를 지정합니다. |
|
| IncludeTriggers는 구성 트리거를 포함할지 여부를 지정합니다. |
|
| 롤백할 수 있습니다. 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| DeploymentConfigRollback의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- DeploymentConfig의 롤백 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
11장. DeploymentLog [apps.openshift.io/v1]
- 설명
DeploymentLog는 배포 로그를 나타냅니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
11.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| DeploymentLog의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 로그를 스트리밍할 컨테이너입니다. Pod에 컨테이너가 한 개 있는 경우에만 기본값은 컨테이너입니다. |
|
| true인 경우 빌드가 종료될 때까지 빌드 로그를 스트리밍해야 합니다. |
|
| 설정된 경우 로그 출력을 종료하기 전에 서버에서 읽을 바이트 수입니다. 이는 완전한 최종 로깅 행을 표시하지 않을 수 있으며 지정된 제한보다 약간 많거나 적을 수 있습니다. |
|
| nowait true인 경우 배포를 아직 사용할 수 없는 경우에도 호출이 즉시 반환됩니다. 그렇지 않으면 서버가 배포가 시작될 때까지 기다립니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| 이전 배포 로그를 반환합니다. 기본값은 false입니다. |
|
| 로그를 표시할 현재 시간(초) 전의 상대 시간(초)입니다. 이 값이 Pod를 시작한 시간보다 앞면 Pod 시작 이후의 로그만 반환됩니다. 이 값이 향후이면 로그가 반환되지 않습니다. sinceSeconds 또는 sinceTime 중 하나만 지정할 수 있습니다. |
|
| 설정하는 경우 표시할 로그 끝부분의 행 수입니다. 지정하지 않으면 컨테이너 생성 또는 sinceSeconds 또는 sinceTime에서 로그가 표시됩니다. |
|
| true인 경우 로그 출력의 모든 줄 시작 부분에 RFC3339 또는 RFC3339Nano 타임스탬프를 추가합니다. 기본값은 false입니다. |
|
| 로그를 볼 배포 버전입니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 DeploymentConfig의 로그 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
12장. DeploymentRequest [apps.openshift.io/v1]
- 설명
DeploymentRequest는 새 배포에 대한 배포 구성에 대한 요청입니다.
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
latest
-
force
-
12.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| ExcludeTriggers는 지정된 트리거를 처리하지 않도록 인스턴스화를 지시합니다. 이 필드는 최신의 트리거를 재정의하고 클라이언트가 특정 논리를 제어할 수 있습니다. 지정하지 않으면 이 필드는 무시됩니다. |
|
| force는 새 배포를 강제로 실행하려고 합니다. 배포 구성이 일시 중지되면 true로 설정하면 Invalid 오류가 반환됩니다. |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| latest는 모든 트리거의 최신 상태로 배포 구성을 업데이트합니다. |
|
| 새 배포를 요청하는 배포 구성의 이름입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| DeploymentRequest의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
POST
- 설명
- DeploymentConfig의 인스턴스화 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
13장. 작업 [batch/v1]
- 설명
- job은 단일 작업의 구성을 나타냅니다.
- 유형
-
object
13.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다. |
|
| JobStatus는 작업의 현재 상태를 나타냅니다. |
13.1.1. .spec
- 설명
- JobSpec은 작업 실행이 어떻게 표시되는지 설명합니다.
- 유형
-
object
- 필수 항목
-
템플릿
-
속성 | 유형 | 설명 |
---|---|---|
|
| 작업을 종료하기 전에 작업이 지속적으로 활성화될 수 있는 startTime에 대한 시간(초)을 지정합니다. value는 양의 정수여야 합니다. 작업이 일시 중지된 경우(생성 또는 업데이트를 통해) 작업을 다시 시작할 때 이 타이머는 효과적으로 중지되고 재설정됩니다. |
|
| 이 작업을 실패로 표시하기 전에 재시도 횟수를 지정합니다. 기본값은 6입니다. |
|
|
CompletionMode는 Pod 완료 방법을 지정합니다.
나중에 더 많은 완료 모드를 추가할 수 있습니다. 작업 컨트롤러에서 인식하지 못하는 모드를 관찰하는 경우 버전 스큐로 인해 업그레이드 중에 가능한 경우 컨트롤러는 작업에 대한 업데이트를 건너뜁니다. |
|
| 작업을 실행해야 하는 성공적으로 완료된 Pod 수를 지정합니다. nil로 설정하면 Pod의 성공이 모든 Pod의 성공과 병렬 처리가 긍정적인 값을 갖도록 허용됨을 의미합니다. 1로 설정하면 병렬 처리가 1로 제한되고 해당 Pod의 성공이 작업이 성공했음을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
|
manualSelector는 Pod 라벨 및 Pod 선택기 생성을 제어합니다. 수행 중인 작업을 확신하지 않는 한 |
|
| 작업이 지정된 시간에 실행해야 하는 최대 Pod 수를 지정합니다. steady 상태에서 실행되는 실제 Pod 수는 (.spec.completions - .status.successful) < .spec.parallelism)인 경우, 즉, 수행할 작업이 최대 병렬 처리보다 적을 때 이 수보다 적습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
| PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다. |
| Pod 수와 일치해야 하는 Pod에 대한 라벨 쿼리입니다. 일반적으로 시스템은 이 필드를 설정합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
|
| suspend는 작업 컨트롤러에서 Pod를 생성해야 하는지 여부를 지정합니다. suspend를 true로 설정하여 작업이 생성되면 작업 컨트롤러에서 Pod를 생성하지 않습니다. 생성 후 작업이 일시 중지되면(즉, 플래그가 false에서 true로 전환됨) 작업 컨트롤러에서 이 작업과 연결된 활성 Pod를 모두 삭제합니다. 사용자는 이를 정상적으로 처리하도록 워크로드를 설계해야 합니다. 작업을 일시 중지하면 작업의 StartTime 필드가 재설정되고 ActiveDeadlineSeconds 타이머도 효과적으로 재설정됩니다. 기본값은 false입니다. |
| 작업을 실행할 때 생성할 Pod를 설명합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ | |
|
| ttlSecondsAfterFinished는 완료된 작업(완료 또는 실패)의 수명을 제한합니다. 작업이 완료된 후 ttlSecondsAfterFinished 필드가 설정되면 자동으로 삭제할 수 있습니다. 작업이 삭제되면 해당 라이프사이클 보장(예: 종료자)이 적용됩니다. 이 필드가 설정되지 않으면 작업이 자동으로 삭제되지 않습니다. 이 필드를 0으로 설정하면 작업이 완료된 직후에 삭제할 수 있습니다. |
13.1.2. .spec.podFailurePolicy
- 설명
- PodFailurePolicy는 실패한 Pod가 backoffLimit에 미치는 영향을 설명합니다.
- 유형
-
object
- 필수 항목
-
규칙
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod 실패 정책 규칙 목록입니다. 규칙은 순서대로 평가됩니다. 규칙이 Pod 실패와 일치하면 나머지 규칙은 무시됩니다. Pod 실패와 일치하는 규칙이 없으면 기본 처리가 적용됩니다. Pod 실패 카운터가 증가되고 backoffLimit에 대해 확인됩니다. 최대 20개의 요소가 허용됩니다. |
|
| 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
- 필수 항목
-
작업
-
속성 | 유형 | 설명 |
---|---|---|
|
| 요구 사항이 충족되면 Pod 실패 시 수행된 작업을 지정합니다. 가능한 값은 - FailJob: Pod의 작업이 Failed로 표시되고 실행 중인 모든 Pod가 종료되었음을 나타냅니다. - Ignore: 는 .backoffLimit를 향하는 카운터가 증가되지 않고 교체 Pod가 생성됨을 나타냅니다. - Count:는 Pod가 기본적으로 처리됨을 나타냅니다(.backLimit에 대한 카운터가 증가됨을 나타냅니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 규칙을 건너뛰어 알 수 없는 작업에 응답해야 합니다.
가능한 enum 값: - |
|
| PodFailurePolicyOnExitCodesRequirement는 컨테이너 종료 코드를 기반으로 실패한 Pod를 처리하기 위한 요구 사항을 설명합니다. 특히 Pod 상태의 .status.containerStatuses 및 .status.initContainerStatuses 필드에 각각 표시되는 각 앱 컨테이너 및 init 컨테이너 상태에 대해 .state.terminated.exitCode를 조회합니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. |
|
| Pod 조건에 대한 요구 사항을 나타냅니다. 요구 사항은 Pod 상태 패턴 목록으로 표시됩니다. 하나 이상의 패턴이 실제 Pod 조건과 일치하는 경우 요구 사항이 충족됩니다. 최대 20개의 요소가 허용됩니다. |
|
| PodFailurePolicyOnPodConditionsPattern은 실제 Pod 상태 유형과 일치하는 패턴을 설명합니다. |
13.1.5. .spec.podFailurePolicy.rules[].onExitCodes
- 설명
- PodFailurePolicyOnExitCodesRequirement는 컨테이너 종료 코드를 기반으로 실패한 Pod를 처리하기 위한 요구 사항을 설명합니다. 특히 Pod 상태의 .status.containerStatuses 및 .status.initContainerStatuses 필드에 각각 표시되는 각 앱 컨테이너 및 init 컨테이너 상태에 대해 .state.terminated.exitCode를 조회합니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다.
- 유형
-
object
- 필수 항목
-
operator
-
값
-
속성 | 유형 | 설명 |
---|---|---|
|
| 지정된 이름으로 컨테이너의 종료 코드를 검사를 제한합니다. null인 경우 규칙이 모든 컨테이너에 적용됩니다. 지정하면 Pod 템플릿의 컨테이너 또는 initContainer 이름과 일치해야 합니다. |
|
| 컨테이너 종료 코드와 지정된 값 간의 관계를 나타냅니다. 성공적으로 완료된 컨테이너(코드 0)는 요구 사항 확인에서 제외됩니다. 가능한 값은 다음과 같습니다. - In: 하나 이상의 컨테이너 종료 코드( 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개인 경우 여러 개)가 지정된 값 세트에 있는 경우 여러 컨테이너가 충족됩니다. - NotIn: NotIn: 컨테이너 종료 코드 중 하나 이상이 'containerName' 필드에 의해 제한되지 않은 컨테이너가 여러 개 있는 경우 요구 사항이 충족됩니다. 추가 값은 나중에 추가되는 것으로 간주됩니다. 클라이언트는 요구 사항이 충족되지 않았음을 가정하여 알 수 없는 Operator에 반응해야 합니다.
가능한 열거 값: - |
|
| 값 집합을 지정합니다. 반환된 각 컨테이너 종료 코드(여러 컨테이너의 경우 여러 개)가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필요한 Pod 상태 상태를 지정합니다. Pod 조건과 일치하려면 지정된 상태가 Pod 조건 상태와 같아야 합니다. 기본값은 True입니다. |
|
| 필요한 Pod 조건 유형을 지정합니다. Pod 조건과 일치하려면 지정된 유형이 Pod 조건 유형과 같아야 합니다. |
13.1.8. .status
- 설명
- JobStatus는 작업의 현재 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 보류 중 Pod 및 실행 중인 Pod 수입니다. |
|
| CompletedIndexes는 텍스트 형식으로 .spec.completionMode = "Indexed"인 경우 완료된 인덱스를 보유합니다. 인덱스는 쉼표로 구분된 10진수 정수로 표시됩니다. 숫자가 늘어나는 순서로 나열됩니다. 세 개 이상의 연속 숫자가 압축되고 시리즈의 첫 번째 요소와 마지막 요소로 표현되며 하이픈으로 구분됩니다. 예를 들어 완료된 인덱스가 1, 3, 4, 5 및 7인 경우 해당 인덱스가 "1,3-5,7"으로 표시됩니다. |
| 작업이 완료된 시간을 나타냅니다. 별도의 작업에 대해 수행 순서에 따라 설정되는 것은 보장되지 않습니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. 완료 시간은 작업이 성공적으로 완료된 경우에만 설정됩니다. | |
|
| 오브젝트의 현재 상태에 대한 사용 가능한 최신 관찰입니다. 작업이 실패하면 조건 중 하나에 "Failed" 및 status true가 있습니다. 작업이 일시 중지되면 조건 중 하나에 "Suspended" 및 status true가 있습니다. 작업이 다시 시작되면 이 조건의 상태는 false가 됩니다. 작업이 완료되면 조건 중 하나에 "Complete" 및 status true가 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/ |
|
| JobCondition은 작업의 현재 상태를 설명합니다. |
|
| 실패한 Pod 수입니다. |
|
| Ready 조건이 있는 Pod 수입니다. 이 필드는 베타 수준입니다. 기능 게이트 JobReadyPods가 활성화된 경우 작업 컨트롤러에서 필드를 채웁니다(기본적으로 활성화). |
| 작업 컨트롤러가 작업 처리를 시작한 시간을 나타냅니다. 작업이 일시 중지된 상태에서 생성되면 이 필드는 처음 다시 시작할 때까지 설정되지 않습니다. 이 필드는 일시 중지에서 작업을 다시 시작할 때마다 재설정됩니다. RFC3339 형식으로 표시되고 UTC로 표시됩니다. | |
|
| 성공 단계에 도달한 Pod 수입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
| 조건을 마지막으로 확인한 시간입니다. | |
| 상태가 다른 상태에서 다른 상태로 전환되는 마지막 시간입니다. | |
|
| 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유 |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 작업 조건 유형, 완료 또는 실패. |
13.1.11. .status.uncountedTerminatedPods
- 설명
- UncountedTerminatedPods는 종료되었지만 작업 상태 카운터에서 고려하지 않은 Pod의 UID를 보유하고 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| failed에는 실패한 Pod의 UID가 포함되어 있습니다. |
|
| 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 작업 유형 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
13.2.2. /apis/batch/v1/watch/jobs
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Job. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
13.2.3. /apis/batch/v1/namespaces/{namespace}/jobs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 작업 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 작업 유형 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 작업 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
13.2.4. /apis/batch/v1/watch/namespaces/{namespace}/jobs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Job. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
13.2.5. /apis/batch/v1/namespaces/{namespace}/jobs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 작업 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 작업 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 작업 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 작업을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 작업 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
13.2.6. /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 작업 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 종류의 오브젝트를 감시합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
13.2.7. /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 작업 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 작업의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 작업의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 작업의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
14장. 포드 [v1]
- 설명
- Pod는 호스트에서 실행할 수 있는 컨테이너 컬렉션입니다. 이 리소스는 클라이언트에서 생성하며 호스트에 예약됩니다.
- 유형
-
object
14.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| PodSpec은 Pod에 대한 설명입니다. |
|
| PodStatus는 Pod 상태에 대한 정보를 나타냅니다. Pod가 컨트롤 플레인에 연결할 수 없는 경우 상태가 시스템의 실제 상태를 추적할 수 있습니다. |
14.1.1. .spec
- 설명
- PodSpec은 Pod에 대한 설명입니다.
- 유형
-
object
- 필수 항목
-
컨테이너
-
속성 | 유형 | 설명 |
---|---|---|
|
| 시스템이 적극적으로 실패했음을 표시하고 연결된 컨테이너를 종료하기 전에 Pod가 StartTime을 기준으로 노드에서 활성화되는 시간(초)입니다. 값은 양의 정수여야 합니다. |
|
| 유사성은 선호도 스케줄링 규칙 그룹입니다. |
|
| AutomountServiceAccountToken은 서비스 계정 토큰을 자동으로 마운트해야 하는지 여부를 나타냅니다. |
|
| Pod에 속하는 컨테이너 목록입니다. 컨테이너는 현재 추가 또는 제거할 수 없습니다. Pod에는 하나 이상의 컨테이너가 있어야 합니다. CamelCase로 |
|
| Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다. |
|
| PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다. |
|
| Pod의 DNS 정책을 설정합니다. 기본값은 "ClusterFirst"입니다. 유효한 값은 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' 또는 'None'입니다. DNSConfig에 제공된 DNS 매개변수는 DNSPolicy와 선택한 정책과 병합됩니다. hostNetwork와 함께 DNS 옵션을 설정하려면 'ClusterFirstWithHostNet'에 DNS 정책을 명시적으로 지정해야 합니다.
가능한 enum 값: - |
|
| EnableServiceLinks는 서비스에 대한 정보를 Docker 링크의 구문과 일치하는 Pod의 환경 변수에 삽입해야 하는지 여부를 나타냅니다. 선택 사항: true로 설정됩니다. |
|
| 이 Pod에서 실행되는 임시 컨테이너 목록입니다. 임시 컨테이너는 기존 Pod에서 실행하여 디버깅과 같은 사용자 시작 작업을 수행할 수 있습니다. 이 목록은 Pod를 생성할 때 지정할 수 없으며 Pod 사양을 업데이트하여 수정할 수 없습니다. 기존 포드에 임시 컨테이너를 추가하려면 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. |
|
| EphemeralContainer는 디버깅과 같은 사용자 시작 활동을 위해 기존 Pod에 추가할 수 있는 임시 컨테이너입니다. 임시 컨테이너에는 리소스 또는 스케줄링 보장이 없으며 Pod가 종료되거나 Pod를 다시 시작할 때 재시작되지 않습니다. 임시 컨테이너에서 Pod가 리소스 할당을 초과하는 경우 kubelet에서 Pod를 제거할 수 있습니다. 임시 컨테이너를 추가하려면 기존 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. 임시 컨테이너는 제거하거나 다시 시작할 수 없습니다. |
|
| hostAliases는 지정된 경우 Pod의 호스트 파일에 삽입될 호스트 및 IP의 선택적 목록입니다. 이는 non-hostNetwork Pod에만 유효합니다. |
|
| HostAlias는 Pod의 호스트 파일에 항목으로 삽입될 IP와 호스트 이름 간의 매핑을 보유합니다. |
|
| 호스트의 ipc 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다. |
|
| 이 Pod에 대해 요청된 호스트 네트워킹입니다. 호스트의 네트워크 네임스페이스를 사용합니다. 이 옵션을 설정하는 경우 사용할 포트를 지정해야 합니다. 기본값은 false입니다. |
|
| 호스트의 pid 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다. |
|
| 호스트의 사용자 네임스페이스를 사용합니다. 선택 사항: 기본값은 true입니다. true로 설정하면 Pod에 CAP_SYS_MODULE을 사용하여 커널 모듈을 로드하는 등 호스트 사용자 네임스페이스만 사용할 수 있는 기능이 필요한 경우에 유용합니다. false로 설정하면 Pod에 대한 새 사용자가 생성됩니다. false를 설정하면 사용자가 실제로 호스트에 대한 root 권한이 없어도 컨테이너 중단 취약점을 완화하는 데 유용합니다. 이 필드는 알파 수준이며 UserNamespacesSupport 기능을 활성화하는 서버에서만 적용됩니다. |
|
| Pod의 호스트 이름을 지정하지 않으면 Pod의 호스트 이름이 시스템 정의 값으로 설정됩니다. |
|
| imagePullSecrets는 이 PodSpec에서 사용하는 이미지를 가져오는 데 사용할 동일한 네임스페이스의 시크릿에 대한 선택적 참조 목록입니다. 지정된 경우 이러한 시크릿은 사용할 수 있도록 개별 풀러 구현으로 전달됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| Pod에 속하는 초기화 컨테이너 목록입니다. Init 컨테이너는 컨테이너가 시작되기 전에 실행됩니다. init 컨테이너가 실패하면 Pod가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너에서 고유해야 합니다. Init 컨테이너에는 Lifecycle 작업, 준비 상태 프로브, 활성 상태 프로브 또는 시작 프로브가 없을 수 있습니다. init 컨테이너의 resourceRequirements는 각 리소스 유형에 대해 가장 높은 요청/제한을 찾은 다음 해당 값의 최대값 또는 일반 컨테이너의 합계를 사용하여 스케줄링 중에 고려됩니다. 제한은 init 컨테이너에 유사한 방식으로 적용됩니다. init 컨테이너는 현재 추가 또는 제거할 수 없습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
|
| Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다. |
|
| nodename은 이 Pod를 특정 노드에 예약하기 위한 요청입니다. 비어 있지 않은 경우 스케줄러는 리소스 요구 사항에 부합한다고 가정하면 해당 노드에 이 Pod를 간단히 예약합니다. |
|
| nodeSelector는 Pod가 노드에 적합하도록 true여야 하는 선택기입니다. 해당 노드에 예약하려면 Pod의 노드 레이블과 일치해야 하는 선택기입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/assign-pod-node/ |
|
| PodOS는 Pod의 OS 매개변수를 정의합니다. |
| 오버헤드는 지정된 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는 우선순위가 낮은 Pod를 선점하는 정책입니다. Never, PreemptLowerPriority 중 하나입니다. 설정되지 않은 경우 기본값은 PreemptLowerPriority입니다. |
|
| 우선순위 값입니다. 다양한 시스템 구성 요소는 이 필드를 사용하여 Pod의 우선 순위를 찾습니다. Priority Admission Controller가 활성화되면 사용자가 이 필드를 설정할 수 없습니다. 승인 컨트롤러는 PriorityClassName에서 이 필드를 채웁니다. 값이 클수록 우선순위가 높습니다. |
|
| 지정하면 Pod의 우선 순위를 나타냅니다. "system-node-critical" 및 "system-cluster-critical"은 두 가지 특수 키워드로, 전자의 우선 순위가 가장 높은 우선 순위임을 나타냅니다. 다른 이름은 해당 이름으로 PriorityClass 오브젝트를 생성하여 정의해야 합니다. 지정하지 않으면 Pod 우선순위가 기본값 또는 기본값이 없는 경우 0입니다. |
|
| 지정하면 Pod 준비 상태에 대한 모든 준비 상태 게이트가 평가됩니다. 모든 컨테이너가 준비되고 준비 게이트에 지정된 모든 조건이 "True" 추가 정보와 같은 상태가 있는 경우 Pod가 준비됩니다. https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates |
|
| PodReadinessGate에는 Pod 상태에 대한 참조가 포함되어 있습니다. |
|
| Pod 내의 모든 컨테이너에 대한 재시작 정책입니다. Always, OnFailure, Never 중 하나입니다. 기본값은 Always입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
가능한 열거 값: - |
|
| runtimeClassName은 이 Pod를 실행하는 데 사용해야 하는 node.k8s.io 그룹의 RuntimeClass 오브젝트를 나타냅니다. RuntimeClass 리소스가 이름이 지정된 클래스와 일치하지 않으면 Pod가 실행되지 않습니다. 설정되지 않았거나 비어 있으면 기본 런타임 처리기를 사용하는 빈 정의가 있는 암시적 클래스인 "legacy" RuntimeClass가 사용됩니다. 자세한 내용은 https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class |
|
| 지정된 경우 지정된 스케줄러에 의해 Pod가 디스패치됩니다. 지정하지 않으면 Pod가 기본 스케줄러에서 디스패치됩니다. |
|
| PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다. |
|
| 더 이상 사용되지 않는ServiceAccount는 ServiceAccountName의 더 이상 사용되지 않는 별칭입니다. deprecated: 대신 serviceAccountName을 사용합니다. |
|
| serviceAccountName은 이 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/ |
|
| true인 경우 Pod의 호스트 이름이 리프 이름(기본값)이 아닌 Pod의 FQDN으로 구성됩니다. Linux 컨테이너에서 커널의 hostname 필드에 FQDN을 설정하는 것을 의미합니다( struct utsname의 nodename 필드). Windows 컨테이너에서 레지스트리 키 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters의 레지스트리 값을 FQDN으로 설정하는 것을 의미합니다. Pod에 FQDN이 없는 경우 적용되지 않습니다. 기본값은 false입니다. |
|
| Pod의 모든 컨테이너 간에 단일 프로세스 네임스페이스를 공유합니다. 컨테이너를 설정하면 동일한 포드에 있는 다른 컨테이너의 프로세스를 보고 신호할 수 있으며 각 컨테이너의 첫 번째 프로세스에 PID 1이 할당되지 않습니다. HostPID 및 ShareProcessNamespace는 둘 다 설정할 수 없습니다. 선택 사항: 기본값은 false입니다. |
|
| 지정된 경우 정규화된 Pod 호스트 이름은 "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>"입니다. 지정하지 않으면 Pod에 도메인 이름이 전혀 없습니다. |
|
| Pod가 정상적으로 종료되어야 하는 시간(초)입니다. 삭제 요청으로 줄어들 수 있습니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 이 값이 nil이면 기본 유예 기간이 대신 사용됩니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 기본값은 30초입니다. |
|
| 지정된 경우 Pod의 허용 오차입니다. |
|
| 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다. |
|
| TopologySpreadConstraints는 Pod 그룹이 토폴로지 도메인에 분산되는 방법을 설명합니다. 스케줄러는 제약 조건에 따라 비활성화되는 방식으로 Pod를 예약합니다. 모든 topologySpreadConstraints는 ANDed입니다. |
|
| TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다. |
|
| Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes |
|
| volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다. |
14.1.2. .spec.affinity
- 설명
- 유사성은 선호도 스케줄링 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다. |
|
| Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다. |
|
| Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다. |
14.1.3. .spec.affinity.nodeAffinity
- 설명
- 노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다. |
|
| 권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다. |
|
| 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다. |
|
| 1-100 범위의 해당 nodeSelectorTerm과 일치하는 가중치입니다. |
14.1.6. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference
- 설명
- null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 노드의 필드별 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
14.1.7. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions
- 설명
- 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
- 유형
-
array
14.1.8. .spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference.matchExpressions[]
- 설명
- 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
14.1.11. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 설명
- 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
- 유형
-
object
- 필수 항목
-
nodeSelectorTerms
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 노드의 필드별 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
14.1.14. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions
- 설명
- 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
- 유형
-
array
14.1.15. .spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution.nodeSelectorTerms[].matchExpressions[]
- 설명
- 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
14.1.18. .spec.affinity.podAffinity
- 설명
- Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다. |
|
| 일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다. |
|
| 이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다. |
|
| 1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다. |
14.1.21. .spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 설명
- Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
- 유형
-
object
- 필수 항목
-
topologyKey
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 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
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다. |
14.1.24. .spec.affinity.podAntiAffinity
- 설명
- Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다. |
|
| 일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다. |
|
| 이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다. |
|
| 1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다. |
14.1.27. .spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 설명
- Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
- 유형
-
object
- 필수 항목
-
topologyKey
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 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
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 진입점에 대한 인수입니다. 컨테이너 이미지의 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 |
|
| 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 |
|
| 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로 |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로 |
|
| EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다. |
|
| 컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다. |
|
| 이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images
가능한 열거 값: - |
|
| 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로 |
|
| 컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로 |
|
| containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
|
| securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| 이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다. |
|
| 컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다. |
|
| 선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로 |
|
| 종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로
가능한 enum 값: - |
|
| 이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다. |
|
| volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다. |
|
| volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다. |
|
| 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로 |
|
| volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다. |
|
| 컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로 |
14.1.32. .spec.containers[].env
- 설명
- 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
- 유형
-
array
14.1.33. .spec.containers[].env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| EnvVarSource는 EnvVar 값의 소스를 나타냅니다. |
14.1.34. .spec.containers[].env[].valueFrom
- 설명
- EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap에서 키를 선택합니다. |
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
|
| SecretKeySelector는 시크릿의 키를 선택합니다. |
14.1.35. .spec.containers[].env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap에서 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
14.1.36. .spec.containers[].env[].valueFrom.fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
14.1.37. .spec.containers[].env[].valueFrom.resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
14.1.38. .spec.containers[].env[].valueFrom.secretKeyRef
- 설명
- SecretKeySelector는 시크릿의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
14.1.39. .spec.containers[].envFrom
- 설명
- 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
- 유형
-
array
14.1.40. .spec.containers[].envFrom[]
- 설명
- EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다. 대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
|
| ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다. |
|
| SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다. 대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
14.1.41. .spec.containers[].envFrom[].configMapRef
- 설명
ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.
대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap을 정의해야 하는지 여부를 지정 |
14.1.42. .spec.containers[].envFrom[].secretRef
- 설명
SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.
대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 보안을 정의해야 하는지 여부를 지정합니다. |
14.1.43. .spec.containers[].lifecycle
- 설명
- 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
14.1.44. .spec.containers[].lifecycle.postStart
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
14.1.45. .spec.containers[].lifecycle.postStart.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.46. .spec.containers[].lifecycle.postStart.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.49. .spec.containers[].lifecycle.postStart.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.50. .spec.containers[].lifecycle.preStop
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
14.1.51. .spec.containers[].lifecycle.preStop.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.52. .spec.containers[].lifecycle.preStop.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.55. .spec.containers[].lifecycle.preStop.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.56. .spec.containers[].livenessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.57. .spec.containers[].livenessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.58. .spec.containers[].livenessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.60. .spec.containers[].livenessProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.61. .spec.containers[].livenessProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.62. .spec.containers[].livenessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다. |
|
| 외부 포트를 바인딩할 호스트 IP는 무엇입니까. |
|
| 호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다. |
|
| 지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다. |
|
| 포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.
가능한 열거 값: - |
14.1.65. .spec.containers[].readinessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.66. .spec.containers[].readinessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.67. .spec.containers[].readinessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.69. .spec.containers[].readinessProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.70. .spec.containers[].readinessProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.71. .spec.containers[].readinessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.72. .spec.containers[].resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
14.1.73. .spec.containers[].securityContext
- 설명
- securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다. |
|
| 권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
14.1.74. .spec.containers[].securityContext.capabilities
- 설명
- 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 기능 |
|
| 제거된 기능 |
14.1.75. .spec.containers[].securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
14.1.76. .spec.containers[].securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.
가능한 열거 값: - |
14.1.77. .spec.containers[].securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
14.1.78. .spec.containers[].startupProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.79. .spec.containers[].startupProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.80. .spec.containers[].startupProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.82. .spec.containers[].startupProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.83. .spec.containers[].startupProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.84. .spec.containers[].startupProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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는 장치를 매핑할 컨테이너 내부의 경로입니다. |
|
| name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다 |
14.1.87. .spec.containers[].volumeMounts
- 설명
- 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로
- 유형
-
array
14.1.88. .spec.containers[].volumeMounts[]
- 설명
- volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
mountPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다. |
|
| mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다. |
|
| 이는 볼륨 이름과 일치해야 합니다. |
|
| true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다. |
14.1.89. .spec.dnsConfig
- 설명
- PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DNS 이름 서버 IP 주소 목록입니다. DNSPolicy에서 생성된 기본 이름 서버에 추가됩니다. 중복된 네임서버가 제거됩니다. |
|
| DNS 확인자 옵션 목록입니다. 이는 DNSPolicy에서 생성된 기본 옵션과 병합됩니다. 중복된 항목이 제거됩니다. 옵션에 제공된 해결 옵션은 기본 DNSPolicy에 표시되는 옵션을 재정의합니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. |
|
|
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 진입점에 대한 인수입니다. 이미지의 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 |
|
| 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 |
|
| 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로 |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로 |
|
| EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다. |
|
| 컨테이너 이미지 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images |
|
| 이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images
가능한 열거 값: - |
|
| 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| DNS_LABEL로 지정된 임시 컨테이너의 이름입니다. 이 이름은 모든 컨테이너, init 컨테이너 및 임시 컨테이너에서 고유해야 합니다. |
|
| 임시 컨테이너에는 포트가 허용되지 않습니다. |
|
| containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
|
| securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| 이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다. |
|
| 컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다. |
|
| 설정된 경우 PodSpec의 컨테이너 이름이 이 임시 컨테이너를 대상으로 합니다. 임시 컨테이너는 이 컨테이너의 네임스페이스(IPC, PID 등)에서 실행됩니다. 설정되지 않은 경우 임시 컨테이너는 Pod 사양에 구성된 네임스페이스를 사용합니다. 컨테이너 런타임은 이 기능에 대한 지원을 구현해야 합니다. 런타임에서 네임스페이스 대상 지정을 지원하지 않으면 이 필드를 설정한 결과는 정의되지 않습니다. |
|
| 선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로 |
|
| 종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로
가능한 enum 값: - |
|
| 이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다. |
|
| volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다. |
|
| volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다. |
|
| 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로 |
|
| volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다. |
|
| 컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로 |
14.1.94. .spec.ephemeralContainers[].env
- 설명
- 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
- 유형
-
array
14.1.95. .spec.ephemeralContainers[].env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| EnvVarSource는 EnvVar 값의 소스를 나타냅니다. |
14.1.96. .spec.ephemeralContainers[].env[].valueFrom
- 설명
- EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap에서 키를 선택합니다. |
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
|
| SecretKeySelector는 시크릿의 키를 선택합니다. |
14.1.97. .spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap에서 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
14.1.98. .spec.ephemeralContainers[].env[].valueFrom.fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
14.1.99. .spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
14.1.100. .spec.ephemeralContainers[].env[].valueFrom.secretKeyRef
- 설명
- SecretKeySelector는 시크릿의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
14.1.101. .spec.ephemeralContainers[].envFrom
- 설명
- 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
- 유형
-
array
14.1.102. .spec.ephemeralContainers[].envFrom[]
- 설명
- EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다. 대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
|
| ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다. |
|
| SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다. 대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
14.1.103. .spec.ephemeralContainers[].envFrom[].configMapRef
- 설명
ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.
대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap을 정의해야 하는지 여부를 지정 |
14.1.104. .spec.ephemeralContainers[].envFrom[].secretRef
- 설명
SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.
대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 보안을 정의해야 하는지 여부를 지정합니다. |
14.1.105. .spec.ephemeralContainers[].lifecycle
- 설명
- 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
14.1.106. .spec.ephemeralContainers[].lifecycle.postStart
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
14.1.107. .spec.ephemeralContainers[].lifecycle.postStart.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.108. .spec.ephemeralContainers[].lifecycle.postStart.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.111. .spec.ephemeralContainers[].lifecycle.postStart.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.112. .spec.ephemeralContainers[].lifecycle.preStop
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
14.1.113. .spec.ephemeralContainers[].lifecycle.preStop.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.114. .spec.ephemeralContainers[].lifecycle.preStop.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.117. .spec.ephemeralContainers[].lifecycle.preStop.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.118. .spec.ephemeralContainers[].livenessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.119. .spec.ephemeralContainers[].livenessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.120. .spec.ephemeralContainers[].livenessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.122. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.123. .spec.ephemeralContainers[].livenessProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.124. .spec.ephemeralContainers[].livenessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.125. .spec.ephemeralContainers[].ports
- 설명
- 임시 컨테이너에는 포트가 허용되지 않습니다.
- 유형
-
array
14.1.126. .spec.ephemeralContainers[].ports[]
- 설명
- containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다.
- 유형
-
object
- 필수 항목
-
containerPort
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다. |
|
| 외부 포트를 바인딩할 호스트 IP는 무엇입니까. |
|
| 호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다. |
|
| 지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다. |
|
| 포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.
가능한 열거 값: - |
14.1.127. .spec.ephemeralContainers[].readinessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.128. .spec.ephemeralContainers[].readinessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.129. .spec.ephemeralContainers[].readinessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.131. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.132. .spec.ephemeralContainers[].readinessProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.133. .spec.ephemeralContainers[].readinessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.134. .spec.ephemeralContainers[].resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
14.1.135. .spec.ephemeralContainers[].securityContext
- 설명
- securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다. |
|
| 권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
14.1.136. .spec.ephemeralContainers[].securityContext.capabilities
- 설명
- 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 기능 |
|
| 제거된 기능 |
14.1.137. .spec.ephemeralContainers[].securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
14.1.138. .spec.ephemeralContainers[].securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.
가능한 열거 값: - |
14.1.139. .spec.ephemeralContainers[].securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
14.1.140. .spec.ephemeralContainers[].startupProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.141. .spec.ephemeralContainers[].startupProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.142. .spec.ephemeralContainers[].startupProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.144. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.145. .spec.ephemeralContainers[].startupProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.146. .spec.ephemeralContainers[].startupProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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는 장치를 매핑할 컨테이너 내부의 경로입니다. |
|
| name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다 |
14.1.149. .spec.ephemeralContainers[].volumeMounts
- 설명
- 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로
- 유형
-
array
14.1.150. .spec.ephemeralContainers[].volumeMounts[]
- 설명
- volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
mountPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다. |
|
| mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다. |
|
| 이는 볼륨 이름과 일치해야 합니다. |
|
| true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. 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 주소입니다. |
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
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 진입점에 대한 인수입니다. 컨테이너 이미지의 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 |
|
| 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 |
|
| 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로 |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로 |
|
| EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다. |
|
| 컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다. |
|
| 이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images
가능한 열거 값: - |
|
| 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로 |
|
| 컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로 |
|
| containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
|
| securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| 이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다. |
|
| 컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다. |
|
| 선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로 |
|
| 종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로
가능한 enum 값: - |
|
| 이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다. |
|
| volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다. |
|
| volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다. |
|
| 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로 |
|
| volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다. |
|
| 컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로 |
14.1.157. .spec.initContainers[].env
- 설명
- 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
- 유형
-
array
14.1.158. .spec.initContainers[].env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| EnvVarSource는 EnvVar 값의 소스를 나타냅니다. |
14.1.159. .spec.initContainers[].env[].valueFrom
- 설명
- EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap에서 키를 선택합니다. |
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
|
| SecretKeySelector는 시크릿의 키를 선택합니다. |
14.1.160. .spec.initContainers[].env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap에서 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
14.1.161. .spec.initContainers[].env[].valueFrom.fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
14.1.162. .spec.initContainers[].env[].valueFrom.resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
14.1.163. .spec.initContainers[].env[].valueFrom.secretKeyRef
- 설명
- SecretKeySelector는 시크릿의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
14.1.164. .spec.initContainers[].envFrom
- 설명
- 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
- 유형
-
array
14.1.165. .spec.initContainers[].envFrom[]
- 설명
- EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다. 대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
|
| ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다. |
|
| SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다. 대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
14.1.166. .spec.initContainers[].envFrom[].configMapRef
- 설명
ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.
대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap을 정의해야 하는지 여부를 지정 |
14.1.167. .spec.initContainers[].envFrom[].secretRef
- 설명
SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.
대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 보안을 정의해야 하는지 여부를 지정합니다. |
14.1.168. .spec.initContainers[].lifecycle
- 설명
- 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
14.1.169. .spec.initContainers[].lifecycle.postStart
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
14.1.170. .spec.initContainers[].lifecycle.postStart.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.171. .spec.initContainers[].lifecycle.postStart.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.174. .spec.initContainers[].lifecycle.postStart.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.175. .spec.initContainers[].lifecycle.preStop
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
14.1.176. .spec.initContainers[].lifecycle.preStop.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.177. .spec.initContainers[].lifecycle.preStop.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.180. .spec.initContainers[].lifecycle.preStop.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.181. .spec.initContainers[].livenessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.182. .spec.initContainers[].livenessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.183. .spec.initContainers[].livenessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.185. .spec.initContainers[].livenessProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.186. .spec.initContainers[].livenessProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.187. .spec.initContainers[].livenessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다. |
|
| 외부 포트를 바인딩할 호스트 IP는 무엇입니까. |
|
| 호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다. |
|
| 지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다. |
|
| 포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.
가능한 열거 값: - |
14.1.190. .spec.initContainers[].readinessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.191. .spec.initContainers[].readinessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.192. .spec.initContainers[].readinessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.194. .spec.initContainers[].readinessProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.195. .spec.initContainers[].readinessProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.196. .spec.initContainers[].readinessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
14.1.197. .spec.initContainers[].resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
14.1.198. .spec.initContainers[].securityContext
- 설명
- securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowPrivilegeEscalation은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다. |
|
| 권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
14.1.199. .spec.initContainers[].securityContext.capabilities
- 설명
- 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 기능 |
|
| 제거된 기능 |
14.1.200. .spec.initContainers[].securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
14.1.201. .spec.initContainers[].securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.
가능한 열거 값: - |
14.1.202. .spec.initContainers[].securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
14.1.203. .spec.initContainers[].startupProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. 설정되지 않은 경우 최소 값은 1. spec.terminationGracePeriodSeconds입니다. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
14.1.204. .spec.initContainers[].startupProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
14.1.205. .spec.initContainers[].startupProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
14.1.207. .spec.initContainers[].startupProbe.httpGet.httpHeaders
- 설명
- 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다.
- 유형
-
array
14.1.208. .spec.initContainers[].startupProbe.httpGet.httpHeaders[]
- 설명
- HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
14.1.209. .spec.initContainers[].startupProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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는 장치를 매핑할 컨테이너 내부의 경로입니다. |
|
| name은 Pod의 persistentVolumeClaim 이름과 일치해야 합니다 |
14.1.212. .spec.initContainers[].volumeMounts
- 설명
- 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로
- 유형
-
array
14.1.213. .spec.initContainers[].volumeMounts[]
- 설명
- volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다.
- 유형
-
object
- 필수 항목
-
name
-
mountPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다. |
|
| mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다. |
|
| 이는 볼륨 이름과 일치해야 합니다. |
|
| true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다. |
14.1.214. .spec.os
- 설명
- PodOS는 Pod의 OS 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 운영 체제의 이름입니다.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은 일치하는 유형이 있는 Pod의 조건 목록의 조건을 나타냅니다. |
14.1.217. .spec.securityContext
- 설명
- PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 모든 컨테이너에 적용되는 특수 추가 그룹입니다. 일부 볼륨 유형을 사용하면 Kubelet에서 해당 볼륨의 소유권을 Pod에서 소유하도록 변경할 수 있습니다. 1. GID를 소유하는 것은 FSGroup 2가 됩니다. setgid 비트가 설정되어 있습니다(볼륨에서 생성된 새 파일은 FSGroup에 의해 소유됨) 3. 권한 비트는 rw-rw----를 사용하여 또는d입니다. 설정되지 않은 경우 Kubelet은 볼륨의 소유권 및 권한을 수정하지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| fsGroupChangePolicy는 Pod 내부에서 노출되기 전에 볼륨의 소유권 및 권한 변경 동작을 정의합니다. 이 필드는 fsGroup 기반 소유권 및 권한을 지원하는 볼륨 유형에만 적용됩니다. secret, configmaps 및 emptydir과 같은 임시 볼륨 유형에는 영향을 미치지 않습니다. 유효한 값은 "OnRootMismatch" 및 "Always"입니다. 지정하지 않으면 "항상"이 사용됩니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| 컨테이너의 기본 GID 외에도 각 컨테이너에서 첫 번째 프로세스에 적용되는 그룹 목록입니다. 지정되지 않은 경우 컨테이너에 그룹이 추가되지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| sysctl에는 Pod에 사용되는 네임스페이스가 지정된 sysctl 목록이 있습니다. 지원되지 않는 sysctl이 있는 Pod(컨테이너 런타임별)가 시작되지 않을 수 있습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| sysctl은 설정할 커널 매개변수를 정의합니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
14.1.218. .spec.securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
14.1.219. .spec.securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 설정할 속성의 이름 |
|
| 설정할 속성의 값 |
14.1.222. .spec.securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
14.1.223. .spec.tolerations
- 설명
- 지정된 경우 Pod의 허용 오차입니다.
- 유형
-
array
14.1.224. .spec.tolerations[]
- 설명
- 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.
가능한 enum 값: - |
|
| 키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다. |
|
| Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.
가능한 열거 값: - |
|
| tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다. |
|
| 값은 허용 오차와 일치하는 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는 일치하는 포드를 찾는 데 사용됩니다. 이 라벨 선택기와 일치하는 Pod는 해당 토폴로지 도메인의 Pod 수를 확인하기 위해 계산됩니다. | |
|
| MatchLabelKeys는 분배를 계산할 Pod를 선택하는 Pod 레이블 키 집합입니다. 키는 들어오는 Pod 라벨에서 값을 조회하는 데 사용되며, 해당 키-값 레이블은 labelSelector와 함께 사용되어 들어오는 포드에 대해 분산이 계산될 기존 포드 그룹을 선택합니다. 들어오는 Pod 라벨에 없는 키는 무시됩니다. null 또는 빈 목록은 labelSelector와만 일치함을 의미합니다. |
|
|
MaxSkew는 Pod를 균등하게 배포할 수 있는 정도를 설명합니다. |
|
| 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는 Pod 토폴로지 분배 skew를 계산할 때 Pod의 nodeAffinity/nodeSelector를 처리하는 방법을 나타냅니다. 옵션은: - Cryostat: nodeAffinity/nodeSelector와 일치하는 노드만 계산에 포함됩니다. - Ignore: nodeAffinity/nodeSelector는 무시됩니다. 모든 노드는 계산에 포함됩니다. 이 값이 nil인 경우 동작은 policy와 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다. |
|
| NodeTaintsPolicy는 Pod 토폴로지 분배 스큐를 계산할 때 노드 테인트를 처리하는 방법을 나타냅니다. 옵션은 다음과 같습니다: 테인트가 없는 노드와 함께 들어오는 Pod에 톨러레이션이 포함된 테인트 노드가 포함됩니다. - Ignore: 노드 테인트는 무시됩니다. 모든 노드가 포함됩니다. 이 값이 nil인 경우 동작은 Ignore 정책과 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다. |
|
| TopologyKey는 노드 라벨의 키입니다. 이 키와 동일한 값이 있는 라벨이 있는 노드는 동일한 토폴로지에 있는 것으로 간주됩니다. 각 <key, value>를 "bucket"으로 간주하고 각 버킷에 균형 있는 Pod 수를 배치하려고 합니다. 도메인을 토폴로지의 특정 인스턴스로 정의합니다. 또한 적격 도메인을 nodeAffinityPolicy 및 nodeTaintsPolicy의 요구 사항을 충족하는 도메인으로 정의합니다. 예를 들어 TopologyKey가 "kubernetes.io/hostname"인 경우 각 노드는 해당 토폴로지의 도메인입니다. 그리고 TopologyKey가 "topology.kubernetes.io/zone"인 경우 각 영역은 해당 토폴로지의 도메인입니다. 필수 필드입니다. |
|
| 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 값: - |
14.1.227. .spec.volumes
- 설명
- Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes
- 유형
-
array
14.1.228. .spec.volumes[]
- 설명
- volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| AWS의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
|
| AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
|
| Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| ConfigMap을 볼륨에 조정합니다. 대상 ConfigMap의 Data 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. ConfigMap 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| 외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다. |
|
| DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다. |
|
| Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| 일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다. |
|
| 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다. |
|
| Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Google Compute Engine의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| git 리포지토리의 콘텐츠로 채워지는 볼륨을 나타냅니다. Git 리포지토리 볼륨은 소유권 관리를 지원하지 않습니다. Git 리포지터리 볼륨은 SELinux 레이블 재지정을 지원합니다. DEPRECATED: GitRepo는 더 이상 사용되지 않습니다. Git 리포지토리를 사용하여 컨테이너를 프로비저닝하려면 git을 사용하여 리포지터리를 복제하는 EmptyDir을 EmptyContainer에 마운트한 다음 EmptyDir을 Pod의 컨테이너에 마운트합니다. |
|
| Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| 볼륨의 이름입니다. DNS_LABEL이어야 하며 Pod 내에서 고유해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다. |
|
| Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다. |
|
| PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다. |
|
| 예상 볼륨 소스를 나타냅니다. |
|
| Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다. |
|
| 시크릿을 볼륨에 조정합니다. 대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| StorageOS 영구 볼륨 리소스를 나타냅니다. |
|
| vSphere 볼륨 리소스를 나타냅니다. |
14.1.229. .spec.volumes[].awsElasticBlockStore
- 설명
AWS의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). |
|
| readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| 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는 Host Caching 모드입니다: None, Read Only, Read Write. |
|
| diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다. |
|
| diskURI는 Blob 스토리지의 데이터 디스크 URI입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| 종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다. |
|
| Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
14.1.231. .spec.volumes[].azureFile
- 설명
- AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
- 유형
-
object
- 필수 항목
-
secretName
-
shareName
-
속성 | 유형 | 설명 |
---|---|---|
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다. |
|
| 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는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
14.1.233. .spec.volumes[].cephfs.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md |
14.1.235. .spec.volumes[].cinder.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 선택 사항: ConfigMap 또는 해당 키를 정의해야 하는지 여부 지정 |
14.1.237. .spec.volumes[].configMap.items
- 설명
- 지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다.
- 유형
-
array
14.1.238. .spec.volumes[].configMap.items[]
- 설명
- 문자열 키를 볼륨 내 경로에 매핑합니다.
- 유형
-
object
- 필수 항목
-
key
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
14.1.239. .spec.volumes[].csi
- 설명
- 외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| driver는 이 볼륨을 처리하는 CSI 드라이버의 이름입니다. 클러스터에 등록된 대로 올바른 이름은 관리자에게 문의하십시오. |
|
| 마운트할 fstype. 예. "ext4", "xfs", "ntfs". 제공되지 않는 경우 빈 값은 적용할 기본 파일 시스템을 결정하는 연결된 CSI 드라이버에 전달됩니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| readonly는 볼륨에 대한 읽기 전용 구성을 지정합니다. 기본값은 false(읽기/쓰기)입니다. |
|
| volumeAttributes는 CSI 드라이버로 전달되는 드라이버별 속성을 저장합니다. 지원되는 값은 드라이버 설명서를 참조하십시오. |
14.1.240. .spec.volumes[].csi.nodePublishSecretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.241. .spec.volumes[].downwardAPI
- 설명
- DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 기본적으로 생성된 파일에서 사용할 모드 비트입니다. 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 선택 사항: 모드 비트여야 합니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| items는 Downward API 볼륨 파일 목록입니다. |
|
| DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다. |
14.1.242. .spec.volumes[].downwardAPI.items
- 설명
- items는 Downward API 볼륨 파일 목록입니다.
- 유형
-
array
14.1.243. .spec.volumes[].downwardAPI.items[]
- 설명
- DownwardAPIVolumeFile은 Pod 필드가 포함된 파일을 생성하는 정보를 나타냅니다.
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| 선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
14.1.244. .spec.volumes[].downwardAPI.items[].fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
14.1.245. .spec.volumes[].downwardAPI.items[].resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
14.1.246. .spec.volumes[].emptyDir
- 설명
- Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| medium는 이 디렉터리를 백업해야 하는 스토리지 미디어 유형을 나타냅니다. 기본값은 ""이며 이는 노드의 기본 미디어를 사용하는 것을 의미합니다. 빈 문자열(기본값) 또는 메모리여야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
| sizeLimit은 이 EmptyDir 볼륨에 필요한 총 로컬 스토리지 양입니다. 크기 제한은 메모리 미디어에도 적용할 수 있습니다. 메모리 매체 EmptyDir의 최대 사용량은 여기에 지정된 SizeLimit와 Pod의 모든 컨테이너의 메모리 제한 합계 사이의 최소 값입니다. 기본값은 nil이며 이는 제한이 정의되지 않음을 의미합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/volumes#emptydir |
14.1.247. .spec.volumes[].ephemeral
- 설명
- 일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다. |
14.1.248. .spec.volumes[].ephemeral.volumeClaimTemplate
- 설명
- PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다.
- 유형
-
object
- 필수 항목
-
spec
-
속성 | 유형 | 설명 |
---|---|---|
| 해당 라벨을 생성할 때 PVC에 복사할 레이블 및 주석이 포함될 수 있습니다. 다른 필드는 허용되지 않으며 검증 중에 거부됩니다. | |
|
| PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다. |
14.1.249. .spec.volumes[].ephemeral.volumeClaimTemplate.spec
- 설명
- PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessModes에는 볼륨에 필요한 액세스 모드가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
| TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
| selector는 바인딩에 대해 고려할 볼륨에 대한 레이블 쿼리입니다. | |
|
| storageClassName은 클레임에 필요한 StorageClass의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeMode는 클레임에 필요한 볼륨 유형을 정의합니다. claim 사양에 포함되지 않은 경우 Filesystem의 값이 포함됩니다. |
|
| volumeName은 이 클레임을 지원하는 PersistentVolume에 대한 바인딩 참조입니다. |
14.1.250. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource
- 설명
- TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조되는 리소스의 이름입니다. |
14.1.251. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef
- 설명
- TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조되는 리소스의 이름입니다. |
14.1.252. .spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
14.1.253. .spec.volumes[].fc
- 설명
- 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| LUN은 선택 사항입니다. FC 대상 lun 번호 |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN) |
|
| WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다. |
14.1.254. .spec.volumes[].flexVolume
- 설명
- FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| driver는 이 볼륨에 사용할 드라이버의 이름입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다. |
|
| 옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
14.1.255. .spec.volumes[].flexVolume.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.256. .spec.volumes[].flocker
- 설명
- Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다. |
|
| datasetUUID는 데이터 세트의 UUID입니다. Flocker 데이터 세트의 고유 식별자입니다. |
14.1.257. .spec.volumes[].gcePersistentDisk
- 설명
Google Compute Engine의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
pdName
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| pdName은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| 여기에서 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
- 필수 항목
-
리포지토리
-
속성 | 유형 | 설명 |
---|---|---|
|
| 디렉터리는 대상 디렉터리 이름입니다. 포함하거나 '..'로 시작하지 않아야 합니다. '.'가 제공되면 볼륨 디렉터리가 git 리포지토리가 됩니다. 지정하지 않으면 볼륨에 지정된 이름이 있는 하위 디렉터리에 git 리포지토리가 포함됩니다. |
|
| 리포지터리는 URL입니다. |
|
| 개정 버전은 지정된 버전의 커밋 해시입니다. |
14.1.259. .spec.volumes[].glusterfs
- 설명
- Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
끝점
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| 여기에서 readonly는 읽기 전용 권한으로 Glusterfs 볼륨을 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
14.1.260. .spec.volumes[].hostPath
- 설명
- Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| 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는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
| initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다. |
|
| IQN은 대상 iSCSI 정규화된 이름입니다. |
|
| iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다. |
|
| LUN은 iSCSI 대상 Lun 번호를 나타냅니다. |
|
| 포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
14.1.262. .spec.volumes[].iscsi.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.263. .spec.volumes[].nfs
- 설명
- Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
server
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 서버는 NFS 서버의 호스트 이름 또는 IP 주소입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
14.1.264. .spec.volumes[].persistentVolumeClaim
- 설명
- PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다.
- 유형
-
object
- 필수 항목
-
claimName
-
속성 | 유형 | 설명 |
---|---|---|
|
| claimName은 이 볼륨을 사용하는 Pod와 동일한 네임스페이스에 있는 PersistentVolumeClaim의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| ReadOnly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본 false. |
14.1.265. .spec.volumes[].photonPersistentDisk
- 설명
- Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
pdID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다. |
14.1.266. .spec.volumes[].portworxVolume
- 설명
- PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. 예. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| volumeID는 Portworx 볼륨을 고유하게 식별합니다. |
14.1.267. .spec.volumes[].projected
- 설명
- 예상 볼륨 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 소스는 볼륨 프로젝션의 목록입니다. |
|
| 다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션 |
14.1.268. .spec.volumes[].projected.sources
- 설명
- 소스는 볼륨 프로젝션의 목록입니다.
- 유형
-
array
14.1.269. .spec.volumes[].projected.sources[]
- 설명
- 다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap을 예상 볼륨에 조정합니다. 대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다. |
|
| 예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다. |
|
| 시크릿을 예상 볼륨에 조정합니다. 대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다. |
|
| ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다. |
14.1.270. .spec.volumes[].projected.sources[].configMap
- 설명
ConfigMap을 예상 볼륨에 조정합니다.
대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 선택 사항: 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
14.1.273. .spec.volumes[].projected.sources[].downwardAPI
- 설명
- 예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| items는 DownwardAPIVolume 파일 목록입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| 선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
14.1.276. .spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
14.1.277. .spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
14.1.278. .spec.volumes[].projected.sources[].secret
- 설명
시크릿을 예상 볼륨에 조정합니다.
대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 선택적 필드는 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
14.1.281. .spec.volumes[].projected.sources[].serviceAccountToken
- 설명
- ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| audience는 토큰의 의도된 대상입니다. 토큰 수신자는 토큰 대상에 지정된 식별자로 자신을 식별해야 하며, 그렇지 않으면 토큰을 거부해야 합니다. 오디언스는 기본적으로 apiserver의 식별자입니다. |
|
| expirationSeconds는 서비스 계정 토큰의 유효 기간입니다. 토큰이 만료되면 kubelet 볼륨 플러그인은 서비스 계정 토큰을 사전에 순환합니다. 토큰이 수명의 80% 이상을 경과했거나 24시간 이상된 경우 kubelet은 토큰을 순환하기 시작합니다.Defaults는 1시간 이상이며 최소 10분이어야 합니다. |
|
| path는 토큰을 프로젝션할 파일의 마운트 지점을 기준으로 하는 경로입니다. |
14.1.282. .spec.volumes[].quobyte
- 설명
- Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
레지스트리
-
volume
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다. |
|
| 여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다. |
|
| registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨) |
|
| 백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다. |
|
| 사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다. |
|
| volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다. |
14.1.283. .spec.volumes[].rbd
- 설명
- Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
모니터
-
image
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
| image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 인증 키는 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은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 사용자는 rados 사용자 이름입니다. 기본값은 admin입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
14.1.284. .spec.volumes[].rbd.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.285. .spec.volumes[].scaleIO
- 설명
- scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.
- 유형
-
object
- 필수 항목
-
gateway
-
system
-
secretRef
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다. |
|
| Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다. |
|
| protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다. |
|
| Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| sslEnabled Flag enable/disable SSL communication with Gateway, default false |
|
| storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다. |
|
| StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다. |
|
| 시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다. |
|
| volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다. |
14.1.286. .spec.volumes[].scaleIO.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.287. .spec.volumes[].secret
- 설명
시크릿을 볼륨에 조정합니다.
대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 선택적 필드는 Secret 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
|
| 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
14.1.290. .spec.volumes[].storageos
- 설명
- StorageOS 영구 볼륨 리소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다. |
|
| volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다. |
14.1.291. .spec.volumes[].storageos.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
14.1.292. .spec.volumes[].vsphereVolume
- 설명
- vSphere 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumePath
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다. |
|
| storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다. |
|
| volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다. |
14.1.293. .status
- 설명
- PodStatus는 Pod 상태에 대한 정보를 나타냅니다. Pod가 컨트롤 플레인에 연결할 수 없는 경우 상태가 시스템의 실제 상태를 추적할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 현재 서비스 상태입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions |
|
| PodCondition에는 이 Pod의 현재 상태에 대한 세부 정보가 포함되어 있습니다. |
|
| 목록에는 매니페스트에 컨테이너당 하나의 항목이 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status |
|
| ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다. |
|
| 이 Pod에서 실행된 임시 컨테이너의 상태입니다. |
|
| ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다. |
|
| 포드가 할당되는 호스트의 IP 주소입니다. 아직 예약되지 않은 경우 비어 있습니다. |
|
| 목록에는 매니페스트에 init 컨테이너당 하나의 항목이 있습니다. 가장 최근 성공한 init 컨테이너는 ready = true이고, 가장 최근에 시작된 컨테이너에는 startTime이 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status |
|
| ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다. |
|
| Pod가 이 상태에 있는 이유에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| nominatedNodeName은 이 Pod가 노드의 다른 Pod를 선점하는 경우에만 설정되지만 선점하는 연애의 종료 기간을 즉시 예약할 수 없습니다. 이 필드는 Pod가 이 노드에 예약되는 것을 보장하지 않습니다. 다른 노드를 더 빨리 사용할 수 있게 되면 스케줄러에서 Pod를 다른 위치에 배치하도록 결정할 수 있습니다. 또한 스케줄러는 선점 후 생성된 우선 순위 Pod에 이 노드의 리소스를 더 높은 우선 순위 Pod에 제공하도록 결정할 수 있습니다. 결과적으로 Pod가 예약될 때 이 필드는 PodSpec.nodeName과 다를 수 있습니다. |
|
| 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 값: - |
|
| Pod에 할당된 IP 주소입니다. 최소한 클러스터 내에서 라우팅할 수 있습니다. 아직 할당되지 않은 경우 비어 있습니다. |
|
| podIPs에는 Pod에 할당된 IP 주소가 있습니다. 이 필드를 지정하면 0번째 항목이 podIP 필드와 일치해야 합니다. Pod는 각 IPv4 및 IPv6에 대해 최대 1개의 값을 할당할 수 있습니다. 이 목록은 IP가 아직 할당되지 않은 경우 비어 있습니다. |
|
| (plural) PodIPs 필드의 항목에 대한 IP 주소 정보입니다. 각 항목에는 다음이 포함됩니다. IP: Pod에 할당된 IP 주소입니다. 최소한 클러스터 내에서 라우팅할 수 있습니다. |
|
| 리소스 요구 사항을 기반으로 Pod에 할당된 QoS(Quality of Service) 분류는 사용 가능한 QOS 클래스의 PodQOSClass 유형을 참조하십시오. https://git.k8s.io/community/contributors/design-proposals/node/resource-qos.md
가능한 enum 값: - |
|
| Pod가 이 상태에 있는 이유에 대한 세부 정보를 나타내는 간략한 CamelCase 메시지입니다. 예를 들면 다음과 같습니다. 'Evicted' |
| 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
-
속성 | 유형 | 설명 |
---|---|---|
| 조건을 마지막으로 확인했을 때입니다. | |
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| 마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환에 대한 고유하고 한단어, CamelCase 이유. |
|
| Status는 조건의 상태입니다. True, False, 알 수 없음 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-conditions |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID입니다. |
|
| 컨테이너가 실행 중인 이미지입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images. |
|
| 컨테이너 이미지의 ImageId. |
|
| ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다. |
|
| DNS_LABEL이어야 합니다. Pod의 각 컨테이너에는 고유한 이름이 있어야 합니다. CamelCase로 |
|
| 컨테이너가 준비 상태 프로브를 통과했는지 여부를 지정합니다. |
|
| 컨테이너가 다시 시작된 횟수입니다. |
|
| 컨테이너가 시작 프로브를 통과했는지 여부를 지정합니다. false로 초기화되고 startupProbe가 성공한 후 true가 됩니다. 컨테이너를 다시 시작하거나 kubelet이 일시적으로 상태가 손실될 때 false로 재설정됩니다. startupProbe가 정의되지 않은 경우 항상 true입니다. |
|
| ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다. |
14.1.298. .status.containerStatuses[].lastState
- 설명
- ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerStateRunning은 컨테이너의 실행 중인 상태입니다. |
|
| ContainerStateTerminated는 컨테이너의 종료 상태입니다. |
|
| ContainerStateWaiting은 컨테이너의 대기 상태입니다. |
14.1.299. .status.containerStatuses[].lastState.running
- 설명
- ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 컨테이너가 마지막으로 시작된 시간(다시) |
14.1.300. .status.containerStatuses[].lastState.terminated
- 설명
- ContainerStateTerminated는 컨테이너의 종료 상태입니다.
- 유형
-
object
- 필수 항목
-
exitCode
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID |
|
| 컨테이너의 마지막 종료 후 종료 상태 |
| 컨테이너가 마지막으로 종료되는 시간 | |
|
| 컨테이너의 마지막 종료에 대한 메시지 |
|
| (brief) 컨테이너의 마지막 종료 이유 |
|
| 컨테이너의 마지막 종료 시 신호 |
| 이전 컨테이너 실행이 시작된 시간 |
14.1.301. .status.containerStatuses[].lastState.waiting
- 설명
- ContainerStateWaiting은 컨테이너의 대기 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다. |
|
| (brief) 컨테이너가 아직 실행되지 않은 이유 |
14.1.302. .status.containerStatuses[].state
- 설명
- ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerStateRunning은 컨테이너의 실행 중인 상태입니다. |
|
| ContainerStateTerminated는 컨테이너의 종료 상태입니다. |
|
| ContainerStateWaiting은 컨테이너의 대기 상태입니다. |
14.1.303. .status.containerStatuses[].state.running
- 설명
- ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 컨테이너가 마지막으로 시작된 시간(다시) |
14.1.304. .status.containerStatuses[].state.terminated
- 설명
- ContainerStateTerminated는 컨테이너의 종료 상태입니다.
- 유형
-
object
- 필수 항목
-
exitCode
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID |
|
| 컨테이너의 마지막 종료 후 종료 상태 |
| 컨테이너가 마지막으로 종료되는 시간 | |
|
| 컨테이너의 마지막 종료에 대한 메시지 |
|
| (brief) 컨테이너의 마지막 종료 이유 |
|
| 컨테이너의 마지막 종료 시 신호 |
| 이전 컨테이너 실행이 시작된 시간 |
14.1.305. .status.containerStatuses[].state.waiting
- 설명
- ContainerStateWaiting은 컨테이너의 대기 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다. |
|
| (brief) 컨테이너가 아직 실행되지 않은 이유 |
14.1.306. .status.ephemeralContainerStatuses
- 설명
- 이 Pod에서 실행된 임시 컨테이너의 상태입니다.
- 유형
-
array
14.1.307. .status.ephemeralContainerStatuses[]
- 설명
- ContainerStatus에는 이 컨테이너의 현재 상태에 대한 세부 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
Ready
-
restartCount
-
image
-
imageID
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID입니다. |
|
| 컨테이너가 실행 중인 이미지입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images. |
|
| 컨테이너 이미지의 ImageId. |
|
| ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다. |
|
| DNS_LABEL이어야 합니다. Pod의 각 컨테이너에는 고유한 이름이 있어야 합니다. CamelCase로 |
|
| 컨테이너가 준비 상태 프로브를 통과했는지 여부를 지정합니다. |
|
| 컨테이너가 다시 시작된 횟수입니다. |
|
| 컨테이너가 시작 프로브를 통과했는지 여부를 지정합니다. false로 초기화되고 startupProbe가 성공한 후 true가 됩니다. 컨테이너를 다시 시작하거나 kubelet이 일시적으로 상태가 손실될 때 false로 재설정됩니다. startupProbe가 정의되지 않은 경우 항상 true입니다. |
|
| ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다. |
14.1.308. .status.ephemeralContainerStatuses[].lastState
- 설명
- ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerStateRunning은 컨테이너의 실행 중인 상태입니다. |
|
| ContainerStateTerminated는 컨테이너의 종료 상태입니다. |
|
| ContainerStateWaiting은 컨테이너의 대기 상태입니다. |
14.1.309. .status.ephemeralContainerStatuses[].lastState.running
- 설명
- ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 컨테이너가 마지막으로 시작된 시간(다시) |
14.1.310. .status.ephemeralContainerStatuses[].lastState.terminated
- 설명
- ContainerStateTerminated는 컨테이너의 종료 상태입니다.
- 유형
-
object
- 필수 항목
-
exitCode
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID |
|
| 컨테이너의 마지막 종료 후 종료 상태 |
| 컨테이너가 마지막으로 종료되는 시간 | |
|
| 컨테이너의 마지막 종료에 대한 메시지 |
|
| (brief) 컨테이너의 마지막 종료 이유 |
|
| 컨테이너의 마지막 종료 시 신호 |
| 이전 컨테이너 실행이 시작된 시간 |
14.1.311. .status.ephemeralContainerStatuses[].lastState.waiting
- 설명
- ContainerStateWaiting은 컨테이너의 대기 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다. |
|
| (brief) 컨테이너가 아직 실행되지 않은 이유 |
14.1.312. .status.ephemeralContainerStatuses[].state
- 설명
- ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerStateRunning은 컨테이너의 실행 중인 상태입니다. |
|
| ContainerStateTerminated는 컨테이너의 종료 상태입니다. |
|
| ContainerStateWaiting은 컨테이너의 대기 상태입니다. |
14.1.313. .status.ephemeralContainerStatuses[].state.running
- 설명
- ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 컨테이너가 마지막으로 시작된 시간(다시) |
14.1.314. .status.ephemeralContainerStatuses[].state.terminated
- 설명
- ContainerStateTerminated는 컨테이너의 종료 상태입니다.
- 유형
-
object
- 필수 항목
-
exitCode
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID |
|
| 컨테이너의 마지막 종료 후 종료 상태 |
| 컨테이너가 마지막으로 종료되는 시간 | |
|
| 컨테이너의 마지막 종료에 대한 메시지 |
|
| (brief) 컨테이너의 마지막 종료 이유 |
|
| 컨테이너의 마지막 종료 시 신호 |
| 이전 컨테이너 실행이 시작된 시간 |
14.1.315. .status.ephemeralContainerStatuses[].state.waiting
- 설명
- ContainerStateWaiting은 컨테이너의 대기 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다. |
|
| (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
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID입니다. |
|
| 컨테이너가 실행 중인 이미지입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images. |
|
| 컨테이너 이미지의 ImageId. |
|
| ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다. |
|
| DNS_LABEL이어야 합니다. Pod의 각 컨테이너에는 고유한 이름이 있어야 합니다. CamelCase로 |
|
| 컨테이너가 준비 상태 프로브를 통과했는지 여부를 지정합니다. |
|
| 컨테이너가 다시 시작된 횟수입니다. |
|
| 컨테이너가 시작 프로브를 통과했는지 여부를 지정합니다. false로 초기화되고 startupProbe가 성공한 후 true가 됩니다. 컨테이너를 다시 시작하거나 kubelet이 일시적으로 상태가 손실될 때 false로 재설정됩니다. startupProbe가 정의되지 않은 경우 항상 true입니다. |
|
| ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다. |
14.1.318. .status.initContainerStatuses[].lastState
- 설명
- ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerStateRunning은 컨테이너의 실행 중인 상태입니다. |
|
| ContainerStateTerminated는 컨테이너의 종료 상태입니다. |
|
| ContainerStateWaiting은 컨테이너의 대기 상태입니다. |
14.1.319. .status.initContainerStatuses[].lastState.running
- 설명
- ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 컨테이너가 마지막으로 시작된 시간(다시) |
14.1.320. .status.initContainerStatuses[].lastState.terminated
- 설명
- ContainerStateTerminated는 컨테이너의 종료 상태입니다.
- 유형
-
object
- 필수 항목
-
exitCode
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID |
|
| 컨테이너의 마지막 종료 후 종료 상태 |
| 컨테이너가 마지막으로 종료되는 시간 | |
|
| 컨테이너의 마지막 종료에 대한 메시지 |
|
| (brief) 컨테이너의 마지막 종료 이유 |
|
| 컨테이너의 마지막 종료 시 신호 |
| 이전 컨테이너 실행이 시작된 시간 |
14.1.321. .status.initContainerStatuses[].lastState.waiting
- 설명
- ContainerStateWaiting은 컨테이너의 대기 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다. |
|
| (brief) 컨테이너가 아직 실행되지 않은 이유 |
14.1.322. .status.initContainerStatuses[].state
- 설명
- ContainerState에는 컨테이너의 가능한 상태가 있습니다. 해당 멤버 중 하나만 지정할 수 있습니다. 이 중 하나를 지정하지 않으면 기본 하나는 ContainerStateWaiting입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerStateRunning은 컨테이너의 실행 중인 상태입니다. |
|
| ContainerStateTerminated는 컨테이너의 종료 상태입니다. |
|
| ContainerStateWaiting은 컨테이너의 대기 상태입니다. |
14.1.323. .status.initContainerStatuses[].state.running
- 설명
- ContainerStateRunning은 컨테이너의 실행 중인 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 컨테이너가 마지막으로 시작된 시간(다시) |
14.1.324. .status.initContainerStatuses[].state.terminated
- 설명
- ContainerStateTerminated는 컨테이너의 종료 상태입니다.
- 유형
-
object
- 필수 항목
-
exitCode
-
속성 | 유형 | 설명 |
---|---|---|
|
| '<type>://<container_id>' 형식의 컨테이너 ID |
|
| 컨테이너의 마지막 종료 후 종료 상태 |
| 컨테이너가 마지막으로 종료되는 시간 | |
|
| 컨테이너의 마지막 종료에 대한 메시지 |
|
| (brief) 컨테이너의 마지막 종료 이유 |
|
| 컨테이너의 마지막 종료 시 신호 |
| 이전 컨테이너 실행이 시작된 시간 |
14.1.325. .status.initContainerStatuses[].state.waiting
- 설명
- ContainerStateWaiting은 컨테이너의 대기 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너가 아직 실행되지 않은 이유에 대한 메시지입니다. |
|
| (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는 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Pod 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
14.2.2. /API/v1/watch/pods
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
14.2.3. /api/v1/namespaces/{namespace}/pods
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- Pod 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- Pod 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- Pod 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
14.2.4. /api/v1/watch/namespaces/{namespace}/pods
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- Pod 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
14.2.5. /api/v1/namespaces/{namespace}/pods/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| Pod 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- Pod 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 Pod 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Pod를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Pod를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
14.2.6. /api/v1/namespaces/{namespace}/pods/{name}/log
매개변수 | 유형 | 설명 |
---|---|---|
|
| Pod 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 로그를 스트리밍할 컨테이너입니다. Pod에 컨테이너가 한 개 있는 경우에만 기본값은 컨테이너입니다. |
|
| Pod의 로그 스트림을 따릅니다. 기본값은 false입니다. |
|
| insecureSkipTLSVerifyBackend는 apiserver가 연결된 백엔드의 제공 인증서의 유효성을 확인하지 않아야 함을 나타냅니다. 이렇게 하면 apiserver와 백엔드 간에 HTTPS 연결이 안전하지 않습니다. 즉, apiserver에서 수신 중인 로그 데이터를 실제 kubelet에서 확인할 수 없습니다. kubelet이 apiserver의 TLS 인증 정보를 확인하도록 구성된 경우 실제 kubelet에 대한 연결이 중간 공격의 사람에 취약하지 않습니다(예: 공격자가 실제 kubelet에서 들어오는 실제 로그 데이터를 가로챌 수 없음). |
|
| 설정된 경우 로그 출력을 종료하기 전에 서버에서 읽을 바이트 수입니다. 이는 완전한 최종 로깅 행을 표시하지 않을 수 있으며 지정된 제한보다 약간 많거나 적을 수 있습니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| 이전에 종료된 컨테이너 로그를 반환합니다. 기본값은 false입니다. |
|
| 로그를 표시할 현재 시간(초) 전의 상대 시간(초)입니다. 이 값이 Pod를 시작한 시간보다 앞면 Pod 시작 이후의 로그만 반환됩니다. 이 값이 향후이면 로그가 반환되지 않습니다. sinceSeconds 또는 sinceTime 중 하나만 지정할 수 있습니다. |
|
| 설정하는 경우 표시할 로그 끝부분의 행 수입니다. 지정하지 않으면 컨테이너 생성 또는 sinceSeconds 또는 sinceTime에서 로그가 표시됩니다. |
|
| true인 경우 로그 출력의 모든 줄 시작 부분에 RFC3339 또는 RFC3339Nano 타임스탬프를 추가합니다. 기본값은 false입니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 Pod의 로그 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
14.2.7. /api/v1/watch/namespaces/{namespace}/pods/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| Pod 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 Pod의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
14.2.8. /api/v1/namespaces/{namespace}/pods/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| Pod 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 Pod의 상태 확인
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Pod의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Pod의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
14.2.9. /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers
매개변수 | 유형 | 설명 |
---|---|---|
|
| Pod 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 Pod의 ephemeralcontainers 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Pod의 임시containers를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Pod의 ephemeralcontainers 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
15장. ReplicationController [v1]
- 설명
- 복제 컨트롤러의 구성을 나타냅니다.
- 유형
-
object
15.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ReplicationController의 라벨이 비어 있으면 복제 컨트롤러가 관리하는 Pod와 동일하게 기본 설정됩니다. 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| ReplicationControllerSpec은 복제 컨트롤러의 사양입니다. |
|
| ReplicationControllerStatus는 복제 컨트롤러의 현재 상태를 나타냅니다. |
15.1.1. .spec
- 설명
- ReplicationControllerSpec은 복제 컨트롤러의 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)을 사용할 수 있습니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨) |
|
| 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 |
|
| PodTemplateSpec은 템플릿에서 Pod가 생성할 때 보유해야 하는 데이터를 설명합니다. |
15.1.2. .spec.template
- 설명
- PodTemplateSpec은 템플릿에서 Pod가 생성할 때 보유해야 하는 데이터를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| PodSpec은 Pod에 대한 설명입니다. |
15.1.3. .spec.template.spec
- 설명
- PodSpec은 Pod에 대한 설명입니다.
- 유형
-
object
- 필수 항목
-
컨테이너
-
속성 | 유형 | 설명 |
---|---|---|
|
| 시스템이 적극적으로 실패했음을 표시하고 연결된 컨테이너를 종료하기 전에 Pod가 StartTime을 기준으로 노드에서 활성화되는 시간(초)입니다. 값은 양의 정수여야 합니다. |
|
| 유사성은 선호도 스케줄링 규칙 그룹입니다. |
|
| AutomountServiceAccountToken은 서비스 계정 토큰을 자동으로 마운트해야 하는지 여부를 나타냅니다. |
|
| Pod에 속하는 컨테이너 목록입니다. 컨테이너는 현재 추가 또는 제거할 수 없습니다. Pod에는 하나 이상의 컨테이너가 있어야 합니다. CamelCase로 |
|
| Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다. |
|
| PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다. |
|
| Pod의 DNS 정책을 설정합니다. 기본값은 "ClusterFirst"입니다. 유효한 값은 'ClusterFirstWithHostNet', 'ClusterFirst', 'Default' 또는 'None'입니다. DNSConfig에 제공된 DNS 매개변수는 DNSPolicy와 선택한 정책과 병합됩니다. hostNetwork와 함께 DNS 옵션을 설정하려면 'ClusterFirstWithHostNet'에 DNS 정책을 명시적으로 지정해야 합니다.
가능한 enum 값: - |
|
| EnableServiceLinks는 서비스에 대한 정보를 Docker 링크의 구문과 일치하는 Pod의 환경 변수에 삽입해야 하는지 여부를 나타냅니다. 선택 사항: true로 설정됩니다. |
|
| 이 Pod에서 실행되는 임시 컨테이너 목록입니다. 임시 컨테이너는 기존 Pod에서 실행하여 디버깅과 같은 사용자 시작 작업을 수행할 수 있습니다. 이 목록은 Pod를 생성할 때 지정할 수 없으며 Pod 사양을 업데이트하여 수정할 수 없습니다. 기존 포드에 임시 컨테이너를 추가하려면 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. |
|
| EphemeralContainer는 디버깅과 같은 사용자 시작 활동을 위해 기존 Pod에 추가할 수 있는 임시 컨테이너입니다. 임시 컨테이너에는 리소스 또는 스케줄링 보장이 없으며 Pod가 종료되거나 Pod를 다시 시작할 때 재시작되지 않습니다. 임시 컨테이너에서 Pod가 리소스 할당을 초과하는 경우 kubelet에서 Pod를 제거할 수 있습니다. 임시 컨테이너를 추가하려면 기존 Pod의 ephemeralcontainers 하위 리소스를 사용합니다. 임시 컨테이너는 제거하거나 다시 시작할 수 없습니다. |
|
| hostAliases는 지정된 경우 Pod의 호스트 파일에 삽입될 호스트 및 IP의 선택적 목록입니다. 이는 non-hostNetwork Pod에만 유효합니다. |
|
| HostAlias는 Pod의 호스트 파일에 항목으로 삽입될 IP와 호스트 이름 간의 매핑을 보유합니다. |
|
| 호스트의 ipc 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다. |
|
| 이 Pod에 대해 요청된 호스트 네트워킹입니다. 호스트의 네트워크 네임스페이스를 사용합니다. 이 옵션을 설정하는 경우 사용할 포트를 지정해야 합니다. 기본값은 false입니다. |
|
| 호스트의 pid 네임스페이스를 사용합니다. 선택 사항: 기본값은 false입니다. |
|
| 호스트의 사용자 네임스페이스를 사용합니다. 선택 사항: 기본값은 true입니다. true로 설정하면 Pod에 CAP_SYS_MODULE을 사용하여 커널 모듈을 로드하는 등 호스트 사용자 네임스페이스만 사용할 수 있는 기능이 필요한 경우에 유용합니다. false로 설정하면 Pod에 대한 새 사용자가 생성됩니다. false를 설정하면 사용자가 실제로 호스트에 대한 root 권한이 없어도 컨테이너 중단 취약점을 완화하는 데 유용합니다. 이 필드는 알파 수준이며 UserNamespacesSupport 기능을 활성화하는 서버에서만 적용됩니다. |
|
| Pod의 호스트 이름을 지정하지 않으면 Pod의 호스트 이름이 시스템 정의 값으로 설정됩니다. |
|
| imagePullSecrets는 이 PodSpec에서 사용하는 이미지를 가져오는 데 사용할 동일한 네임스페이스의 시크릿에 대한 선택적 참조 목록입니다. 지정된 경우 이러한 시크릿은 사용할 수 있도록 개별 풀러 구현으로 전달됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| Pod에 속하는 초기화 컨테이너 목록입니다. Init 컨테이너는 컨테이너가 시작되기 전에 실행됩니다. init 컨테이너가 실패하면 Pod가 실패한 것으로 간주되고 restartPolicy에 따라 처리됩니다. init 컨테이너 또는 일반 컨테이너의 이름은 모든 컨테이너에서 고유해야 합니다. Init 컨테이너에는 Lifecycle 작업, 준비 상태 프로브, 활성 상태 프로브 또는 시작 프로브가 없을 수 있습니다. init 컨테이너의 resourceRequirements는 각 리소스 유형에 대해 가장 높은 요청/제한을 찾은 다음 해당 값의 최대값 또는 일반 컨테이너의 합계를 사용하여 스케줄링 중에 고려됩니다. 제한은 init 컨테이너에 유사한 방식으로 적용됩니다. init 컨테이너는 현재 추가 또는 제거할 수 없습니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/init-containers/ |
|
| Pod 내에서 실행하려는 단일 애플리케이션 컨테이너입니다. |
|
| nodename은 이 Pod를 특정 노드에 예약하기 위한 요청입니다. 비어 있지 않은 경우 스케줄러는 리소스 요구 사항에 부합한다고 가정하면 해당 노드에 이 Pod를 간단히 예약합니다. |
|
| nodeSelector는 Pod가 노드에 적합하도록 true여야 하는 선택기입니다. 해당 노드에 예약하려면 Pod의 노드 레이블과 일치해야 하는 선택기입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/assign-pod-node/ |
|
| PodOS는 Pod의 OS 매개변수를 정의합니다. |
| 오버헤드는 지정된 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는 우선순위가 낮은 Pod를 선점하는 정책입니다. Never, PreemptLowerPriority 중 하나입니다. 설정되지 않은 경우 기본값은 PreemptLowerPriority입니다. |
|
| 우선순위 값입니다. 다양한 시스템 구성 요소는 이 필드를 사용하여 Pod의 우선 순위를 찾습니다. Priority Admission Controller가 활성화되면 사용자가 이 필드를 설정할 수 없습니다. 승인 컨트롤러는 PriorityClassName에서 이 필드를 채웁니다. 값이 클수록 우선순위가 높습니다. |
|
| 지정하면 Pod의 우선 순위를 나타냅니다. "system-node-critical" 및 "system-cluster-critical"은 두 가지 특수 키워드로, 전자의 우선 순위가 가장 높은 우선 순위임을 나타냅니다. 다른 이름은 해당 이름으로 PriorityClass 오브젝트를 생성하여 정의해야 합니다. 지정하지 않으면 Pod 우선순위가 기본값 또는 기본값이 없는 경우 0입니다. |
|
| 지정하면 Pod 준비 상태에 대한 모든 준비 상태 게이트가 평가됩니다. 모든 컨테이너가 준비되고 준비 게이트에 지정된 모든 조건이 "True" 추가 정보와 같은 상태가 있는 경우 Pod가 준비됩니다. https://git.k8s.io/enhancements/keps/sig-network/580-pod-readiness-gates |
|
| PodReadinessGate에는 Pod 상태에 대한 참조가 포함되어 있습니다. |
|
| Pod 내의 모든 컨테이너에 대한 재시작 정책입니다. Always, OnFailure, Never 중 하나입니다. 기본값은 Always입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy
가능한 열거 값: - |
|
| runtimeClassName은 이 Pod를 실행하는 데 사용해야 하는 node.k8s.io 그룹의 RuntimeClass 오브젝트를 나타냅니다. RuntimeClass 리소스가 이름이 지정된 클래스와 일치하지 않으면 Pod가 실행되지 않습니다. 설정되지 않았거나 비어 있으면 기본 런타임 처리기를 사용하는 빈 정의가 있는 암시적 클래스인 "legacy" RuntimeClass가 사용됩니다. 자세한 내용은 https://git.k8s.io/enhancements/keps/sig-node/585-runtime-class |
|
| 지정된 경우 지정된 스케줄러에 의해 Pod가 디스패치됩니다. 지정하지 않으면 Pod가 기본 스케줄러에서 디스패치됩니다. |
|
| PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다. |
|
| 더 이상 사용되지 않는ServiceAccount는 ServiceAccountName의 더 이상 사용되지 않는 별칭입니다. deprecated: 대신 serviceAccountName을 사용합니다. |
|
| serviceAccountName은 이 Pod를 실행하는 데 사용할 ServiceAccount의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/ |
|
| true인 경우 Pod의 호스트 이름이 리프 이름(기본값)이 아닌 Pod의 FQDN으로 구성됩니다. Linux 컨테이너에서 커널의 hostname 필드에 FQDN을 설정하는 것을 의미합니다( struct utsname의 nodename 필드). Windows 컨테이너에서 레지스트리 키 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters의 레지스트리 값을 FQDN으로 설정하는 것을 의미합니다. Pod에 FQDN이 없는 경우 적용되지 않습니다. 기본값은 false입니다. |
|
| Pod의 모든 컨테이너 간에 단일 프로세스 네임스페이스를 공유합니다. 컨테이너를 설정하면 동일한 포드에 있는 다른 컨테이너의 프로세스를 보고 신호할 수 있으며 각 컨테이너의 첫 번째 프로세스에 PID 1이 할당되지 않습니다. HostPID 및 ShareProcessNamespace는 둘 다 설정할 수 없습니다. 선택 사항: 기본값은 false입니다. |
|
| 지정된 경우 정규화된 Pod 호스트 이름은 "<hostname>.<subdomain>.<pod namespace>.svc.<cluster domain>"입니다. 지정하지 않으면 Pod에 도메인 이름이 전혀 없습니다. |
|
| Pod가 정상적으로 종료되어야 하는 시간(초)입니다. 삭제 요청으로 줄어들 수 있습니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 이 값이 nil이면 기본 유예 기간이 대신 사용됩니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 기본값은 30초입니다. |
|
| 지정된 경우 Pod의 허용 오차입니다. |
|
| 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다. |
|
| TopologySpreadConstraints는 Pod 그룹이 토폴로지 도메인에 분산되는 방법을 설명합니다. 스케줄러는 제약 조건에 따라 비활성화되는 방식으로 Pod를 예약합니다. 모든 topologySpreadConstraints는 ANDed입니다. |
|
| TopologySpreadConstraint는 지정된 토폴로지에 일치하는 Pod를 분배하는 방법을 지정합니다. |
|
| Pod에 속하는 컨테이너에서 마운트할 수 있는 볼륨 목록입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes |
|
| volume은 Pod의 모든 컨테이너에서 액세스할 수 있는 Pod에서 이름이 지정된 볼륨을 나타냅니다. |
15.1.4. .spec.template.spec.affinity
- 설명
- 유사성은 선호도 스케줄링 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다. |
|
| Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다. |
|
| Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다. |
15.1.5. .spec.template.spec.affinity.nodeAffinity
- 설명
- 노드 유사성은 노드 유사성 스케줄링 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 노드이며, 이 필드의 요소를 반복하고 노드가 해당 matchExpressions와 일치하는 경우 "weight"을 합계에 추가하여 합계를 더 많이 계산합니다. |
|
| 권장되는 빈 스케줄링 용어는 암시적 가중치가 0인 모든 오브젝트와 일치합니다(즉, no-op임). null 기본 스케줄링 용어는 오브젝트(즉, no-op)와 일치하지 않습니다. |
|
| 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다. |
|
| 1-100 범위의 해당 nodeSelectorTerm과 일치하는 가중치입니다. |
15.1.8. .spec.template.spec.affinity.nodeAffinity.preferredDuringSchedulingIgnoredDuringExecution[].preference
- 설명
- null 또는 빈 노드 선택기 용어는 오브젝트와 일치하지 않습니다. 이러한 요구 사항은 AND로 표시됩니다. TopologySelectorTerm 유형은 NodeSelectorTerm의 하위 집합을 구현합니다.
- 유형
-
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
15.1.13. .spec.template.spec.affinity.nodeAffinity.requiredDuringSchedulingIgnoredDuringExecution
- 설명
- 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
- 유형
-
object
- 필수 항목
-
nodeSelectorTerms
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 노드의 필드별 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
15.1.20. .spec.template.spec.affinity.podAffinity
- 설명
- Pod 유사성은 Pod 간 유사성 예약 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 스케줄러는 이 필드에 지정된 선호도 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling 선호도 표현식 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 합계에 "weight"을 추가하여 합계를 더 많이 계산합니다. |
|
| 일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다. |
|
| 이 필드에 지정된 선호도 요구 사항이 예약 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. Pod 실행 중 이 필드에 지정된 선호도 요구 사항이 일정 시점에서 충족되지 않는 경우(예: Pod 레이블 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다. |
|
| 1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다. |
15.1.23. .spec.template.spec.affinity.podAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 설명
- Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
- 유형
-
object
- 필수 항목
-
TopologyKey
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 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
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 Pod는 지정된 네임스페이스의 labelSelector와 일치하는 Pod와 함께 배치(유사성 방지)하거나 공동 배치하지 않아야 합니다. 여기서 키 topologyKey가 있는 라벨 값이 선택한 Pod가 실행 중인 노드의 값이 일치하는 노드에서 co-located가 실행됩니다. 빈 topologyKey는 허용되지 않습니다. |
15.1.26. .spec.template.spec.affinity.podAntiAffinity
- 설명
- Pod 유사성 선호도는 Pod 간 유사성 스케줄링 규칙 그룹입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 스케줄러는 이 필드에 지정된 유사성 방지 표현식을 충족하는 노드에 Pod를 예약하는 것을 선호하지만 하나 이상의 표현식을 위반하는 노드를 선택할 수 있습니다. 가장 선호하는 노드는 가중치의 가장 큰 합계, 즉 모든 스케줄링 요구 사항(리소스 요청, requiredDuringScheduling anti-affinity expressions 등)을 충족하는 각 노드에 대해 이 필드의 요소를 반복하고 노드에 해당 podAffinityTerm과 일치하는 Pod가 있는 경우 "weight"을 추가하여 합계를 더 많이 계산합니다. |
|
| 일치하는 모든 WeightedPodAffinityTerm 필드의 가중치가 노드별 추가되어 가장 선호되는 노드를 찾습니다. |
|
| 이 필드에 지정된 유사성 방지 요구 사항이 스케줄링 시 충족되지 않으면 Pod가 노드에 예약되지 않습니다. 이 필드에 지정된 유사성 방지 요구 사항이 Pod 실행 중 일정 시점에 충족되지 않는 경우(예: Pod 라벨 업데이트로 인해) 시스템은 노드에서 Pod를 제거하거나 제거하지 않을 수 있습니다. 요소가 여러 개인 경우 각 podAffinityTerm에 해당하는 노드 목록이 교차됩니다. 즉, 모든 용어를 충족해야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다. |
|
| 1-100 범위의 해당 podAffinityTerm과 일치하는 가중치입니다. |
15.1.29. .spec.template.spec.affinity.podAntiAffinity.preferredDuringSchedulingIgnoredDuringExecution[].podAffinityTerm
- 설명
- Pod 세트를 정의합니다(즉, 이 Pod가 함께 배치되어야 하거나 (유사성 방지)해야 하는 지정된 네임스페이스를 기준으로 labelSelector와 일치하는 Pod 집합을 정의합니다. 여기서 co-located는 키 <topologyKey>가 있는 라벨 값이 있는 노드에서 실행됨으로 정의됩니다.
- 유형
-
object
- 필수 항목
-
TopologyKey
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 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
-
속성 | 유형 | 설명 |
---|---|---|
| 리소스 세트(이 경우 Pod)에 대한 라벨 쿼리입니다. | |
| 용어가 적용되는 네임스페이스 집합에 대한 레이블 쿼리입니다. 이 용어는 이 필드에서 선택한 네임스페이스와 네임스페이스 필드에 나열된 네임스페이스의 조합에 적용됩니다. null 선택기 및 null 또는 빈 네임스페이스 목록은 "이 Pod의 네임스페이스"를 의미합니다. 빈 선택기({})는 모든 네임스페이스와 일치합니다. | |
|
| 네임스페이스는 용어가 적용되는 네임스페이스 이름의 정적 목록을 지정합니다. 이 용어는 이 필드에 나열된 네임스페이스와 namespaceSelector에서 선택한 네임스페이스의 결합에 적용됩니다. null 또는 빈 네임스페이스 목록과 null namespaceSelector는 "이 Pod의 네임스페이스"를 의미합니다. |
|
| 이 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 진입점에 대한 인수입니다. 컨테이너 이미지의 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 |
|
| 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 |
|
| 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로 |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로 |
|
| EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다. |
|
| 컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다. |
|
| 이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images
가능한 열거 값: - |
|
| 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로 |
|
| 컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로 |
|
| containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
|
| securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| 이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다. |
|
| 컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다. |
|
| 선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로 |
|
| 종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로
가능한 enum 값: - |
|
| 이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다. |
|
| volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다. |
|
| volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다. |
|
| 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로 |
|
| volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다. |
|
| 컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로 |
15.1.34. .spec.template.spec.containers[].env
- 설명
- 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
- 유형
-
array
15.1.35. .spec.template.spec.containers[].env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| EnvVarSource는 EnvVar 값의 소스를 나타냅니다. |
15.1.36. .spec.template.spec.containers[].env[].valueFrom
- 설명
- EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap에서 키를 선택합니다. |
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
|
| SecretKeySelector는 시크릿의 키를 선택합니다. |
15.1.37. .spec.template.spec.containers[].env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap에서 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
15.1.38. .spec.template.spec.containers[].env[].valueFrom.fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
15.1.39. .spec.template.spec.containers[].env[].valueFrom.resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
15.1.40. .spec.template.spec.containers[].env[].valueFrom.secretKeyRef
- 설명
- SecretKeySelector는 시크릿의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
15.1.41. .spec.template.spec.containers[].envFrom
- 설명
- 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
- 유형
-
array
15.1.42. .spec.template.spec.containers[].envFrom[]
- 설명
- EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다. 대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
|
| ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다. |
|
| SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다. 대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
15.1.43. .spec.template.spec.containers[].envFrom[].configMapRef
- 설명
ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.
대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap을 정의해야 하는지 여부를 지정 |
15.1.44. .spec.template.spec.containers[].envFrom[].secretRef
- 설명
SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.
대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 보안을 정의해야 하는지 여부를 지정합니다. |
15.1.45. .spec.template.spec.containers[].lifecycle
- 설명
- 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
15.1.46. .spec.template.spec.containers[].lifecycle.postStart
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
15.1.47. .spec.template.spec.containers[].lifecycle.postStart.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.48. .spec.template.spec.containers[].lifecycle.postStart.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.51. .spec.template.spec.containers[].lifecycle.postStart.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.52. .spec.template.spec.containers[].lifecycle.preStop
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
15.1.53. .spec.template.spec.containers[].lifecycle.preStop.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.54. .spec.template.spec.containers[].lifecycle.preStop.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.57. .spec.template.spec.containers[].lifecycle.preStop.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.58. .spec.template.spec.containers[].livenessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.59. .spec.template.spec.containers[].livenessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.60. .spec.template.spec.containers[].livenessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.64. .spec.template.spec.containers[].livenessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다. |
|
| 외부 포트를 바인딩할 호스트 IP는 무엇입니까. |
|
| 호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다. |
|
| 지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다. |
|
| 포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.
가능한 열거 값: - |
15.1.67. .spec.template.spec.containers[].readinessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.68. .spec.template.spec.containers[].readinessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.69. .spec.template.spec.containers[].readinessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.73. .spec.template.spec.containers[].readinessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.74. .spec.template.spec.containers[].resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 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은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다. |
|
| 권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
15.1.76. .spec.template.spec.containers[].securityContext.capabilities
- 설명
- 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 기능 |
|
| 제거된 기능 |
15.1.77. .spec.template.spec.containers[].securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
15.1.78. .spec.template.spec.containers[].securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.
가능한 열거 값: - |
15.1.79. .spec.template.spec.containers[].securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
15.1.80. .spec.template.spec.containers[].startupProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.81. .spec.template.spec.containers[].startupProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.82. .spec.template.spec.containers[].startupProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.86. .spec.template.spec.containers[].startupProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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는 장치를 매핑할 컨테이너 내부의 경로입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다. |
|
| mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다. |
|
| 이는 볼륨 이름과 일치해야 합니다. |
|
| true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다. |
15.1.91. .spec.template.spec.dnsConfig
- 설명
- PodDNSConfig는 DNSPolicy에서 생성된 Pod 외에도 Pod의 DNS 매개변수를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DNS 이름 서버 IP 주소 목록입니다. DNSPolicy에서 생성된 기본 이름 서버에 추가됩니다. 중복된 네임서버가 제거됩니다. |
|
| DNS 확인자 옵션 목록입니다. 이는 DNSPolicy에서 생성된 기본 옵션과 병합됩니다. 중복된 항목이 제거됩니다. 옵션에 제공된 해결 옵션은 기본 DNSPolicy에 표시되는 옵션을 재정의합니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. |
|
|
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 진입점에 대한 인수입니다. 이미지의 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 |
|
| 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 |
|
| 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로 |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로 |
|
| EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다. |
|
| 컨테이너 이미지 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images |
|
| 이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images
가능한 열거 값: - |
|
| 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| DNS_LABEL로 지정된 임시 컨테이너의 이름입니다. 이 이름은 모든 컨테이너, init 컨테이너 및 임시 컨테이너에서 고유해야 합니다. |
|
| 임시 컨테이너에는 포트가 허용되지 않습니다. |
|
| containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
|
| securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| 이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다. |
|
| 컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다. |
|
| 설정된 경우 PodSpec의 컨테이너 이름이 이 임시 컨테이너를 대상으로 합니다. 임시 컨테이너는 이 컨테이너의 네임스페이스(IPC, PID 등)에서 실행됩니다. 설정되지 않은 경우 임시 컨테이너는 Pod 사양에 구성된 네임스페이스를 사용합니다. 컨테이너 런타임은 이 기능에 대한 지원을 구현해야 합니다. 런타임에서 네임스페이스 대상 지정을 지원하지 않으면 이 필드를 설정한 결과는 정의되지 않습니다. |
|
| 선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로 |
|
| 종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로
가능한 enum 값: - |
|
| 이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다. |
|
| volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다. |
|
| volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다. |
|
| 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. 임시 컨테이너에는 하위 경로 마운트가 허용되지 않습니다. CamelCase로 |
|
| volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다. |
|
| 컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로 |
15.1.96. .spec.template.spec.ephemeralContainers[].env
- 설명
- 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
- 유형
-
array
15.1.97. .spec.template.spec.ephemeralContainers[].env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| EnvVarSource는 EnvVar 값의 소스를 나타냅니다. |
15.1.98. .spec.template.spec.ephemeralContainers[].env[].valueFrom
- 설명
- EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap에서 키를 선택합니다. |
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
|
| SecretKeySelector는 시크릿의 키를 선택합니다. |
15.1.99. .spec.template.spec.ephemeralContainers[].env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap에서 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
15.1.100. .spec.template.spec.ephemeralContainers[].env[].valueFrom.fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
15.1.101. .spec.template.spec.ephemeralContainers[].env[].valueFrom.resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
15.1.102. .spec.template.spec.ephemeralContainers[].env[].valueFrom.secretKeyRef
- 설명
- SecretKeySelector는 시크릿의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
15.1.103. .spec.template.spec.ephemeralContainers[].envFrom
- 설명
- 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
- 유형
-
array
15.1.104. .spec.template.spec.ephemeralContainers[].envFrom[]
- 설명
- EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다. 대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
|
| ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다. |
|
| SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다. 대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
15.1.105. .spec.template.spec.ephemeralContainers[].envFrom[].configMapRef
- 설명
ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.
대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap을 정의해야 하는지 여부를 지정 |
15.1.106. .spec.template.spec.ephemeralContainers[].envFrom[].secretRef
- 설명
SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.
대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 보안을 정의해야 하는지 여부를 지정합니다. |
15.1.107. .spec.template.spec.ephemeralContainers[].lifecycle
- 설명
- 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
15.1.108. .spec.template.spec.ephemeralContainers[].lifecycle.postStart
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
15.1.109. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.110. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.113. .spec.template.spec.ephemeralContainers[].lifecycle.postStart.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.114. .spec.template.spec.ephemeralContainers[].lifecycle.preStop
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
15.1.115. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.116. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.119. .spec.template.spec.ephemeralContainers[].lifecycle.preStop.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.120. .spec.template.spec.ephemeralContainers[].livenessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.121. .spec.template.spec.ephemeralContainers[].livenessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.122. .spec.template.spec.ephemeralContainers[].livenessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.126. .spec.template.spec.ephemeralContainers[].livenessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다. |
|
| 외부 포트를 바인딩할 호스트 IP는 무엇입니까. |
|
| 호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다. |
|
| 지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다. |
|
| 포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.
가능한 열거 값: - |
15.1.129. .spec.template.spec.ephemeralContainers[].readinessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.130. .spec.template.spec.ephemeralContainers[].readinessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.131. .spec.template.spec.ephemeralContainers[].readinessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.135. .spec.template.spec.ephemeralContainers[].readinessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.136. .spec.template.spec.ephemeralContainers[].resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 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은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다. |
|
| 권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
15.1.138. .spec.template.spec.ephemeralContainers[].securityContext.capabilities
- 설명
- 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 기능 |
|
| 제거된 기능 |
15.1.139. .spec.template.spec.ephemeralContainers[].securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
15.1.140. .spec.template.spec.ephemeralContainers[].securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.
가능한 열거 값: - |
15.1.141. .spec.template.spec.ephemeralContainers[].securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
15.1.142. .spec.template.spec.ephemeralContainers[].startupProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.143. .spec.template.spec.ephemeralContainers[].startupProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.144. .spec.template.spec.ephemeralContainers[].startupProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.148. .spec.template.spec.ephemeralContainers[].startupProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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는 장치를 매핑할 컨테이너 내부의 경로입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다. |
|
| mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다. |
|
| 이는 볼륨 이름과 일치해야 합니다. |
|
| true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. 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 주소입니다. |
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
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 진입점에 대한 인수입니다. 컨테이너 이미지의 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 |
|
| 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 |
|
| 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로 |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로 |
|
| EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다. |
|
| 컨테이너 이미지 이름입니다. 자세한 정보: https://kubernetes.io/docs/concepts/containers/images 이 필드는 고급 구성 관리를 통해 Deployments 및 StatefulSets와 같은 워크로드 컨트롤러에서 컨테이너 이미지를 기본값 또는 재정의할 수 있도록 하는 선택적입니다. |
|
| 이미지 가져오기 정책. 항상, Never, IfNotPresent 중 하나입니다. :latest 태그가 지정되거나 IfNotPresent가 없는 경우 기본값은 Always입니다. CamelCase로 자세한 내용은 https://kubernetes.io/docs/concepts/containers/images#updating-images
가능한 열거 값: - |
|
| 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| DNS_LABEL로 지정된 컨테이너의 이름입니다. Pod의 각 컨테이너에는 고유한 이름(DNS_LABEL)이 있어야 합니다. CamelCase로 |
|
| 컨테이너에서 노출할 포트 목록입니다. 여기에 포트를 지정하지 않으면 해당 포트가 노출되지 않습니다. 컨테이너 내부의 기본 "0.0.0.0" 주소에서 수신 대기 중인 모든 포트는 네트워크에서 액세스할 수 있습니다. 전략적 병합 패치로 이 배열을 수정하면 데이터가 손상될 수 있습니다. 자세한 내용은 https://github.com/kubernetes/kubernetes/issues/108255 을 참조하십시오. CamelCase로 |
|
| containerPort는 단일 컨테이너의 네트워크 포트를 나타냅니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
|
| securityContext에는 컨테이너에 적용할 보안 구성이 있습니다. 일부 필드는 SecurityContext 및 PodSecurityContext에 모두 있습니다. 둘 다 설정되면 SecurityContext의 값이 우선합니다. |
|
| 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다. |
|
| 이 컨테이너에서 컨테이너 런타임에서 stdin에 대한 버퍼를 할당해야 하는지 여부입니다. 이 값을 설정하지 않으면 컨테이너의 stdin에서 읽기 때문에 항상 EOF가 생성됩니다. 기본값은 false입니다. |
|
| 컨테이너 런타임이 단일 연결에서 열린 후 stdin 채널을 닫아야 하는지 여부입니다. stdin이 true인 경우 stdin 스트림은 여러 연결 세션에서 열린 상태로 유지됩니다. stdinOnce가 true로 설정된 경우 stdin이 컨테이너 시작 시 열리며 첫 번째 클라이언트가 stdin에 연결할 때까지 비어 있고 클라이언트의 연결이 끊어질 때까지 데이터를 수락하고 stdin이 닫히고 컨테이너가 다시 시작될 때까지 닫힙니다. 이 플래그가 false이면 stdin에서 읽은 컨테이너 프로세스는 EOF를 수신하지 않습니다. 기본값은 false입니다. |
|
| 선택 사항: 컨테이너 종료 메시지를 작성할 파일을 컨테이너의 파일 시스템에 마운트하는 경로입니다. 작성된 메시지는 어설션 실패 메시지와 같은 간단한 최종 상태가 되도록 고안되어 있습니다. 4096바이트보다 큰 경우 노드에 의해 잘립니다. 모든 컨테이너의 총 메시지 길이는 12kb로 제한됩니다. 기본값은 /dev/termination-log입니다. CamelCase로 |
|
| 종료 메시지를 채우는 방법을 나타냅니다. 파일은 terminationMessagePath의 콘텐츠를 사용하여 성공과 실패 모두에 컨테이너 상태 메시지를 채웁니다. FallbackToLogsOnError는 종료 메시지 파일이 비어 있고 컨테이너가 오류와 함께 종료되면 컨테이너 로그 출력의 마지막 청크를 사용합니다. 로그 출력은 2048바이트 또는 80 행 중 더 작은 행으로 제한됩니다. 기본값은 File입니다. CamelCase로
가능한 enum 값: - |
|
| 이 컨테이너가 자체적으로 TTY를 할당해야 하는지 여부도 'stdin'이 true여야 합니다. 기본값은 false입니다. |
|
| volumeDevices는 컨테이너에서 사용할 블록 장치 목록입니다. |
|
| volumeDevice는 컨테이너 내의 원시 블록 장치 매핑을 설명합니다. |
|
| 컨테이너의 파일 시스템에 마운트할 Pod 볼륨입니다. CamelCase로 |
|
| volumeMount는 컨테이너 내의 볼륨 마운트를 설명합니다. |
|
| 컨테이너의 작업 디렉터리입니다. 지정하지 않으면 컨테이너 이미지에 구성할 수 있는 컨테이너 런타임의 기본값이 사용됩니다. CamelCase로 |
15.1.159. .spec.template.spec.initContainers[].env
- 설명
- 컨테이너에서 설정할 환경 변수 목록입니다. CamelCase로
- 유형
-
array
15.1.160. .spec.template.spec.initContainers[].env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| EnvVarSource는 EnvVar 값의 소스를 나타냅니다. |
15.1.161. .spec.template.spec.initContainers[].env[].valueFrom
- 설명
- EnvVarSource는 EnvVar 값의 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap에서 키를 선택합니다. |
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
|
| SecretKeySelector는 시크릿의 키를 선택합니다. |
15.1.162. .spec.template.spec.initContainers[].env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap에서 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
15.1.163. .spec.template.spec.initContainers[].env[].valueFrom.fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
15.1.164. .spec.template.spec.initContainers[].env[].valueFrom.resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
15.1.165. .spec.template.spec.initContainers[].env[].valueFrom.secretKeyRef
- 설명
- SecretKeySelector는 시크릿의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
15.1.166. .spec.template.spec.initContainers[].envFrom
- 설명
- 컨테이너에서 환경 변수를 채울 소스 목록입니다. 소스 내에 정의된 키는 C_IDENTIFIER여야 합니다. 컨테이너가 시작될 때 잘못된 모든 키는 이벤트로 보고됩니다. 키가 여러 소스에 있으면 마지막 소스와 연결된 값이 우선합니다. 중복 키가 있는 Env에서 정의한 값이 우선합니다. CamelCase로
- 유형
-
array
15.1.167. .spec.template.spec.initContainers[].envFrom[]
- 설명
- EnvFromSource는 ConfigMaps 세트 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다. 대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
|
| ConfigMap의 각 키 앞에 추가할 선택적 식별자입니다. C_IDENTIFIER여야 합니다. |
|
| SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다. 대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다. |
15.1.168. .spec.template.spec.initContainers[].envFrom[].configMapRef
- 설명
ConfigMapEnvSource는 환경 변수를 채울 ConfigMap을 선택합니다.
대상 ConfigMap의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| ConfigMap을 정의해야 하는지 여부를 지정 |
15.1.169. .spec.template.spec.initContainers[].envFrom[].secretRef
- 설명
SecretEnvSource는 시크릿을 선택하여 환경 변수를 채웁니다.
대상 Secret의 Data 필드의 내용은 키-값 쌍을 환경 변수로 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 보안을 정의해야 하는지 여부를 지정합니다. |
15.1.170. .spec.template.spec.initContainers[].lifecycle
- 설명
- 라이프사이클은 관리 시스템이 컨테이너 라이프사이클 이벤트에 대한 응답으로 수행해야 하는 작업을 설명합니다. PostStart 및 PreStop 라이프사이클 처리기의 경우 컨테이너 프로세스가 실패하지 않는 한 작업이 완료될 때까지 컨테이너를 관리합니다. 이 경우 처리기가 중단됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
|
| LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다. |
15.1.171. .spec.template.spec.initContainers[].lifecycle.postStart
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
15.1.172. .spec.template.spec.initContainers[].lifecycle.postStart.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.173. .spec.template.spec.initContainers[].lifecycle.postStart.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.176. .spec.template.spec.initContainers[].lifecycle.postStart.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.177. .spec.template.spec.initContainers[].lifecycle.preStop
- 설명
- LifecycleHandler는 라이프사이클 후크에서 수행해야 하는 특정 작업을 정의합니다. TCPSocket을 제외한 필드 중 하나만 지정해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
15.1.178. .spec.template.spec.initContainers[].lifecycle.preStop.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.179. .spec.template.spec.initContainers[].lifecycle.preStop.httpGet
- 설명
- HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.182. .spec.template.spec.initContainers[].lifecycle.preStop.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.183. .spec.template.spec.initContainers[].livenessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.184. .spec.template.spec.initContainers[].livenessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.185. .spec.template.spec.initContainers[].livenessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.189. .spec.template.spec.initContainers[].livenessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 IP 주소에 노출할 포트 수입니다. 이는 유효한 포트 번호, 0 < x < 65536 이어야 합니다. |
|
| 외부 포트를 바인딩할 호스트 IP는 무엇입니까. |
|
| 호스트에 노출할 포트 수입니다. 지정하는 경우 유효한 포트 번호, 0 < x < 65536 이어야 합니다. HostNetwork가 지정된 경우 ContainerPort와 일치해야 합니다. 대부분의 컨테이너는 필요하지 않습니다. |
|
| 지정된 경우 이 값은 IANA_SVC_NAME이어야 하며 Pod 내에서 고유해야 합니다. Pod에서 이름이 지정된 각 포트에는 고유한 이름이 있어야 합니다. 서비스에서 참조할 수 있는 포트의 이름입니다. |
|
| 포트용 프로토콜입니다. UDP, TCP 또는 SCTP여야 합니다. 기본값은 "TCP"입니다.
가능한 열거 값: - |
15.1.192. .spec.template.spec.initContainers[].readinessProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.193. .spec.template.spec.initContainers[].readinessProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.194. .spec.template.spec.initContainers[].readinessProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.198. .spec.template.spec.initContainers[].readinessProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. |
15.1.199. .spec.template.spec.initContainers[].resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 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은 프로세스가 상위 프로세스보다 더 많은 권한을 얻을 수 있는지 여부를 제어합니다. 이 bool은 컨테이너 프로세스에 no_new_privs 플래그가 설정되어 있는지 직접 제어합니다. allowPrivilegeEscalation은 컨테이너가 다음과 같은 경우 항상 true입니다. 1) CAP_SYS_ADMIN이 CAP_SYS_ADMIN이 있는 경우 spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다. |
|
| 권한 있는 모드에서 컨테이너를 실행합니다. 권한 있는 컨테이너의 프로세스는 기본적으로 호스트의 root와 동일합니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| procMount는 컨테이너에 사용할 proc 마운트 유형을 나타냅니다. 기본값은 컨테이너 런타임 기본값을 읽기 전용 경로 및 마스크된 경로에 사용하는 DefaultProcMount입니다. 이를 위해서는 ProcMountType 기능 플래그를 활성화해야 합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 이 컨테이너에 읽기 전용 루트 파일 시스템이 있는지 여부입니다. 기본값은 false입니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
15.1.201. .spec.template.spec.initContainers[].securityContext.capabilities
- 설명
- 실행 중인 컨테이너에서 POSIX 기능을 추가하고 제거합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추가 기능 |
|
| 제거된 기능 |
15.1.202. .spec.template.spec.initContainers[].securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
15.1.203. .spec.template.spec.initContainers[].securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. unconfined - 프로필을 적용하지 않아야 합니다.
가능한 열거 값: - |
15.1.204. .spec.template.spec.initContainers[].securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 Windows의 UserName입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. PodSecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
15.1.205. .spec.template.spec.initContainers[].startupProbe
- 설명
- 프로브는 컨테이너에 대해 수행할 상태 점검을 설명하고 트래픽을 받을 준비가 되었는지 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ExecAction은 "컨테이너에서 실행" 작업을 설명합니다. |
|
| 성공 후 프로브가 실패한 것으로 간주되는 최소 연속 실패입니다. 기본값은 3입니다. 최소값은 1입니다. |
|
| GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다. |
|
| HTTPGetAction은 HTTP Get 요청을 기반으로 하는 작업을 설명합니다. |
|
| 활성 프로브가 시작되기 전에 컨테이너를 시작한 후의 시간(초)입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
|
| 프로브를 수행하는 빈도(초)입니다. 기본값은 10초입니다. 최소값은 1입니다. |
|
| 프로브가 실패한 후 성공으로 간주되는 최소 연속 성공입니다. 기본값은 1입니다. 활성 및 시작의 경우 1이어야 합니다. 최소값은 1입니다. |
|
| TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다. |
|
| 선택적 기간(초)은 프로브 실패 시 Pod를 정상적으로 종료해야 합니다. 유예 기간은 Pod에서 실행되는 프로세스가 종료 신호를 보낸 후 시간(초)이며 프로세스가 강제 종료 신호로 중단되는 시간입니다. 이 값을 프로세스에 대해 예상 정리 시간보다 길게 설정합니다. 이 값이 nil이면 Pod의 terminationGracePeriodSeconds가 사용됩니다. 그렇지 않으면 이 값은 Pod 사양에서 제공하는 값을 덮어씁니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 종료 신호를 통해 즉시 중지됨을 나타냅니다(종료할 수 없음). 베타 필드이며 ProbeTerminationGracePeriod 기능 게이트를 활성화해야 합니다. Minimum value is 1. spec.terminationGracePeriodSeconds is used if unset. |
|
| 프로브가 시간 초과되는 시간(초)입니다. 기본값은 1초입니다. 최소값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes |
15.1.206. .spec.template.spec.initContainers[].startupProbe.exec
- 설명
- ExecAction은 "컨테이너에서 실행" 작업을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 명령은 컨테이너 내에서 실행할 명령줄이며, 명령의 작업 디렉터리는 컨테이너 파일 시스템의 루트('/')입니다. 명령은 단순히 exec'd이므로 쉘 내부에서 실행되지 않으므로 기존 쉘 명령('|' 등)이 작동하지 않습니다. 쉘을 사용하려면 해당 쉘을 명시적으로 호출해야 합니다. 종료 상태 0은 라이브/상태로 처리되며 0이 아닌 것은 비정상입니다. |
15.1.207. .spec.template.spec.initContainers[].startupProbe.grpc
- 설명
- GRPC는 GRPC 포트와 관련된 작업을 지정합니다. 베타 필드이며 GRPCContainerProbe 기능 게이트를 활성화해야 합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| gRPC 서비스의 포트 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 연결할 호스트 이름, 기본값은 Pod IP입니다. 대신 httpHeaders에서 "Host"를 설정할 수 있습니다. |
|
| 요청에 설정할 사용자 지정 헤더입니다. HTTP는 반복된 헤더를 허용합니다. |
|
| HTTPHeader는 HTTP 프로브에 사용할 사용자 정의 헤더를 설명합니다. |
|
| HTTP 서버에서 액세스할 경로입니다. |
| 컨테이너에서 액세스할 포트의 이름 또는 번호입니다. 숫자는 1~65535 범위에 있어야 합니다. name은 IANA_SVC_NAME이어야 합니다. | |
|
| 호스트 연결에 사용할 스키마입니다. 기본값은 HTTP입니다.
가능한 enum 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 헤더 필드 이름입니다. 출력 시 이 작업을 수행할 수 있으므로 대소문자 변경 이름이 동일한 헤더로 인식됩니다. |
|
| 헤더 필드 값 |
15.1.211. .spec.template.spec.initContainers[].startupProbe.tcpSocket
- 설명
- TCPSocketAction은 소켓 열기를 기반으로 하는 작업을 설명합니다.
- 유형
-
object
- 필수 항목
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 연결할 호스트 이름, 기본값은 Pod IP입니다. |
| 컨테이너에서 액세스할 포트의 번호 또는 이름입니다. 숫자는 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는 장치를 매핑할 컨테이너 내부의 경로입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨을 마운트해야 하는 컨테이너 내 경로입니다. ':'를 포함하지 않아야 합니다. |
|
| mountPropagation은 호스트에서 컨테이너로 마운트하는 방법 및 기타 방법을 결정합니다. 설정하지 않으면 MountPropagationNone이 사용됩니다. 이 필드는 1.10의 베타입니다. |
|
| 이는 볼륨 이름과 일치해야 합니다. |
|
| true인 경우 읽기 전용 마운트, 그렇지 않으면 읽기-쓰기(false 또는 지정되지 않음)입니다. 기본값은 false입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내 경로입니다. 기본값은 ""(볼륨의 루트)입니다. |
|
| 컨테이너 볼륨을 마운트해야 하는 볼륨 내의 확장된 경로입니다. SubPath와 유사하게 작동하지만 컨테이너 환경을 사용하여 환경 변수 $(VAR_NAME)이 확장됩니다. 기본값은 ""(볼륨의 루트)입니다. SubPathExpr 및 SubPath는 함께 사용할 수 없습니다. |
15.1.216. .spec.template.spec.os
- 설명
- PodOS는 Pod의 OS 매개변수를 정의합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 운영 체제의 이름입니다.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은 일치하는 유형이 있는 Pod의 조건 목록의 조건을 나타냅니다. |
15.1.219. .spec.template.spec.securityContext
- 설명
- PodSecurityContext에는 Pod 수준 보안 속성 및 일반적인 컨테이너 설정이 있습니다. 일부 필드는 container.securityContext에도 있습니다. container.securityContext의 필드 값이 PodSecurityContext의 필드 값보다 우선합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod의 모든 컨테이너에 적용되는 특수 추가 그룹입니다. 일부 볼륨 유형을 사용하면 Kubelet에서 해당 볼륨의 소유권을 Pod에서 소유하도록 변경할 수 있습니다. 1. GID를 소유하는 것은 FSGroup 2가 됩니다. setgid 비트가 설정되어 있습니다(볼륨에서 생성된 새 파일은 FSGroup에 의해 소유됨) 3. 권한 비트는 rw-rw----를 사용하여 또는d입니다. 설정되지 않은 경우 Kubelet은 볼륨의 소유권 및 권한을 수정하지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| fsGroupChangePolicy는 Pod 내부에서 노출되기 전에 볼륨의 소유권 및 권한 변경 동작을 정의합니다. 이 필드는 fsGroup 기반 소유권 및 권한을 지원하는 볼륨 유형에만 적용됩니다. secret, configmaps 및 emptydir과 같은 임시 볼륨 유형에는 영향을 미치지 않습니다. 유효한 값은 "OnRootMismatch" 및 "Always"입니다. 지정하지 않으면 "항상"이 사용됩니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 GID입니다. 설정되지 않은 경우 런타임 기본값을 사용합니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| 컨테이너를 루트가 아닌 사용자로 실행해야 함을 나타냅니다. true인 경우 Kubelet은 런타임 시 이미지를 검증하여 UID 0(root)으로 실행되지 않고 컨테이너를 시작하는 데 실패합니다. 설정되지 않았거나 false인 경우 이러한 유효성 검사가 수행되지 않습니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 우선합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 UID입니다. 지정되지 않은 경우 기본값은 이미지 메타데이터에 지정된 사용자입니다. SecurityContext에서도 설정할 수 있습니다. SecurityContext 및 PodSecurityContext 둘 다에 설정된 경우 SecurityContext에 지정된 값이 해당 컨테이너에 대해 우선합니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| seLinuxOptions는 컨테이너에 적용할 레이블입니다. |
|
| seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다. |
|
| 컨테이너의 기본 GID 외에도 각 컨테이너에서 첫 번째 프로세스에 적용되는 그룹 목록입니다. 지정되지 않은 경우 컨테이너에 그룹이 추가되지 않습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| sysctl에는 Pod에 사용되는 네임스페이스가 지정된 sysctl 목록이 있습니다. 지원되지 않는 sysctl이 있는 Pod(컨테이너 런타임별)가 시작되지 않을 수 있습니다. spec.os.name이 windows인 경우 이 필드를 설정할 수 없습니다. |
|
| sysctl은 설정할 커널 매개변수를 정의합니다. |
|
| WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다. |
15.1.220. .spec.template.spec.securityContext.seLinuxOptions
- 설명
- seLinuxOptions는 컨테이너에 적용할 레이블입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| level은 컨테이너에 적용되는 SELinux 수준 레이블입니다. |
|
| role은 컨테이너에 적용되는 SELinux 역할 레이블입니다. |
|
| type은 컨테이너에 적용되는 SELinux 유형 레이블입니다. |
|
| 사용자는 컨테이너에 적용되는 SELinux 사용자 레이블입니다. |
15.1.221. .spec.template.spec.securityContext.seccompProfile
- 설명
- seccompProfile은 pod/container의 seccomp 프로필 설정을 정의합니다. 프로필 소스는 하나만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| localhostProfile은 노드의 파일에 정의된 프로필을 사용해야 함을 나타냅니다. 작동하려면 노드에 프로필을 사전 구성해야 합니다. kubelet의 구성된 seccomp 프로필 위치와 상대적인 내림차순 경로여야 합니다. type이 "Localhost"인 경우에만 설정해야 합니다. |
|
| type은 적용할 seccomp 프로필의 종류를 나타냅니다. 유효한 옵션은 다음과 같습니다. localhost - 노드의 파일에 정의된 프로필을 사용해야 합니다. RuntimeDefault - 컨테이너 런타임 기본 프로필을 사용해야 합니다. 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 설정할 속성의 이름 |
|
| 설정할 속성의 값 |
15.1.224. .spec.template.spec.securityContext.windowsOptions
- 설명
- WindowsSecurityContextOptions에는 Windows별 옵션 및 인증 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudEventSACredentialSpec은 JWTSA 승인 Webhook(https://github.com/kubernetes-sigs/windows-gmsa)가 CloudEventSACredentialSpecName 필드에 의해 이름이 지정된 CloudEventSA 인증 정보 사양의 내용을 인라인으로 하는 위치입니다.https://github.com/kubernetes-sigs/windows-gmsa |
|
| CloudEventSACredentialSpecName은 사용할 CryostatSA 인증 정보 사양의 이름입니다. |
|
| HostProcess는 컨테이너를 '호스트 프로세스' 컨테이너로 실행해야 하는지를 결정합니다. 이 필드는 알파 수준이며 WindowsHostProcessContainers 기능 플래그를 활성화하는 구성 요소에서만 적용됩니다. 기능 플래그 없이 이 필드를 설정하면 Pod를 검증할 때 오류가 발생합니다. 모든 Pod의 컨테이너는 동일한 유효 HostProcess 값을 보유해야 합니다(HostProcess 컨테이너 및 비 호스트 프로세스 컨테이너를 혼합할 수 없습니다). 또한 HostProcess가 true인 경우 HostNetwork도 true로 설정해야 합니다. |
|
| 컨테이너 프로세스의 진입점을 실행하는 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는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.
가능한 enum 값: - |
|
| 키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다. |
|
| Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.
가능한 열거 값: - |
|
| tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다. |
|
| 값은 허용 오차와 일치하는 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는 일치하는 포드를 찾는 데 사용됩니다. 이 라벨 선택기와 일치하는 Pod는 해당 토폴로지 도메인의 Pod 수를 확인하기 위해 계산됩니다. | |
|
| MatchLabelKeys는 분배를 계산할 Pod를 선택하는 Pod 레이블 키 집합입니다. 키는 들어오는 Pod 라벨에서 값을 조회하는 데 사용되며, 해당 키-값 레이블은 labelSelector와 함께 사용되어 들어오는 포드에 대해 분산이 계산될 기존 포드 그룹을 선택합니다. 들어오는 Pod 라벨에 없는 키는 무시됩니다. null 또는 빈 목록은 labelSelector와만 일치함을 의미합니다. |
|
|
MaxSkew는 Pod를 균등하게 배포할 수 있는 정도를 설명합니다. |
|
| 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는 Pod 토폴로지 분배 skew를 계산할 때 Pod의 nodeAffinity/nodeSelector를 처리하는 방법을 나타냅니다. 옵션은: - Cryostat: nodeAffinity/nodeSelector와 일치하는 노드만 계산에 포함됩니다. - Ignore: nodeAffinity/nodeSelector는 무시됩니다. 모든 노드는 계산에 포함됩니다. 이 값이 nil인 경우 동작은 policy와 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다. |
|
| NodeTaintsPolicy는 Pod 토폴로지 분배 스큐를 계산할 때 노드 테인트를 처리하는 방법을 나타냅니다. 옵션은 다음과 같습니다: 테인트가 없는 노드와 함께 들어오는 Pod에 톨러레이션이 포함된 테인트 노드가 포함됩니다. - Ignore: 노드 테인트는 무시됩니다. 모든 노드가 포함됩니다. 이 값이 nil인 경우 동작은 Ignore 정책과 동일합니다. 이는 NodeInclusionPolicyInPodTopologySpread 기능 플래그에서 활성화한 알파 수준 기능입니다. |
|
| TopologyKey는 노드 라벨의 키입니다. 이 키와 동일한 값이 있는 라벨이 있는 노드는 동일한 토폴로지에 있는 것으로 간주됩니다. 각 <key, value>를 "bucket"으로 간주하고 각 버킷에 균형 있는 Pod 수를 배치하려고 합니다. 도메인을 토폴로지의 특정 인스턴스로 정의합니다. 또한 적격 도메인을 nodeAffinityPolicy 및 nodeTaintsPolicy의 요구 사항을 충족하는 도메인으로 정의합니다. 예를 들어 TopologyKey가 "kubernetes.io/hostname"인 경우 각 노드는 해당 토폴로지의 도메인입니다. 그리고 TopologyKey가 "topology.kubernetes.io/zone"인 경우 각 영역은 해당 토폴로지의 도메인입니다. 필수 필드입니다. |
|
| 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 값: - |
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
-
속성 | 유형 | 설명 |
---|---|---|
|
| AWS의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
|
| AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
|
| Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| ConfigMap을 볼륨에 조정합니다. 대상 ConfigMap의 Data 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. ConfigMap 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| 외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다. |
|
| DownwardAPIVolumeSource는 Downward API 정보가 포함된 볼륨을 나타냅니다. Downward API 볼륨은 소유권 관리 및 SELinux 레이블 재레이블을 지원합니다. |
|
| Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| 일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다. |
|
| 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다. |
|
| Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Google Compute Engine의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| git 리포지토리의 콘텐츠로 채워지는 볼륨을 나타냅니다. Git 리포지토리 볼륨은 소유권 관리를 지원하지 않습니다. Git 리포지터리 볼륨은 SELinux 레이블 재지정을 지원합니다. DEPRECATED: GitRepo는 더 이상 사용되지 않습니다. Git 리포지토리를 사용하여 컨테이너를 프로비저닝하려면 git을 사용하여 리포지터리를 복제하는 EmptyDir을 EmptyContainer에 마운트한 다음 EmptyDir을 Pod의 컨테이너에 마운트합니다. |
|
| Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| 볼륨의 이름입니다. DNS_LABEL이어야 하며 Pod 내에서 고유해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| PersistentVolumeClaimVolumeSource는 동일한 네임스페이스의 사용자 PVC를 참조합니다. 이 볼륨은 바인딩된 PV를 찾아 Pod에 해당 볼륨을 마운트합니다. PersistentVolumeClaimVolumeSource는 기본적으로 다른 사람(시스템)이 소유한 다른 볼륨 유형에 대한 래퍼입니다. |
|
| Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다. |
|
| PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다. |
|
| 예상 볼륨 소스를 나타냅니다. |
|
| Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| scaleIOVolumeSource는 영구 scaleIO 볼륨을 나타냅니다. |
|
| 시크릿을 볼륨에 조정합니다. 대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 볼륨에 파일로 표시됩니다. 시크릿 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| StorageOS 영구 볼륨 리소스를 나타냅니다. |
|
| vSphere 볼륨 리소스를 나타냅니다. |
15.1.231. .spec.template.spec.volumes[].awsElasticBlockStore
- 설명
AWS의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). |
|
| readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| 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는 Host Caching 모드입니다: None, Read Only, Read Write. |
|
| diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다. |
|
| diskURI는 Blob 스토리지의 데이터 디스크 URI입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| 종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다. |
|
| Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
15.1.233. .spec.template.spec.volumes[].azureFile
- 설명
- AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
- 유형
-
object
- 필수 항목
-
secretName
-
shareName
-
속성 | 유형 | 설명 |
---|---|---|
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다. |
|
| 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는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
15.1.235. .spec.template.spec.volumes[].cephfs.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
15.1.237. .spec.template.spec.volumes[].cinder.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 선택 사항: 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
15.1.241. .spec.template.spec.volumes[].csi
- 설명
- 외부 CSI 드라이버에서 관리하는 마운트할 볼륨의 소스 위치를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| driver는 이 볼륨을 처리하는 CSI 드라이버의 이름입니다. 클러스터에 등록된 대로 올바른 이름은 관리자에게 문의하십시오. |
|
| 마운트할 fstype. Ex. "ext4", "xfs", "ntfs". 제공되지 않는 경우 빈 값은 적용할 기본 파일 시스템을 결정하는 연결된 CSI 드라이버에 전달됩니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| readonly는 볼륨에 대한 읽기 전용 구성을 지정합니다. 기본값은 false(읽기/쓰기)입니다. |
|
| volumeAttributes는 CSI 드라이버로 전달되는 드라이버별 속성을 저장합니다. 지원되는 값은 드라이버 설명서를 참조하십시오. |
15.1.242. .spec.template.spec.volumes[].csi.nodePublishSecretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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
속성 | 유형 | 설명 |
---|---|---|
|
| 선택 사항: 기본적으로 생성된 파일에서 사용할 모드 비트입니다. 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 선택 사항: 모드 비트여야 합니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| items는 Downward API 볼륨 파일 목록입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| 선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
15.1.246. .spec.template.spec.volumes[].downwardAPI.items[].fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
15.1.247. .spec.template.spec.volumes[].downwardAPI.items[].resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
15.1.248. .spec.template.spec.volumes[].emptyDir
- 설명
- Pod의 빈 디렉터리를 나타냅니다. 빈 디렉터리 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| medium는 이 디렉터리를 백업해야 하는 스토리지 미디어 유형을 나타냅니다. 기본값은 ""이며 이는 노드의 기본 미디어를 사용하는 것을 의미합니다. 빈 문자열(기본값) 또는 메모리여야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#emptydir |
| sizeLimit은 이 EmptyDir 볼륨에 필요한 총 로컬 스토리지 양입니다. 크기 제한은 메모리 미디어에도 적용할 수 있습니다. 메모리 매체 EmptyDir의 최대 사용량은 여기에 지정된 SizeLimit와 Pod의 모든 컨테이너의 메모리 제한 합계 사이의 최소 값입니다. 기본값은 nil이며 이는 제한이 정의되지 않음을 의미합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/volumes#emptydir |
15.1.249. .spec.template.spec.volumes[].ephemeral
- 설명
- 일반 스토리지 드라이버에서 처리하는 임시 볼륨을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다. |
15.1.250. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate
- 설명
- PersistentVolumeClaimTemplate은 EphemeralVolumeSource의 일부로 PersistentVolumeClaim 오브젝트를 생성하는 데 사용됩니다.
- 유형
-
object
- 필수 항목
-
spec
-
속성 | 유형 | 설명 |
---|---|---|
| 해당 라벨을 생성할 때 PVC에 복사할 레이블 및 주석이 포함될 수 있습니다. 다른 필드는 허용되지 않으며 검증 중에 거부됩니다. | |
|
| PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다. |
15.1.251. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec
- 설명
- PersistentVolumeClaimSpec은 스토리지 장치의 공통 속성을 설명하고 공급자별 속성에 대해 소스를 허용합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessModes에는 볼륨에 필요한 액세스 모드가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1 |
|
| TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다. |
| selector는 바인딩에 대해 고려할 볼륨에 대한 레이블 쿼리입니다. | |
|
| storageClassName은 클레임에 필요한 StorageClass의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1 |
|
| volumeMode는 클레임에 필요한 볼륨 유형을 정의합니다. claim 사양에 포함되지 않은 경우 Filesystem의 값이 포함됩니다. |
|
| volumeName은 이 클레임을 지원하는 PersistentVolume에 대한 바인딩 참조입니다. |
15.1.252. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSource
- 설명
- TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조되는 리소스의 이름입니다. |
15.1.253. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.dataSourceRef
- 설명
- TypedLocalObjectReference에는 동일한 네임 스페이스 내에서 형식화된 참조 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
kind
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| APIGroup은 참조 중인 리소스의 그룹입니다. APIGroup을 지정하지 않으면 지정된Kind이 코어 API 그룹에 있어야 합니다. 다른 타사 유형의 경우 APIGroup이 필요합니다. |
|
| kind는 참조되는 리소스 유형입니다. |
|
| name은 참조되는 리소스의 이름입니다. |
15.1.254. .spec.template.spec.volumes[].ephemeral.volumeClaimTemplate.spec.resources
- 설명
- resourceRequirements는 컴퓨팅 리소스 요구 사항을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ | |
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
15.1.255. .spec.template.spec.volumes[].fc
- 설명
- 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| LUN은 선택 사항입니다. FC 대상 lun 번호 |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN) |
|
| WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다. |
15.1.256. .spec.template.spec.volumes[].flexVolume
- 설명
- FlexVolume은 exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| driver는 이 볼륨에 사용할 드라이버의 이름입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다. |
|
| 옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
15.1.257. .spec.template.spec.volumes[].flexVolume.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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
속성 | 유형 | 설명 |
---|---|---|
|
| DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다. |
|
| 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은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| pdName은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| 여기에서 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
- 필수 항목
-
리포지토리
-
속성 | 유형 | 설명 |
---|---|---|
|
| 디렉터리는 대상 디렉터리 이름입니다. 포함하거나 '..'로 시작하지 않아야 합니다. '.'가 제공되면 볼륨 디렉터리가 git 리포지토리가 됩니다. 지정하지 않으면 볼륨에 지정된 이름이 있는 하위 디렉터리에 git 리포지토리가 포함됩니다. |
|
| 리포지터리는 URL입니다. |
|
| 개정 버전은 지정된 버전의 커밋 해시입니다. |
15.1.261. .spec.template.spec.volumes[].glusterfs
- 설명
- Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
끝점
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| 여기에서 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| 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는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
| initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다. |
|
| IQN은 대상 iSCSI 정규화된 이름입니다. |
|
| iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다. |
|
| LUN은 iSCSI 대상 Lun 번호를 나타냅니다. |
|
| 포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
15.1.264. .spec.template.spec.volumes[].iscsi.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 서버는 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은 이 볼륨을 사용하는 Pod와 동일한 네임스페이스에 있는 PersistentVolumeClaim의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims |
|
| ReadOnly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본 false. |
15.1.267. .spec.template.spec.volumes[].photonPersistentDisk
- 설명
- Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
pdID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다. |
15.1.268. .spec.template.spec.volumes[].portworxVolume
- 설명
- PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. Ex. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| volumeID는 Portworx 볼륨을 고유하게 식별합니다. |
15.1.269. .spec.template.spec.volumes[].projected
- 설명
- 예상 볼륨 소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| defaultMode는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 소스는 볼륨 프로젝션의 목록입니다. |
|
| 다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션 |
15.1.270. .spec.template.spec.volumes[].projected.sources
- 설명
- 소스는 볼륨 프로젝션의 목록입니다.
- 유형
-
array
15.1.271. .spec.template.spec.volumes[].projected.sources[]
- 설명
- 다른 지원되는 볼륨 유형과 함께 예상할 수 있는 프로젝션
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap을 예상 볼륨에 조정합니다. 대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다. |
|
| 예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다. |
|
| 시크릿을 예상 볼륨에 조정합니다. 대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다. |
|
| ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다. |
15.1.272. .spec.template.spec.volumes[].projected.sources[].configMap
- 설명
ConfigMap을 예상 볼륨에 조정합니다.
대상 ConfigMap의 데이터 필드의 내용은 경로에 대한 키의 특정 매핑으로 채워지지 않는 한 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 configmap 볼륨 소스와 동일합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 지정되지 않은 경우 참조된 ConfigMap의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. ConfigMap에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정이 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 선택 사항: 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
15.1.275. .spec.template.spec.volumes[].projected.sources[].downwardAPI
- 설명
- 예상 볼륨에 투사하는 데 필요한 Downward API 정보를 나타냅니다. 이는 기본 모드 없이 DownwardAPI 볼륨 소스와 동일합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| items는 DownwardAPIVolume 파일 목록입니다. |
|
| 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다. |
|
| 선택 사항: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트는 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 필수: path는 생성할 파일의 상대 경로 이름입니다. 절대 경로이거나 '..' 경로를 포함하지 않아야 합니다. utf-8로 인코딩되어야 합니다. 상대 경로의 첫 번째 항목은 '..'로 시작하지 않아야 합니다. |
|
| ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다. |
15.1.278. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[].fieldRef
- 설명
- ObjectFieldSelector는 오브젝트의 APIVersioned 필드를 선택합니다.
- 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
15.1.279. .spec.template.spec.volumes[].projected.sources[].downwardAPI.items[].resourceFieldRef
- 설명
- ResourceFieldSelector는 컨테이너 리소스(cpu, 메모리) 및 해당 출력 형식을 나타냅니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. | |
|
| 필수: 선택할 리소스 |
15.1.280. .spec.template.spec.volumes[].projected.sources[].secret
- 설명
시크릿을 예상 볼륨에 조정합니다.
대상 Secret의 Data 필드의 내용은 Data 필드의 키를 파일 이름으로 사용하여 예상 볼륨에 파일로 표시됩니다. 이는 기본 모드가 없는 보안 볼륨 소스와 동일합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 선택적 필드는 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
15.1.283. .spec.template.spec.volumes[].projected.sources[].serviceAccountToken
- 설명
- ServiceAccountTokenProjection은 예상 서비스 계정 토큰 볼륨을 나타냅니다. 이 프로젝션은 API(Kubernetes API Server 또는 기타)에 사용하기 위해 pod 런타임 파일 시스템에 서비스 계정 토큰을 삽입하는 데 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| audience는 토큰의 의도된 대상입니다. 토큰 수신자는 토큰 대상에 지정된 식별자로 자신을 식별해야 하며, 그렇지 않으면 토큰을 거부해야 합니다. 오디언스는 기본적으로 apiserver의 식별자입니다. |
|
| expirationSeconds는 서비스 계정 토큰의 유효 기간입니다. 토큰이 만료되면 kubelet 볼륨 플러그인은 서비스 계정 토큰을 사전에 순환합니다. 토큰이 수명의 80% 이상을 경과했거나 24시간 이상된 경우 kubelet은 토큰을 순환하기 시작합니다.Defaults는 1시간 이상이며 최소 10분이어야 합니다. |
|
| path는 토큰을 프로젝션할 파일의 마운트 지점을 기준으로 하는 경로입니다. |
15.1.284. .spec.template.spec.volumes[].quobyte
- 설명
- Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
레지스트리
-
volume
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다. |
|
| 여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다. |
|
| registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨) |
|
| 백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다. |
|
| 사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다. |
|
| volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다. |
15.1.285. .spec.template.spec.volumes[].rbd
- 설명
- Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
모니터
-
image
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
| image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 인증 키는 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은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 사용자는 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
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다. |
|
| Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다. |
|
| protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다. |
|
| Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| sslEnabled Flag enable/disable SSL communication with Gateway, default false |
|
| storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다. |
|
| StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다. |
|
| 시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다. |
|
| volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다. |
15.1.288. .spec.template.spec.volumes[].scaleIO.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 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는 기본적으로 생성된 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 기본값은 0644입니다. 경로 내의 디렉터리는 이 설정의 영향을 받지 않습니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| 지정되지 않은 경우 참조된 Secret의 Data 필드에 있는 각 키-값 쌍이 키이고 콘텐츠가 값인 파일로 볼륨에 프로젝션됩니다. 지정하면 나열된 키가 지정된 경로에 프로젝션되고 목록에 없는 키가 존재하지 않습니다. 시크릿에 없는 키가 지정되면 선택 사항으로 표시되지 않는 한 볼륨 설정 오류가 발생합니다. 경로는 상대 경로여야 하며 '..' 경로를 포함하거나 '..'로 시작할 수 없습니다. |
|
| 문자열 키를 볼륨 내 경로에 매핑합니다. |
|
| 선택적 필드는 Secret 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
|
| 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는 프로젝트의 핵심입니다. |
|
| mode는 Optional: 이 파일에 대한 권한을 설정하는 데 사용되는 모드 비트입니다. 0000에서 0777 사이의 8진수 값 또는 0에서 511 사이의 10진수 값이어야 합니다. YAML은 8진수 및 10진수 값을 모두 사용할 수 있습니다. JSON에는 모드 비트의 10진수 값이 필요합니다. 지정하지 않으면 volume defaultMode가 사용됩니다. 이는 fsGroup과 같이 파일 모드에 영향을 미치는 다른 옵션과 충돌할 수 있으며 결과는 다른 모드 비트 세트일 수 있습니다. |
|
| path는 키를 매핑할 파일의 상대 경로입니다. 절대 경로가 아닐 수도 있습니다. 경로 요소 '..'을 포함할 수 없습니다. '..' 문자열로 시작할 수 없습니다. |
15.1.292. .spec.template.spec.volumes[].storageos
- 설명
- StorageOS 영구 볼륨 리소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다. |
|
| volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다. |
|
| volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다. |
15.1.293. .spec.template.spec.volumes[].storageos.secretRef
- 설명
- LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
15.1.294. .spec.template.spec.volumes[].vsphereVolume
- 설명
- vSphere 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumePath
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다. |
|
| storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다. |
|
| volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다. |
15.1.295. .status
- 설명
- ReplicationControllerStatus는 복제 컨트롤러의 현재 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
replicas
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 복제 컨트롤러에 대해 사용 가능한 복제본 수(최소 minReadySeconds) 수입니다. |
|
| 복제 컨트롤러의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| ReplicationControllerCondition은 특정 시점에서 복제 컨트롤러의 상태를 설명합니다. |
|
| 복제 컨트롤러의 Pod 템플릿 레이블과 일치하는 라벨이 있는 Pod 수입니다. |
|
| observedGeneration은 가장 최근에 관찰된 복제 컨트롤러의 생성을 반영합니다. |
|
| 이 복제 컨트롤러에 대해 준비된 복제본 수입니다. |
|
| 복제본은 가장 최근에 모호한 복제본 수입니다. 자세한 내용은 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
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 복제 컨트롤러 조건 유형입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicationController 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
15.2.2. /api/v1/watch/replicationcontrollers
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicationController. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
15.2.3. /api/v1/namespaces/{namespace}/replicationcontrollers
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ReplicationController의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ReplicationController 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ReplicationController 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
15.2.4. /api/v1/watch/namespaces/{namespace}/replicationcontrollers
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicationController. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
15.2.5. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ReplicationController의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ReplicationController 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ReplicationController 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ReplicationController를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ReplicationController를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
15.2.6. /api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ReplicationController의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicationController. deprecated 유형의 개체 변경 사항을 감시합니다. 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링되어 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
15.2.7. /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ReplicationController의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 ReplicationController의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ReplicationController의 상태를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ReplicationController의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
16장. PersistentVolume [v1]
- 설명
- PV(PersistentVolume)는 관리자가 프로비저닝한 스토리지 리소스입니다. 이는 노드와 유사합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes
- 유형
-
object
16.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| PersistentVolumeSpec은 영구 볼륨의 사양입니다. |
|
| PersistentVolumeStatus는 영구 볼륨의 현재 상태입니다. |
16.1.1. .spec
- 설명
- PersistentVolumeSpec은 영구 볼륨의 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessModes에는 볼륨을 마운트할 수 있는 모든 방법이 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes |
|
| AWS의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| AzureDisk는 호스트의 Azure Data Disk 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
|
| AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다. |
| capacity는 영구 볼륨의 리소스 및 용량에 대한 설명입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity | |
|
| Pod Cephfs 볼륨의 수명이 지속되는 Ceph Filesystem 마운트는 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 외부 CSI 볼륨 드라이버(베타 기능)에서 관리하는 스토리지를 나타냅니다. |
|
| 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 영구 볼륨 리소스를 나타냅니다. |
|
| Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다. |
|
| Google Compute Engine의 영구 디스크 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| ISCSIPersistentVolumeSource는 ISCSI 디스크를 나타냅니다. iSCSI 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. ISCSI 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| local은 노드 유사성을 사용하여 직접 연결된 스토리지를 나타냅니다(베타 기능) |
|
| mountOptions는 마운트 옵션 목록입니다(예: ["ro", "soft"]). 검증되지 않음 - 마운트가 유효하지 않은 경우 간단히 실패합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options |
|
| Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| VolumeNodeAffinity는 이 볼륨에 액세스할 수 있는 노드를 제한하는 제약 조건을 정의합니다. |
|
| persistentVolumeReclaimPolicy는 클레임에서 릴리스될 때 영구 볼륨에 어떤 일이 발생하는지 정의합니다. 유효한 옵션은 Retain(수동으로 생성된 PersistentVolumes의 기본값), Delete( dynamically provisioned PersistentVolumes) 및 Recycle(더 이상 사용되지 않음)입니다. 이 PersistentVolume 기본 볼륨 플러그인에서 recycle를 지원해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming
가능한 열거 값: - |
|
| Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다. |
|
| PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다. |
|
| Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다. |
|
| Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다. |
|
| scaleIOPersistentVolumeSource는 영구 scaleIO 볼륨을 나타냅니다. |
|
| storageClassName은 이 영구 볼륨이 속한 StorageClass의 이름입니다. 빈 값은 이 볼륨이 StorageClass에 속하지 않음을 의미합니다. |
|
| StorageOS 영구 볼륨 리소스를 나타냅니다. |
|
| volumeMode는 볼륨이 포맷된 파일 시스템과 함께 사용되는지 또는 원시 블록 상태로 유지되도록 하는지를 정의합니다. spec에 포함되지 않은 경우 Filesystem의 값이 포함됩니다. |
|
| vSphere 볼륨 리소스를 나타냅니다. |
16.1.2. .spec.awsElasticBlockStore
- 설명
AWS의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 AWS EBS 디스크가 있어야 합니다. 디스크도 kubelet과 동일한 AWS 영역에 있어야 합니다. AWS EBS 디스크는 읽기/쓰기로 한 번만 마운트할 수 있습니다. AWS EBS 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). |
|
| readonly value true는 VolumeMounts에서 readOnly 설정을 강제 적용합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore |
|
| 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는 Host Caching 모드입니다: None, Read Only, Read Write. |
|
| diskName은 Blob 스토리지에 있는 데이터 디스크의 이름입니다. |
|
| diskURI는 Blob 스토리지의 데이터 디스크 URI입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| 종류의 예상 값은 공유: 스토리지 계정 전용당 여러 Blob 디스크: 스토리지 계정당 단일 Blob 디스크: Azure 관리 데이터 디스크(관리형 가용성 세트에서만). 기본값은 shared입니다. |
|
| Readonly 기본값은 false(읽기/쓰기)로 설정됩니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
16.1.4. .spec.azureFile
- 설명
- AzureFile은 호스트의 Azure File Service 마운트를 나타내며 Pod에 마운트를 바인딩합니다.
- 유형
-
object
- 필수 항목
-
secretName
-
shareName
-
속성 | 유형 | 설명 |
---|---|---|
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| secretName은 Azure Storage 계정 이름과 키가 포함된 시크릿의 이름입니다. |
|
| secretNamespace는 Azure Storage 계정 이름이 포함된 시크릿의 네임스페이스이며 Key 기본값은 Pod와 동일합니다. |
|
| 공유 이름은 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는 선택 사항입니다. 전체 Ceph 트리가 아닌 마운트된 루트로 사용됩니다. 기본값은 /입니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 자세한 내용은 https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| secretFile은 선택 사항입니다. SecretFile은 사용자의 키 링 경로입니다. 기본값은 /etc/ceph/user.secret 추가 정보: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| 사용자는 선택 사항입니다. 사용자는 rados 사용자 이름이며 기본값은 관리자 추가 정보입니다. https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it |
16.1.6. .spec.cephfs.secretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.7. .spec.cinder
- 설명
- Openstack의 cinder 볼륨 리소스를 나타냅니다. 컨테이너에 마운트하기 전에 Cinder 볼륨이 있어야 합니다. 볼륨도 kubelet과 동일한 리전에 있어야 합니다. Cinder 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| 마운트할 fstype 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| cinder에서 볼륨을 식별하는 데 사용되는 volumeID입니다. More info: https://examples.k8s.io/mysql-cinder-pd/README.md |
16.1.8. .spec.cinder.secretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.9. .spec.claimRef
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
16.1.10. .spec.csi
- 설명
- 외부 CSI 볼륨 드라이버(베타 기능)에서 관리하는 스토리지를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
volumeHandle
-
속성 | 유형 | 설명 |
---|---|---|
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| driver는 이 볼륨에 사용할 드라이버의 이름입니다. 필수 항목입니다. |
|
| 마운트할 fstype. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| ControllerPublishVolumeRequest에 전달할 읽기 전용 값입니다. 기본값은 false(읽기/쓰기)입니다. |
|
| 게시할 볼륨의 volumeAttributes입니다. |
|
| volumeHandle은 모든 후속 호출에서 볼륨을 참조하기 위해 CSI 볼륨 플러그인의 CreateVolume에서 반환한 고유한 볼륨 이름입니다. 필수 항목입니다. |
16.1.11. .spec.csi.controllerExpandSecretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.12. .spec.csi.controllerPublishSecretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.13. .spec.csi.nodeExpandSecretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.14. .spec.csi.nodePublishSecretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.15. .spec.csi.nodeStageSecretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.16. .spec.fc
- 설명
- 파이버 채널 볼륨을 나타냅니다. 파이버 채널 볼륨은 한 번만 읽기/쓰기로 마운트할 수 있습니다. 파이버 채널 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| LUN은 선택 사항입니다. FC 대상 lun 번호 |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| targetWWNs는 선택 사항입니다. FC 대상 전 세계 이름(WWN) |
|
| WWID 선택 사항: FC 볼륨 전체 식별자(wwids) 또는 targetWWN과 lun의 조합을 설정해야 하지만 동시에 둘 다 설정해서는 안 됩니다. |
16.1.17. .spec.flexVolume
- 설명
- exec 기반 플러그인을 사용하여 프로비저닝/연결되는 일반 영구 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
드라이버
-
속성 | 유형 | 설명 |
---|---|---|
|
| driver는 이 볼륨에 사용할 드라이버의 이름입니다. |
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본 파일 시스템은 FlexVolume 스크립트에 따라 다릅니다. |
|
| 옵션은 선택 사항입니다. 이 필드에는 추가 명령 옵션이 있습니다. |
|
| readonly는 선택 사항입니다: 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
16.1.18. .spec.flexVolume.secretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.19. .spec.flocker
- 설명
- Flocker 에이전트가 마운트한 Flocker 볼륨을 나타냅니다. datasetName 및 datasetUUID 중 하나만 설정해야 합니다. flocker 볼륨은 소유권 관리 또는 SELinux 레이블 재레이블을 지원하지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DatasetsName은 메타데이터로 저장된 데이터 집합의 이름 → Flocker의 데이터 세트 이름은 더 이상 사용되지 않는 것으로 간주되어야 합니다. |
|
| datasetUUID는 데이터 세트의 UUID입니다. Flocker 데이터 세트의 고유 식별자입니다. |
16.1.20. .spec.gcePersistentDisk
- 설명
Google Compute Engine의 영구 디스크 리소스를 나타냅니다.
컨테이너에 마운트하기 전에 GCE PD가 있어야 합니다. 디스크도 kubelet과 동일한 GCE 프로젝트 및 영역에 있어야 합니다. GCE PD는 한 번만 읽기/쓰기로 마운트하거나 읽기 전용으로 마운트할 수 있습니다. GCE PD는 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
pdName
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| partition은 마운트하려는 볼륨의 파티션입니다. 생략하면 기본값은 볼륨 이름으로 마운트됩니다. 예: 볼륨 /dev/sda1의 경우 파티션을 "1"로 지정합니다. 마찬가지로 /dev/sda의 볼륨 파티션은 "0"입니다(또는 속성을 비워 둘 수 있음). 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| pdName은 GCE의 PD 리소스의 고유한 이름입니다. GCE에서 디스크를 식별하는 데 사용됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk |
16.1.21. .spec.glusterfs
- 설명
- Pod의 수명을 지속되는 Glusterfs 마운트를 나타냅니다. GlusterFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
끝점
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 엔드포인트는 Glusterfs 토폴로지를 자세히 설명하는 엔드포인트 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| endpointNamespace는 Glusterfs 끝점이 포함된 네임스페이스입니다. 이 필드가 비어 있으면 EndpointNamespace의 기본값은 바인딩된 PVC와 동일한 네임스페이스로 설정됩니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| path는 Glusterfs 볼륨 경로입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
|
| 여기에서 readonly는 읽기 전용 권한으로 Glusterfs 볼륨을 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod |
16.1.22. .spec.hostPath
- 설명
- Pod에 매핑된 호스트 경로를 나타냅니다. 호스트 경로 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| 호스트의 디렉터리 경로입니다. 경로가 심볼릭 링크인 경우 실제 경로의 링크를 따릅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#hostpath |
|
| 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는 iSCSI Discovery CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| chapAuthSession은 iSCSI 세션 CHAP 인증을 지원하는지 여부를 정의합니다. |
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#iscsi |
|
| initiatorname은 사용자 지정 iSCSI 이니시에이터 이름입니다. iscsiInterface를 동시에 사용하여 initiatorName을 지정하면 연결에 사용할 새 iSCSI 인터페이스 <target portal>:<volume name>이 생성됩니다. |
|
| IQN은 대상 iSCSI 정규화된 이름입니다. |
|
| iscsiInterface는 iSCSI 전송을 사용하는 인터페이스 이름입니다. 기본값은 'default'(tcp)입니다. |
|
| LUN은 iSCSI 대상 Lun 번호입니다. |
|
| 포털은 iSCSI 대상 포털 목록입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| targetPortal은 iSCSI 대상 포털입니다. 포트가 기본값 이외의 경우 포털은 IP 또는 ip_addr:port입니다(일반적으로 TCP 포트 860 및 3260). |
16.1.24. .spec.iscsi.secretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.25. .spec.local
- 설명
- local은 노드 유사성을 사용하여 직접 연결된 스토리지를 나타냅니다(베타 기능)
- 유형
-
object
- 필수 항목
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 경로가 블록 장치인 경우에만 적용됩니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 지정되지 않은 경우 파일 시스템을 자동 선택하는 것입니다. |
|
| 노드의 전체 볼륨 경로입니다. 디렉터리 또는 블록 장치(디스크, 파티션, …)일 수 있습니다. |
16.1.26. .spec.nfs
- 설명
- Pod의 수명을 지속되는 NFS 마운트를 나타냅니다. NFS 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
server
-
path
-
속성 | 유형 | 설명 |
---|---|---|
|
| NFS 서버에서 내보낸 경로입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 여기에서 readonly는 읽기 전용 권한으로 NFS 내보내기를 강제로 마운트합니다. 기본값은 false입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
|
| 서버는 NFS 서버의 호스트 이름 또는 IP 주소입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#nfs |
16.1.27. .spec.nodeAffinity
- 설명
- VolumeNodeAffinity는 이 볼륨에 액세스할 수 있는 노드를 제한하는 제약 조건을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다. |
16.1.28. .spec.nodeAffinity.required
- 설명
- 노드 선택기는 노드 세트에 대한 하나 이상의 레이블 쿼리의 결과 결합을 나타냅니다. 즉, 노드 선택기 용어로 표시되는 선택기 중 OR를 나타냅니다.
- 유형
-
object
- 필수 항목
-
nodeSelectorTerms
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 노드 선택기 용어 목록입니다. 용어는 ORed입니다. |
|
| 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
속성 | 유형 | 설명 |
---|---|---|
|
| 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| 노드의 필드별 노드 선택기 요구 사항 목록입니다. |
|
| 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
16.1.31. .spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions
- 설명
- 노드의 라벨에 따른 노드 선택기 요구 사항 목록입니다.
- 유형
-
array
16.1.32. .spec.nodeAffinity.required.nodeSelectorTerms[].matchExpressions[]
- 설명
- 노드 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 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
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택기가 적용되는 라벨 키입니다. |
|
| 값 집합에 대한 키의 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists, DoesNotExist입니다. gt, 및 Lt.
가능한 열거 값: - |
|
| 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 연산자가 Gt 또는 Lt인 경우 값 배열에는 정수로 해석되는 단일 요소가 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
16.1.35. .spec.photonPersistentDisk
- 설명
- Cryostat 컨트롤러 영구 디스크 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
pdID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| pdID는 Cryostat 컨트롤러 영구 디스크를 식별하는 ID입니다. |
16.1.36. .spec.portworxVolume
- 설명
- PortworxVolumeSource는 Portworx 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumeID
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형을 나타내며 호스트 운영 체제에서 지원하는 파일 시스템 유형입니다. Ex. "ext4", "xfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| volumeID는 Portworx 볼륨을 고유하게 식별합니다. |
16.1.37. .spec.quobyte
- 설명
- Pod의 수명을 지속되는 Quobyte 마운트를 나타냅니다. Quobyte 볼륨은 소유권 관리 또는 SELinux 레이블 재지정을 지원하지 않습니다.
- 유형
-
object
- 필수 항목
-
레지스트리
-
volume
-
속성 | 유형 | 설명 |
---|---|---|
|
| 볼륨 액세스를 Default에 매핑하는 그룹은 그룹이 아닙니다. |
|
| 여기에서 readonly는 읽기 전용 권한으로 Quobyte 볼륨을 강제로 마운트합니다. 기본값은 false입니다. |
|
| registry는 볼륨의 중앙 레지스트리 역할을 하는 host:port 쌍으로 지정된 하나 이상의 Quobyte 레지스트리 서비스를 host:port 쌍으로 나타냅니다(여러 항목은 쉼표로 구분됨) |
|
| 백엔드에서 지정된 Quobyte 볼륨을 소유하는 테넌트는 동적으로 프로비저닝된 Quobyte 볼륨과 함께 사용되며 플러그인에 의해 값이 설정됩니다. |
|
| 사용자는 볼륨 액세스를 기본값에 매핑하여 serivceaccount 사용자에게 매핑합니다. |
|
| volume은 이미 생성된 Quobyte 볼륨을 이름으로 참조하는 문자열입니다. |
16.1.38. .spec.rbd
- 설명
- Pod의 수명을 지속되는 Rados Block Device 마운트를 나타냅니다. RBD 볼륨은 소유권 관리 및 SELinux 레이블 재지정을 지원합니다.
- 유형
-
object
- 필수 항목
-
모니터
-
image
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트하려는 볼륨의 파일 시스템 유형입니다. 팁: 파일 시스템 유형이 호스트 운영 체제에서 지원되도록 합니다. 예: "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/volumes#rbd |
|
| image는 rados 이미지 이름입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 인증 키는 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은 rados 풀 이름입니다. 기본값은 rbd입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. 기본값은 false입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| 사용자는 rados 사용자 이름입니다. 기본값은 admin입니다. 자세한 내용은 https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it |
16.1.39. .spec.rbd.secretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.40. .spec.scaleIO
- 설명
- scaleIOPersistentVolumeSource는 영구 scaleIO 볼륨을 나타냅니다.
- 유형
-
object
- 필수 항목
-
gateway
-
system
-
secretRef
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 기본값은 "xfs"입니다. |
|
| Gateway는 scaleIO API 게이트웨이의 호스트 주소입니다. |
|
| protectionDomain은 구성된 스토리지에 대한 scaleIO Protection Domain의 이름입니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다. |
|
| sslEnabled는 게이트웨이와 SSL 통신을 활성화/비활성화하는 플래그이며 기본 false |
|
| storageMode는 볼륨의 스토리지가 ThickProvisioned 또는 ThinProvisioned여야 하는지 여부를 나타냅니다. 기본값은 ThinProvisioned입니다. |
|
| StoragePool은 보호 도메인과 연결된 scaleIO 스토리지 풀입니다. |
|
| 시스템은 scaleIO에 구성된 스토리지 시스템의 이름입니다. |
|
| volumeName은 이 볼륨 소스와 연결된 scaleIO 시스템에서 이미 생성된 볼륨의 이름입니다. |
16.1.41. .spec.scaleIO.secretRef
- 설명
- SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다. |
|
| 네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다. |
16.1.42. .spec.storageos
- 설명
- StorageOS 영구 볼륨 리소스를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. Ex. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| readonly 기본값은 false(읽기/쓰기)입니다. 여기에서 readonly는 VolumeMounts의 ReadOnly 설정을 강제 적용합니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| volumeName은 사람이 읽을 수 있는 StorageOS 볼륨의 이름입니다. 볼륨 이름은 네임스페이스 내에서만 고유합니다. |
|
| volumeNamespace는 StorageOS 내의 볼륨 범위를 지정합니다. 네임스페이스를 지정하지 않으면 Pod의 네임스페이스가 사용됩니다. 이를 통해 더 긴밀한 통합을 위해 Kubernetes 이름 범위를 StorageOS 내에서 미러링할 수 있습니다. 기본 동작을 재정의하려면 VolumeName을 임의의 이름으로 설정합니다. StorageOS 내에서 네임스페이스를 사용하지 않는 경우 "default"로 설정합니다. StorageOS 내에서 사전 존재하지 않는 네임스페이스가 생성됩니다. |
16.1.43. .spec.storageos.secretRef
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names |
|
| 참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/ |
|
| 이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
16.1.44. .spec.vsphereVolume
- 설명
- vSphere 볼륨 리소스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
volumePath
-
속성 | 유형 | 설명 |
---|---|---|
|
| fstype은 마운트할 파일 시스템 유형입니다. 호스트 운영 체제에서 지원하는 파일 시스템 유형이어야 합니다. 예. "ext4", "xfs", "ntfs". 지정되지 않은 경우 암시적으로 "ext4"로 유추됩니다. |
|
| storagePolicyID는 StoragePolicyName과 연결된SPBM(Storage Policy Based Management) 프로필 ID입니다. |
|
| storagePolicyName은 스토리지 정책 기반 관리(SPBM) 프로필 이름입니다. |
|
| volumePath는 vSphere 볼륨 vmdk를 식별하는 경로입니다. |
16.1.45. .status
- 설명
- PersistentVolumeStatus는 영구 볼륨의 현재 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| message는 볼륨이 이 상태에 있는 이유에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| phase는 볼륨을 사용할 수 있는지, 클레임에 바인딩되었는지 또는 클레임에 의해 해제되었는지를 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
가능한 enum 값: - 아직 사용 가능한 볼륨이 아직 바인딩되지 않은 PersistentVolumes에 사용되는 |
|
| 이유는 오류를 설명하는 짧은 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
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- PersistentVolume의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- PersistentVolume 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- PersistentVolume 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
16.2.2. /api/v1/watch/persistentvolumes
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- PersistentVolume. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
16.2.3. /api/v1/persistentvolumes/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolume의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- PersistentVolume 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 PersistentVolume 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PersistentVolume을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PersistentVolume을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
16.2.4. /api/v1/watch/persistentvolumes/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolume의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- PersistentVolume. deprecated 오브젝트의 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
16.2.5. /api/v1/persistentvolumes/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| PersistentVolume의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 PersistentVolume의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 PersistentVolume의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 PersistentVolume의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
17장. ReplicaSet [apps/v1]
- 설명
- ReplicaSet은 지정된 수의 Pod 복제본이 지정된 시간에 실행되도록 합니다.
- 유형
-
object
17.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| ReplicaSet의 라벨이 비어 있으면 ReplicaSet에서 관리하는 Pod와 동일하게 설정됩니다. 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| ReplicaSetSpec은 ReplicaSet의 사양입니다. |
|
| ReplicaSetStatus는 ReplicaSet의 현재 상태를 나타냅니다. |
17.1.1. .spec
- 설명
- ReplicaSetSpec은 ReplicaSet의 사양입니다.
- 유형
-
object
- 필수 항목
-
선택기
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 충돌 없이 새로 생성된 Pod를 준비해야 하는 최소 시간(초)을 사용할 수 있습니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨) |
|
| replicas는 원하는 복제본 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller/#what-is-a-replicationcontroller |
| selector는 복제본 수와 일치해야 하는 Pod의 레이블 쿼리입니다. 이 복제본 세트에서 제어하려면 일치해야 하는 레이블 키와 값입니다. Pod 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
| 템플릿은 충분하지 않은 복제본이 감지되면 생성되는 Pod를 설명하는 오브젝트입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/workloads/controllers/replicationcontroller#pod-template |
17.1.2. .status
- 설명
- ReplicaSetStatus는 ReplicaSet의 현재 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
replicas
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 복제본 세트의 사용 가능한 복제본 수(최소 minReadySeconds) 수입니다. |
|
| 복제본 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| ReplicaSetCondition은 특정 시점에서 복제본 세트의 상태를 설명합니다. |
|
| replicaset의 Pod 템플릿 레이블과 일치하는 라벨이 있는 Pod 수입니다. |
|
| observedGeneration은 가장 최근에 관찰된 ReplicaSet의 생성을 반영합니다. |
|
| readyReplicas는 Ready 상태에서 이 ReplicaSet이 대상으로 하는 Pod 수입니다. |
|
| 복제본은 가장 최근에 모호한 복제본 수입니다. 자세한 내용은 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
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 다른 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 복제본 세트 조건의 유형입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicaSet 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
17.2.2. /apis/apps/v1/watch/replicasets
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicaSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
17.2.3. /apis/apps/v1/namespaces/{namespace}/replicasets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ReplicaSet의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ReplicaSet 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ReplicaSet 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
17.2.4. /apis/apps/v1/watch/namespaces/{namespace}/replicasets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- ReplicaSet 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
17.2.5. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ReplicaSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ReplicaSet 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ReplicaSet 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ReplicaSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ReplicaSet을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
17.2.6. /apis/apps/v1/watch/namespaces/{namespace}/replicasets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ReplicaSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- 더 이상 사용되지 않는 ReplicaSet의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
17.2.7. /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ReplicaSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 ReplicaSet의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ReplicaSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ReplicaSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
18장. StatefulSet [apps/v1]
- 설명
StatefulSet은 일관된 ID가 있는 Pod 세트를 나타냅니다. ID는 다음과 같이 정의됩니다. - 네트워크: 단일 안정적인 DNS 및 호스트 이름. - 스토리지: 요청된 만큼 많은 VolumeClaims입니다.
StatefulSet은 지정된 네트워크 ID가 항상 동일한 스토리지 ID에 매핑되도록 합니다.
- 유형
-
object
18.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| StatefulSetSpec은 StatefulSet의 사양입니다. |
|
| StatefulSetStatus는 StatefulSet의 현재 상태를 나타냅니다. |
18.1.1. .spec
- 설명
- StatefulSetSpec은 StatefulSet의 사양입니다.
- 유형
-
object
- 필수 항목
-
선택기
-
템플릿
-
serviceName
-
속성 | 유형 | 설명 |
---|---|---|
|
| 새로 생성된 Pod를 사용할 수 있는 컨테이너 충돌 없이 준비해야 하는 최소 시간(초)입니다. 기본값은 0입니다 (pod는 준비되는 즉시 사용 가능한 것으로 간주됨) |
|
| StatefulSetPersistentVolumeClaimRetentionPolicy는 StatefulSet VolumeClaimTemplates에서 생성된 PVC에 사용되는 정책을 설명합니다. |
|
|
podManagementPolicy는 초기 확장 중에 포드를 생성하는 방법, 노드에서 Pod를 교체할 때 또는 축소할 때 제어합니다. 기본 정책은
가능한 enum 값: - |
|
| replicas는 지정된 템플릿의 원하는 복제본 수입니다. 이러한 복제본은 동일한 템플릿을 인스턴스화한다는 점에서 복제본이지만 개별 복제본에는 일관된 ID도 있습니다. 지정되지 않은 경우 기본값은 1입니다. |
|
| revisionHistoryLimit은 StatefulSet의 버전 기록에서 유지 관리할 최대 버전 수입니다. 개정 내역은 현재 적용된 StatefulSetSpec 버전으로 표시되지 않는 모든 버전으로 구성됩니다. 기본값은 10입니다. |
| selector는 복제본 수와 일치해야 하는 Pod의 레이블 쿼리입니다. Pod 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors | |
|
| ServiceName은 이 StatefulSet을 관리하는 서비스의 이름입니다. 이 서비스는 StatefulSet 앞에 있어야 하며 세트의 네트워크 ID를 담당합니다. Pod는 statefulSet 컨트롤러에서 "pod-specific-string-string"을 관리하는 pod-specific-string.serviceName.default.svc.cluster.local 패턴을 따르는 DNS/호스트를 가져옵니다. |
| 템플릿은 충분하지 않은 복제본이 감지되면 생성되는 Pod를 설명하는 오브젝트입니다. StatefulSet에서 샘플링된 각 pod는 이 템플릿을 수행하지만 StatefulSet의 나머지 부분에서 고유한 ID가 있습니다. | |
|
| StatefulSetUpdateStrategy는 StatefulSet 컨트롤러가 업데이트를 수행하는 데 사용할 전략을 나타냅니다. 지정된 전략에 대한 업데이트를 수행하는 데 필요한 추가 매개변수가 포함되어 있습니다. |
| VolumeClaimTemplates는 Pod가 참조할 수 있는 클레임 목록입니다. StatefulSet 컨트롤러는 Pod의 ID를 유지 관리하는 방식으로 네트워크 ID를 클레임에 매핑합니다. 이 목록의 모든 클레임에는 템플릿의 하나의 컨테이너에 일치하는 (이름별) volumeMount가 하나 이상 있어야 합니다. 이 목록의 클레임은 템플릿의 모든 볼륨보다 우선하며 이름이 같습니다. |
18.1.2. .spec.persistentVolumeClaimRetentionPolicy
- 설명
- StatefulSetPersistentVolumeClaimRetentionPolicy는 StatefulSet VolumeClaimTemplates에서 생성된 PVC에 사용되는 정책을 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
WhenDeleted는 StatefulSet VolumeClaimTemplates를 삭제할 때 StatefulSet VolumeClaimTemplates에서 생성된 PVC에 어떤 일이 발생하는지 지정합니다. |
|
|
WhenScaled StatefulSet VolumeClaimTemplates 상태 저장 설정이 축소될 때 PVC에 발생하는 작업을 지정합니다. |
18.1.3. .spec.updateStrategy
- 설명
- StatefulSetUpdateStrategy는 StatefulSet 컨트롤러가 업데이트를 수행하는 데 사용할 전략을 나타냅니다. 지정된 전략에 대한 업데이트를 수행하는 데 필요한 추가 매개변수가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| RollingUpdateStatefulSetStrategy는 RollingUpdateStatefulSetStrategyType의 매개변수를 전달하는 데 사용됩니다. |
|
| type은 StatefulSetUpdateStrategy 유형을 나타냅니다. 기본값은 RollingUpdate입니다.
가능한 enum 값: - |
18.1.4. .spec.updateStrategy.rollingUpdate
- 설명
- RollingUpdateStatefulSetStrategy는 RollingUpdateStatefulSetStrategyType의 매개변수를 전달하는 데 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| 업데이트 중에 사용할 수 없는 최대 Pod 수입니다. 값은 절대 숫자(예: 5) 또는 원하는 Pod의 백분율(예: 10%)일 수 있습니다. 절대 수는 백분율로 반올림하여 계산됩니다. 이 값은 0이 될 수 없습니다. 기본값은 1입니다. 이 필드는 알파 수준이며 MaxUnavailableStatefulSet 기능을 활성화하는 서버에서만 적용됩니다. 이 필드는 0~Replicas-1 범위의 모든 Pod에 적용됩니다. 즉, 0에서 Replicas-1 사이의 범위에 사용할 수 없는 Pod가 있는 경우 MaxUnavailable으로 계산됩니다. | |
|
| partition은 업데이트를 위해 StatefulSet을 분할해야 하는 ordinal을 나타냅니다. 롤링 업데이트 중에 ordinal Replicas-1에서 Partition으로 모든 Pod가 업데이트됩니다. ordinal Partition-1에서 0으로의 모든 Pod는 변경되지 않은 상태로 유지됩니다. 이 기능은 카나리아 기반 배포를 수행할 수 있는 데 유용합니다. 기본값은 0입니다. |
18.1.5. .status
- 설명
- StatefulSetStatus는 StatefulSet의 현재 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
replicas
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이 statefulset에서 대상으로 하는 사용 가능한 총 Pod 수(최소 minReadySeconds) 수입니다. |
|
| collisionCount는 StatefulSet의 해시 충돌 수입니다. StatefulSet 컨트롤러는 최신 ControllerRevision의 이름을 생성해야 하는 경우 이 필드를 충돌 방지 메커니즘으로 사용합니다. |
|
| 상태 저장 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| StatefulSetCondition은 특정 시점에서 상태 저장 설정 상태를 설명합니다. |
|
| currentReplicas는 currentRevision으로 표시된 StatefulSet 버전에서 StatefulSet 컨트롤러에서 생성한 Pod 수입니다. |
|
| currentRevision은 비어 있지 않은 경우 [0,currentReplicas) 순서로 Pod를 생성하는 데 사용되는 StatefulSet 버전을 나타냅니다. |
|
| observedGeneration은 이 StatefulSet에서 관찰되는 최신 세대입니다. StatefulSet의 생성은 API 서버에서 변경 시 업데이트되는 StatefulSet의 생성에 해당합니다. |
|
| readyReplicas는 Ready Condition을 사용하여 이 StatefulSet에 대해 생성된 Pod 수입니다. |
|
| replicas는 StatefulSet 컨트롤러에서 생성한 Pod 수입니다. |
|
| updateRevision은 비어 있지 않은 경우 [replicas-updatedReplicas,replicas) 순서로 포드를 생성하는 데 사용되는 StatefulSet 버전을 나타냅니다. |
|
| updatedReplicas는 updateRevision으로 표시된 StatefulSet 버전에서 StatefulSet 컨트롤러에서 생성한 Pod 수입니다. |
18.1.6. .status.conditions
- 설명
- 상태 저장 세트의 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
18.1.7. .status.conditions[]
- 설명
- StatefulSetCondition은 특정 시점에서 상태 저장 설정 상태를 설명합니다.
- 유형
-
object
- 필수 항목
-
type
-
status
-
속성 | 유형 | 설명 |
---|---|---|
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. | |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. |
|
| 조건의 마지막 전환 이유는 다음과 같습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| 상태 저장 설정 조건의 유형입니다. |
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
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- StatefulSet 유형의 오브젝트 나열 또는 감시
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.2. /apis/apps/v1/watch/statefulsets
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- StatefulSet. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.3. /apis/apps/v1/namespaces/{namespace}/statefulsets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- StatefulSet의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- StatefulSet 유형의 오브젝트 나열 또는 감시
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- StatefulSet 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
18.2.4. /apis/apps/v1/watch/namespaces/{namespace}/statefulsets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- StatefulSet. deprecated 목록에 대한 개별 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.5. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| StatefulSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- StatefulSet 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| 오브젝트를 삭제하기 전의 기간(초)입니다. 값은 음수가 아닌 정수여야 합니다. 값 0은 즉시 삭제됨을 나타냅니다. 이 값이 nil이면 지정된 유형의 기본 유예 기간이 사용됩니다. 지정하지 않으면 오브젝트당 기본값은 기본값입니다. 0은 즉시 삭제됨을 의미합니다. |
|
| 더 이상 사용되지 않음: PropagationPolicy를 사용하십시오. 이 필드는 1.7에서 더 이상 사용되지 않습니다. 종속 오브젝트를 분리해야 합니다. true/false인 경우 "orphan" 종료자가 오브젝트의 종료자 목록에 추가/제거됩니다. 이 필드 또는 PropagationPolicy는 설정할 수 있지만 둘 다 설정할 수는 없습니다. |
|
| 가비지 컬렉션이 수행되는지 여부 및 방법. 이 필드 또는 OrphanDependents는 설정할 수 있지만 둘 다 설정할 수는 없습니다. 기본 정책은 metadata.finalizers에 설정된 기존 종료자 및 리소스별 기본 정책에 의해 결정됩니다. 허용 가능한 값은 다음과 같습니다. 'Orphan' - 종속 항목을 분리합니다. 'Back place' - 가비지 수집기에서 백그라운드에서 종속 항목을 삭제할 수 있습니다. 'Forefield' - 전경에서 모든 종속 항목을 삭제하는 계단식 정책입니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 StatefulSet 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StatefulSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StatefulSet을 바꿉니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
18.2.6. /apis/apps/v1/watch/namespaces/{namespace}/statefulsets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| StatefulSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| AllowWatchkeygenmarks는 "BOOKMARK" 유형의 감시 이벤트를 요청합니다. 북마크를 구현하지 않는 서버는 이 플래그를 무시하고 북마크는 서버의 재량에 따라 전송됩니다. 클라이언트는 특정 간격으로 북마크가 반환된다고 가정해서는 안되며, 세션 중에 서버가 BOOKMARK 이벤트를 전송한다고 가정할 수도 있습니다. 시계가 아닌 경우 이 필드는 무시됩니다. |
|
| 서버에서 더 많은 결과를 검색할 때 continue 옵션을 설정해야 합니다. 이 값은 서버 정의이므로 클라이언트는 동일한 쿼리 매개변수가 있는 이전 쿼리 결과의 continue 값만 사용할 수 있으며(계속 값 제외) 서버는 인식할 수 없는 계속 값을 거부할 수 있습니다. 지정된 continue 값이 만료(일반적으로 5~15분) 또는 서버의 구성 변경으로 인해 지정된 continue 값이 더 이상 유효하지 않으면 서버는 계속 토큰과 함께 410 ResourceExpired 오류로 응답합니다. 클라이언트에 일관된 목록이 필요한 경우 continue 필드 없이 목록을 다시 시작해야 합니다. 그렇지 않으면 클라이언트는 410 오류와 함께 수신된 토큰을 사용하여 다른 목록 요청을 보낼 수 있으며, 서버는 다음 키에서 시작하여 목록으로 응답할 수 있지만 최신 스냅샷에서 생성된 오브젝트는 첫 번째 목록 요청이 "다음 키" 뒤에 포함된 후 생성, 수정 또는 삭제된 오브젝트입니다. watch가 true인 경우 이 필드는 지원되지 않습니다. 클라이언트는 서버에서 반환한 마지막 resourceVersion 값에서 감시를 시작할 수 있으며 수정 사항을 누락하지 않을 수 있습니다. |
|
| 반환된 오브젝트 목록을 해당 필드로 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
| 라벨을 통해 반환된 오브젝트 목록을 제한하는 선택기입니다. 기본값은 모든 것입니다. |
|
|
제한은 목록 호출에 대해 반환할 최대 응답 수입니다. 더 많은 항목이 있는 경우 서버는 목록 메타데이터의 이 서버는 를 사용할 때 반환된 개체는 제한 없이 단일 목록 호출을 발행하는 것과 동일하며, 첫 번째 요청이 발행된 후 첫 번째 요청이 후속 계속되는 요청에 포함되지 않음을 보장합니다. 이를 일관된 스냅샷이라고 하며 제한을 사용하여 매우 큰 결과의 청크를 수신하는 클라이언트에서 가능한 모든 오브젝트를 확인할 수 있도록 합니다. 청크된 목록 중에 오브젝트가 업데이트되면 첫 번째 목록 결과가 계산될 때 존재하는 오브젝트 버전이 반환됩니다. |
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
|
| resourceVersionMatch는 resourceVersion이 호출 목록에 적용되는 방식을 결정합니다. 자세한 내용은 resourceVersion이 설정된 목록 호출에 대해 resourceVersionMatch를 설정하는 것이 좋습니다. https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 기본값이 설정되지 않음 |
|
| list/watch 호출의 시간 초과입니다. 이렇게 하면 활동 또는 비활성 여부에 관계없이 호출 기간이 제한됩니다. |
|
| 설명된 리소스에 대한 변경 사항을 조사하고 알림 추가, 업데이트 및 제거 스트림으로 반환합니다. resourceVersion을 지정합니다. |
- HTTP 방법
-
GET
- 설명
- StatefulSet. deprecated 개체 변경 사항을 확인합니다. 대신 목록 작업과 함께 'watch' 매개변수를 사용하여 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
18.2.7. /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| StatefulSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 StatefulSet의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 StatefulSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. 이 필드는 적용 요청(application/apply-patch)에 필요하지만 적용되지 않는 패치 유형(JsonPatch, CryostatPatch, strategicMergePatch)의 경우 선택 사항입니다. |
|
|
FieldValidation은 |
|
| 강제 적용 요청을 "적용"합니다. 즉, 사용자는 다른 사용자가 소유한 충돌하는 필드를 다시 수집해야 합니다. 강제 플래그는 적용되지 않은 패치 요청에 대해 설정되지 않아야 합니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 StatefulSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
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.