머신 API
머신 API에 대한 참조 가이드
초록
1장. 머신 API
1.1. ContainerRuntimeConfig [machineconfiguration.openshift.io/v1]
- 설명
- ContainerRuntimeConfig는 사용자 지정 컨테이너 런타임 구성을 설명합니다.
- 유형
-
object
1.2. ControllerConfig [machineconfiguration.openshift.io/v1]
- 설명
- ControllerConfig는 MachineConfigController의 구성을 설명합니다. 현재 이는 TemplateController에서 생성한 MachineConfig 오브젝트를 구동하는 데만 사용됩니다.
- 유형
-
object
1.3. ControlPlaneMachineSet [machine.openshift.io/v1]
- 설명
- ControlPlaneMachineSet을 사용하면 지정된 수의 컨트롤 플레인 시스템 복제본이 언제든지 실행됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.4. KubeletConfig [machineconfiguration.openshift.io/v1]
- 설명
- KubeletConfig는 사용자 지정 Kubelet 구성을 설명합니다.
- 유형
-
object
1.5. MachineConfigPool [machineconfiguration.openshift.io/v1]
- 설명
- MachineConfigPool은 MachineConfigs 풀을 설명합니다.
- 유형
-
object
1.6. MachineConfig [machineconfiguration.openshift.io/v1]
- 설명
- MachineConfig는 머신 구성을 정의합니다.
- 유형
-
object
1.7. MachineHealthCheck [machine.openshift.io/v1beta1]
- 설명
- MachineHealthCheck는 machinehealthchecks API 호환성 수준 2의 스키마입니다. 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)에 대한 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.8. Machine [machine.openshift.io/v1beta1]
- 설명
- 머신은 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 시스템 API 호환성 수준 2의 스키마입니다.
- 유형
-
object
1.9. MachineSet [machine.openshift.io/v1beta1]
- 설명
- MachineSet은 지정된 수의 머신 복제본이 지정된 시간에 실행되도록 합니다. 호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.
- 유형
-
object
2장. ContainerRuntimeConfig [machineconfiguration.openshift.io/v1]
- 설명
- ContainerRuntimeConfig는 사용자 지정 컨테이너 런타임 구성을 설명합니다.
- 유형
-
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 |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| ContainerRuntimeConfigSpec은 원하는 ContainerRuntimeConfig의 상태를 정의합니다. |
|
| ContainerRuntimeConfigStatus는 ContainerRuntimeConfig의 관찰 상태를 정의합니다. |
2.1.1. .spec
- 설명
- ContainerRuntimeConfigSpec은 원하는 ContainerRuntimeConfig의 상태를 정의합니다.
- 유형
-
object
- 필수 항목
-
containerRuntimeConfig
-
속성 | 유형 | 설명 |
---|---|---|
|
| ContainerRuntimeConfiguration은 컨테이너 런타임의 튜닝 가능 항목을 정의합니다. ContainerRuntimeConfiguration의 필드를 업스트림 kubernetes golang 클라이언트에서 직접 읽으므로 해당 값의 유효성 검사는 ContainerRuntimeConfiguration 컨트롤러 외부에 있는 golang 클라이언트에서 직접 처리됩니다. 잘못된 값이 클러스터 노드를 사용할 수 없게 될 수 있으므로 해당 필드에 유효한 값을 사용하는지 확인하십시오. |
|
| 레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다. |
2.1.2. .spec.containerRuntimeConfig
- 설명
- ContainerRuntimeConfiguration은 컨테이너 런타임의 튜닝 가능 항목을 정의합니다. ContainerRuntimeConfiguration의 필드를 업스트림 kubernetes golang 클라이언트에서 직접 읽으므로 해당 값의 유효성 검사는 ContainerRuntimeConfiguration 컨트롤러 외부에 있는 golang 클라이언트에서 직접 처리됩니다. 잘못된 값이 클러스터 노드를 사용할 수 없게 될 수 있으므로 해당 필드에 유효한 값을 사용하는지 확인하십시오.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| defaultRuntime은 기본값으로 사용할 OCI 런타임의 이름입니다. |
|
| loglevel은 설정된 수준에 따라 로그 세부 정보 표시를 지정합니다. 옵션은 fatal, panic, error, warn, info, debug입니다. |
|
| logSizeMax는 컨테이너 로그 파일에 허용되는 최대 크기를 지정합니다. 음수 숫자는 크기 제한이 적용되지 않음을 나타냅니다. 이 값이 양수인 경우 conmon의 읽기 버퍼를 일치/exceed하려면 >= 8192여야 합니다. |
|
| overlaySize는 컨테이너 이미지의 최대 크기를 지정합니다. 이 플래그를 사용하여 컨테이너 이미지 크기에 할당량을 설정할 수 있습니다. |
|
| pidsLimit은 컨테이너에 허용되는 최대 프로세스 수를 지정합니다. |
2.1.3. .spec.machineConfigPoolSelector
- 설명
- 레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
2.1.4. .spec.machineConfigPoolSelector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
2.1.5. .spec.machineConfigPoolSelector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
2.1.6. .status
- 설명
- ContainerRuntimeConfigStatus는 ContainerRuntimeConfig의 관찰 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| ContainerRuntimeConfigCondition은 ContainerRuntimeConfig의 상태를 정의합니다. |
|
| observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다. |
2.1.7. .status.conditions
- 설명
- 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
2.1.8. .status.conditions[]
- 설명
- ContainerRuntimeConfigCondition은 ContainerRuntimeConfig의 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | lastTransitionTime은 현재 상태 개체에 대한 마지막 업데이트 시간입니다. |
|
| message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. |
|
| 이유는 조건의 마지막 전환의 이유입니다. PascalCase 이유 |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| type은 Operator 조정 기능의 상태를 지정합니다. |
2.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs
-
DELETE
: ContainerRuntimeConfig의 컬렉션 삭제 -
GET
: 종류의 ContainerRuntimeConfig의 오브젝트 나열 -
POST
: ContainerRuntimeConfig 생성
-
/apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}
-
DELETE
: ContainerRuntimeConfig 삭제 -
GET
: 지정된 ContainerRuntimeConfig 읽기 -
PATCH
: 지정된 ContainerRuntimeConfig 부분적으로 업데이트 -
PUT
: 지정된 ContainerRuntimeConfig를 교체
-
/apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}/status
-
GET
: 지정된 ContainerRuntimeConfig의 읽기 상태 -
PATCH
: 지정된 ContainerRuntimeConfig의 부분적으로 업데이트 -
PUT
: 지정된 ContainerRuntimeConfig의 상태
-
2.2.1. /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ContainerRuntimeConfig 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- 종류 ContainerRuntimeConfig의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- ContainerRuntimeConfig 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
2.2.2. /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ContainerRuntimeConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ContainerRuntimeConfig 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 ContainerRuntimeConfig 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ContainerRuntimeConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ContainerRuntimeConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
2.2.3. /apis/machineconfiguration.openshift.io/v1/containerruntimeconfigs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ContainerRuntimeConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 ContainerRuntimeConfig의 상태 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ContainerRuntimeConfig의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ContainerRuntimeConfig의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3장. ControllerConfig [machineconfiguration.openshift.io/v1]
- 설명
- ControllerConfig는 MachineConfigController의 구성을 설명합니다. 현재 이는 TemplateController에서 생성한 MachineConfig 오브젝트를 구동하는 데만 사용됩니다.
- 유형
-
object
- 필수 항목
-
spec
-
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 |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| ControllerConfigSpec은 ControllerConfig 리소스의 사양입니다. |
|
| ControllerConfigStatus는 ControllerConfig의 상태입니다. |
3.1.1. .spec
- 설명
- ControllerConfigSpec은 ControllerConfig 리소스의 사양입니다.
- 유형
-
object
- 필수 항목
-
cloudProviderConfig
-
clusterDNSIP
-
이미지
-
ipFamilies
-
kubeAPIServerServingCAData
-
osImageURL
-
baseOSContainerImage
-
releaseImage
-
rootCAData
-
속성 | 유형 | 설명 |
---|---|---|
| `` | additionalTrustBundle은 신뢰할 수 있는 노드 인증서 저장소에 추가할 인증서 번들입니다. |
|
| baseOSContainerImage는 새로운 형식의 운영 체제 업데이트 이미지입니다. https://github.com/openshift/enhancements/pull/1032에서 참조하십시오. |
|
| baseOSExtensionsContainerImage는 새로운 형식 운영 체제 업데이트 이미지와 일치하는 확장 컨테이너입니다. https://github.com/openshift/enhancements/pull/1032에서 참조하십시오. |
| `` | cloudprovider는 클라우드 공급자 CA 데이터를 지정합니다. |
|
| cloudProviderConfig는 지정된 클라우드 공급자의 구성입니다. |
|
| clusterDNSIP는 클러스터 DNS IP 주소입니다. |
| `` | DNS에는 클러스터 dns 세부 정보가 있습니다. |
|
| etcdDiscoveryDomain은 더 이상 사용되지 않으며 Infra.Status.EtcdDiscoveryDomain을 대신 사용하십시오. |
|
| 이미지는 컨트롤러에서 ./templates/ 아래의 템플릿을 렌더링하는 데 사용하는 이미지 맵입니다. |
| `` | 인프라 세부 정보가 있는 인프라 |
|
| ipFamilies는 클러스터 네트워크에서 사용 중인 IP 제품군을 나타냅니다. |
|
| kubeAPIServerServingCAData managed Kubelet to API Server Cert… Rotated automatically |
| `` | 네트워크에 추가 네트워크 관련 정보가 포함되어 있습니다. |
|
| networkType은 클러스터에서 XXX를 사용하는 네트워크 유형을 보유하고 있습니다. 이는 일시적인 것이며 네트워크 관련 서비스를 적절한 방법으로 시작하는 데 더 나은 지원을 제공하기 위해 가능한 한 빨리 삭제됩니다. 클러스터가 가동되고 처음 실행되면 이 변경 사항도 변경하지 않으므로 이러한 변경 시 다시 생성을 허용하지 않습니다. |
|
| osImageURL은 OS 업데이트 페이로드가 포함된 컨테이너 이미지의 위치입니다. 해당 값은 machine-config-osimageurl ConfigMap의 data.osImageURL 필드에서 가져옵니다. |
|
| Platform은 더 이상 사용되지 않으며, 대신 Infra.Status.PlatformStatus.Type을 사용하십시오. |
| `` | proxy에는 노드의 현재 프록시 구성이 있습니다. |
|
| pullSecret은 모든 머신에 설치해야 하는 기본 풀 시크릿입니다. |
|
| releaseImage는 클러스터를 설치할 때 사용되는 이미지입니다. |
|
| rootCAData는 루트 CA 데이터를 지정합니다. |
3.1.2. .spec.pullSecret
- 설명
- pullSecret은 모든 머신에 설치해야 하는 기본 풀 시크릿입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
3.1.3. .status
- 설명
- ControllerConfigStatus는 ControllerConfig의 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| ControllerConfigStatusCondition에는 ControllerConfigStatus에 대한 조건 정보가 포함되어 있습니다. |
|
| observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다. |
3.1.4. .status.conditions
- 설명
- 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
3.1.5. .status.conditions[]
- 설명
- ControllerConfigStatusCondition에는 ControllerConfigStatus에 대한 조건 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
| `` | lastTransitionTime은 현재 상태 개체에 대한 마지막 업데이트 시간입니다. |
|
| message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. |
|
| 이유는 조건의 마지막 전환의 이유입니다. PascalCase 이유 |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| type은 Operator 조정 기능의 상태를 지정합니다. |
3.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machineconfiguration.openshift.io/v1/controllerconfigs
-
DELETE
: ControllerConfig의 컬렉션 삭제 -
GET
: 종류의 ControllerConfig 오브젝트 나열 -
POST
: ControllerConfig 생성
-
/apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}
-
DELETE
: ControllerConfig 삭제 -
GET
: 지정된 ControllerConfig 읽기 -
PATCH
: 지정된 ControllerConfig를 부분적으로 업데이트 -
PUT
: 지정된 ControllerConfig를 교체
-
/apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}/status
-
GET
: 지정된 ControllerConfig의 읽기 상태 -
PATCH
: 지정된 ControllerConfig의 부분적으로 업데이트 -
PUT
: 지정된 ControllerConfig의 상태 교체
-
3.2.1. /apis/machineconfiguration.openshift.io/v1/controllerconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ControllerConfig 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- kind ControllerConfig의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- ControllerConfig 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
3.2.2. /apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ControllerConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ControllerConfig 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 ControllerConfig 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ControllerConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ControllerConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3.2.3. /apis/machineconfiguration.openshift.io/v1/controllerconfigs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ControllerConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 ControllerConfig의 상태 확인
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ControllerConfig의 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ControllerConfig의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4장. ControlPlaneMachineSet [machine.openshift.io/v1]
- 설명
- ControlPlaneMachineSet을 사용하면 지정된 수의 컨트롤 플레인 시스템 복제본이 언제든지 실행됩니다. 호환성 수준 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 |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| ControlPlaneMachineSet은 ControlPlaneMachineSet의 구성을 나타냅니다. |
|
| ControlPlaneMachineSetStatus는 ControlPlaneMachineSet CRD의 상태를 나타냅니다. |
4.1.1. .spec
- 설명
- ControlPlaneMachineSet은 ControlPlaneMachineSet의 구성을 나타냅니다.
- 유형
-
object
- 필수 항목
-
replicas
-
선택기
-
템플릿
-
속성 | 유형 | 설명 |
---|---|---|
|
| 복제본은 이 ControlPlaneMachineSet에서 생성해야 하는 컨트롤 플레인 머신 수를 정의합니다. 이 필드는 변경할 수 없으며 클러스터 설치 후에는 변경할 수 없습니다. ControlPlaneMachineSet은 3개 또는 5개의 노드 컨트롤 플레인, 3 및 5에서만 작동합니다. |
|
| 머신의 라벨 선택기입니다. 이 선택기에서 선택한 기존 머신은 이 ControlPlaneMachineSet의 영향을 받는 머신이 됩니다. 템플릿의 레이블과 일치해야 합니다. 이 필드는 리소스를 생성한 후 변경할 수 없는 것으로 간주됩니다. |
|
| state는 ControlPlaneMachineSet이 Active 또는 Inactive인지 여부를 정의합니다. Inactive인 경우 ControlPlaneMachineSet은 클러스터 내의 머신 상태에 대해 작업을 수행하지 않습니다. Active인 경우 ControlPlaneMachineSet은 머신을 조정하고 필요에 따라 머신을 업데이트합니다. 활성 후에는 ControlPlaneMachineSet을 Inactive로 만들 수 없습니다. 추가 작업을 방지하려면 ControlPlaneMachineSet을 제거하십시오. |
|
| strategy는 ProviderSpec의 변경 사항을 감지하면 ControlPlaneMachineSet이 머신을 업데이트하는 방법을 정의합니다. |
|
| 템플릿은 이 ControlPlaneMachineSet에서 생성할 컨트롤 플레인 머신을 설명합니다. |
4.1.2. .spec.selector
- 설명
- 머신의 라벨 선택기입니다. 이 선택기에서 선택한 기존 머신은 이 ControlPlaneMachineSet의 영향을 받는 머신이 됩니다. 템플릿의 레이블과 일치해야 합니다. 이 필드는 리소스를 생성한 후 변경할 수 없는 것으로 간주됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
4.1.3. .spec.selector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
4.1.4. .spec.selector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
4.1.5. .spec.strategy
- 설명
- strategy는 ProviderSpec의 변경 사항을 감지하면 ControlPlaneMachineSet이 머신을 업데이트하는 방법을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 ControlPlaneMachineSet이 소유한 머신을 업데이트할 때 사용해야 하는 업데이트 전략 유형을 정의합니다. 유효한 값은 "RollingUpdate" 및 "OnDelete"입니다. 현재 기본값은 "RollingUpdate"입니다. |
4.1.6. .spec.template
- 설명
- 템플릿은 이 ControlPlaneMachineSet에서 생성할 컨트롤 플레인 머신을 설명합니다.
- 유형
-
object
- 필수 항목
-
machineType
-
속성 | 유형 | 설명 |
---|---|---|
|
| MachineType은 ControlPlaneMachineSet에서 관리해야 하는 머신 유형을 결정합니다. 현재 유효한 값은 machine_v1beta1_machine_openshift_io입니다. |
|
| OpenShiftMachineV1Beta1Machine은 v1beta1.machine.openshift.io API 그룹에서 머신을 생성하기 위한 템플릿을 정의합니다. |
4.1.7. .spec.template.machines_v1beta1_machine_openshift_io
- 설명
- OpenShiftMachineV1Beta1Machine은 v1beta1.machine.openshift.io API 그룹에서 머신을 생성하기 위한 템플릿을 정의합니다.
- 유형
-
object
- 필수 항목
-
메타데이터
-
spec
-
속성 | 유형 | 설명 |
---|---|---|
|
| FailureDomains는 ControlPlaneMachineSet이 컨트롤 플레인 머신의 균형을 유지해야 하는 실패 도메인 목록(때로 가용성 영역이라고 함)입니다. 이는 템플릿에 지정된 ProviderSpec에 병합됩니다. 이 필드는 배치 정보가 필요하지 않은 플랫폼에서 선택 사항입니다. |
|
| ObjectMeta는 표준 오브젝트 메타데이터입니다. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 레이블은 ControlPlaneMachineSet 선택기와 일치해야 합니다. |
|
| spec에는 원하는 컨트롤 플레인 머신 구성이 포함되어 있습니다. 내부 ProviderSpec에는 컨트롤 플레인 머신을 생성하기 위한 플랫폼별 세부 정보가 포함되어 있습니다. ProviderSe는 플랫폼별 실패 도메인 필드와는 별도로 완료되어야 합니다. FailureDomains 필드를 기반으로 머신이 생성될 때 재정의됩니다. |
4.1.8. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains
- 설명
- FailureDomains는 ControlPlaneMachineSet이 컨트롤 플레인 머신의 균형을 유지해야 하는 실패 도메인 목록(때로 가용성 영역이라고 함)입니다. 이는 템플릿에 지정된 ProviderSpec에 병합됩니다. 이 필드는 배치 정보가 필요하지 않은 플랫폼에서 선택 사항입니다.
- 유형
-
object
- 필수 항목
-
platform
-
속성 | 유형 | 설명 |
---|---|---|
|
| AWS는 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다. |
|
| AWSFailureDomain은 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다. |
|
| Azure는 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다. |
|
| AzureFailureDomain은 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다. |
|
| GCP는 GCP 플랫폼에 대한 장애 도메인 정보를 구성합니다. |
|
| GCPFailureDomain에서 GCP 플랫폼에 대한 장애 도메인 정보 구성 |
|
| 플랫폼은 FailureDomain이 나타내는 플랫폼을 식별합니다. 현재 지원되는 값은 AWS, Azure, GCP입니다. |
4.1.9. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws
- 설명
- AWS는 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다.
- 유형
-
array
4.1.10. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[]
- 설명
- AWSFailureDomain은 AWS 플랫폼에 대한 장애 도메인 정보를 구성합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 배치는 이 인스턴스에 대한 배치 정보를 구성합니다. |
|
| subnet은 이 인스턴스에 사용할 서브넷에 대한 참조입니다. |
4.1.11. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].placement
- 설명
- 배치는 이 인스턴스에 대한 배치 정보를 구성합니다.
- 유형
-
object
- 필수 항목
-
availabilityZone
-
속성 | 유형 | 설명 |
---|---|---|
|
| AvailabilityZone은 인스턴스의 가용성 영역입니다. |
4.1.12. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].subnet
- 설명
- subnet은 이 인스턴스에 사용할 서브넷에 대한 참조입니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| 리소스의 ARN입니다. |
|
| 필터는 리소스를 식별하는 데 사용되는 필터 세트입니다. |
|
| AWSResourceFilter는 AWS 리소스를 식별하는 데 사용되는 필터입니다. |
|
| 리소스의 ID입니다. |
|
| type은 참조가 AWS 리소스를 가져오는 방법을 결정합니다. |
4.1.13. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].subnet.filters
- 설명
- 필터는 리소스를 식별하는 데 사용되는 필터 세트입니다.
- 유형
-
array
4.1.14. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.aws[].subnet.filters[]
- 설명
- AWSResourceFilter는 AWS 리소스를 식별하는 데 사용되는 필터입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필터의 이름입니다. 필터 이름은 대소문자를 구분합니다. |
|
| 값에는 하나 이상의 필터 값이 포함됩니다. 필터 값은 대소문자를 구분합니다. |
4.1.15. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.azure
- 설명
- Azure는 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다.
- 유형
-
array
4.1.16. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.azure[]
- 설명
- AzureFailureDomain은 Azure 플랫폼에 대한 장애 도메인 정보를 구성합니다.
- 유형
-
object
- 필수 항목
-
영역
-
속성 | 유형 | 설명 |
---|---|---|
|
| 가상 머신의 가용성 영역입니다. nil인 경우 가상 시스템을 영역 없음에 배포해야 합니다. |
4.1.17. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.gcp
- 설명
- GCP는 GCP 플랫폼에 대한 장애 도메인 정보를 구성합니다.
- 유형
-
array
4.1.18. .spec.template.machines_v1beta1_machine_openshift_io.failureDomains.gcp[]
- 설명
- GCPFailureDomain에서 GCP 플랫폼에 대한 장애 도메인 정보 구성
- 유형
-
object
- 필수 항목
-
영역
-
속성 | 유형 | 설명 |
---|---|---|
|
| zone은 GCP 머신 공급자가 VM을 생성할 영역입니다. |
4.1.19. .spec.template.machines_v1beta1_machine_openshift_io.metadata
- 설명
- ObjectMeta는 표준 오브젝트 메타데이터입니다. https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 레이블은 ControlPlaneMachineSet 선택기와 일치해야 합니다.
- 유형
-
object
- 필수 항목
-
labels
-
속성 | 유형 | 설명 |
---|---|---|
|
| 주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations |
|
| 개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels. 이 필드에는 값이 'master'인 'machine.openshift.io/cluster-api-machine-role' 레이블과 'machine.openshift.io/cluster-api-machine-type' 라벨이 모두 포함되어야 합니다. 'machine.openshift.io/cluster-api-cluster' 키가 있는 레이블도 포함해야 합니다. |
4.1.20. .spec.template.machines_v1beta1_machine_openshift_io.spec
- 설명
- spec에는 원하는 컨트롤 플레인 머신 구성이 포함되어 있습니다. 내부 ProviderSpec에는 컨트롤 플레인 머신을 생성하기 위한 플랫폼별 세부 정보가 포함되어 있습니다. ProviderSe는 플랫폼별 실패 도메인 필드와는 별도로 완료되어야 합니다. FailureDomains 필드를 기반으로 머신이 생성될 때 재정의됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다. |
|
| ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다. |
|
| providerID는 공급자가 제공하는 머신의 ID입니다. 이 필드는 이 머신에 해당하는 노드 오브젝트에 표시된 공급자 ID와 일치해야 합니다. 이 필드는 cluster-api의 상위 수준 소비자에 필요합니다. 사용 사례는 cluster-api가 공급자인 클러스터 자동 스케일러입니다. 자동 스케일러의 정리 논리는 머신을 노드와 비교하여 Kubernetes 노드로 등록할 수 없는 공급자의 시스템을 찾습니다. 자동 스케일러의 일반 out-of-tree 공급자인 cluster-api를 사용하면 자동 스케일러에 시스템 목록의 공급자 보기를 사용할 수 있어야 합니다. k8s apiserver에서 다른 노드 목록을 쿼리한 다음, 등록되지 않은 시스템을 확인하기 위해 비교가 수행되며 삭제로 표시됩니다. 이 필드는 액추에이터에 의해 설정되며 일반 공급자로서 cluster-api와 상호 작용할 자동 스케일러와 같은 상위 수준 엔티티에서 사용합니다. |
|
| 노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다. |
|
| 추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다. |
|
| 이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다. |
4.1.21. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks
- 설명
- LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다. |
|
| LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다. |
|
| 사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다. |
|
| LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다. |
4.1.22. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preDrain
- 설명
- PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.
- 유형
-
array
4.1.23. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preDrain[]
- 설명
- LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
소유자
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다. |
|
| owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다. |
4.1.24. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preTerminate
- 설명
- 사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.
- 유형
-
array
4.1.25. .spec.template.machines_v1beta1_machine_openshift_io.spec.lifecycleHooks.preTerminate[]
- 설명
- LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
소유자
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다. |
|
| owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다. |
4.1.26. .spec.template.machines_v1beta1_machine_openshift_io.spec.metadata
- 설명
- ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations |
|
| generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency |
|
| 개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels |
|
| 이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces |
|
| 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다. |
|
| OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다. |
4.1.27. .spec.template.machines_v1beta1_machine_openshift_io.spec.metadata.ownerReferences
- 설명
- 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
- 유형
-
array
4.1.28. .spec.template.machines_v1beta1_machine_openshift_io.spec.metadata.ownerReferences[]
- 설명
- OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
- 유형
-
object
- 필수 항목
-
apiVersion
-
kind
-
name
-
uid
-
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다. |
|
| true인 경우 이 참조는 관리 컨트롤러를 가리킵니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| 참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids |
4.1.29. .spec.template.machines_v1beta1_machine_openshift_io.spec.providerSpec
- 설명
- 노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | value는 리소스 구성을 인라인으로 직렬화한 표현입니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전이 지정된 API 유형을 구성 요소와 유사한 상태로 유지하는 것이 좋습니다. |
4.1.30. .spec.template.machines_v1beta1_machine_openshift_io.spec.taints
- 설명
- 추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.
- 유형
-
array
4.1.31. .spec.template.machines_v1beta1_machine_openshift_io.spec.taints[]
- 설명
- 이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.
- 유형
-
object
- 필수 항목
-
effect
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다. |
|
| 필수 항목입니다. 노드에 적용할 taint 키입니다. |
|
| TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다. |
|
| taint 키에 해당하는 taint 값입니다. |
4.1.32. .status
- 설명
- ControlPlaneMachineSetStatus는 ControlPlaneMachineSet CRD의 상태를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 ControlPlaneMachineSet의 현재 상태를 관찰합니다. 알려진 .status.conditions.type은 Available, Degraded, Progressing입니다. |
|
|
condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] |
|
| observedGeneration은 이 ControlPlaneMachineSet에서 관찰되는 가장 최근 세대입니다. 이는 API 서버에서 변경 시 업데이트되는 ControlPlaneMachineSets의 생성에 해당합니다. |
|
| readyReplicas는 준비된 ControlPlaneMachineSet 컨트롤러에서 생성한 컨트롤 플레인 머신 수입니다. 롤링 업데이트가 진행 중인 상태에서 이 값은 원하는 복제본 수보다 클 수 있습니다. |
|
| replicas는 ControlPlaneMachineSet 컨트롤러에서 생성한 컨트롤 플레인 머신 수입니다. 업데이트 작업 중에 이 값은 원하는 복제본 수와 다를 수 있습니다. |
|
| UnavailableReplicas는 ControlPlaneMachineSet이 원하는 용량에 도달하기 전에 여전히 필요한 컨트롤 플레인 머신의 수입니다. 이 값이 0이 아닌 경우 ReadyReplicas 수는 원하는 Replicas보다 적습니다. |
|
| UpdatedReplicas는 원하는 공급자 사양이 있고 준비되는 ControlPlaneMachineSet 컨트롤러에서 생성한 종료되지 않은 컨트롤 플레인 머신의 수입니다. 이 값은 원하는 사양으로 변경 사항이 감지되면 0으로 설정됩니다. 업데이트 전략이 RollingUpdate인 경우 머신 업데이트 프로세스 시작과도 일치합니다. 업데이트 전략이 OnDelete이면 이 값은 사용자가 기존 복제본을 삭제하고 교체가 준비될 때까지 0으로 유지됩니다. |
4.1.33. .status.conditions
- 설명
- 조건은 ControlPlaneMachineSet의 현재 상태를 관찰합니다. 알려진 .status.conditions.type은 Available, Degraded, Progressing입니다.
- 유형
-
array
4.1.34. .status.conditions[]
- 설명
-
condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type []
omitempty" patchStrategy:"merge" patchMergeKey:"type" protobuf:"bytes,1,rep,name=conditions"
// 기타 필드 } - 유형
-
object
- 필수 항목
-
lastTransitionTime
-
message
-
reason
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다. |
|
| message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다. |
|
| observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다. |
|
| 이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다. |
4.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machine.openshift.io/v1/controlplanemachinesets
-
GET
: 종류의 ControlPlaneMachineSet의 오브젝트 나열
-
/apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets
-
DELETE
: ControlPlaneMachineSet의 컬렉션 삭제 -
GET
: 종류의 ControlPlaneMachineSet의 오브젝트 나열 -
POST
: ControlPlaneMachineSet 생성
-
/apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}
-
DELETE
: ControlPlaneMachineSet 삭제 -
GET
: 지정된 ControlPlaneMachineSet 읽기 -
PATCH
: 지정된 ControlPlaneMachineSet을 부분적으로 업데이트 -
PUT
: 지정된 ControlPlaneMachineSet을 교체합니다.
-
/apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/scale
-
GET
: 지정된 ControlPlaneMachineSet의 읽기 스케일링 -
PATCH
: 지정된 ControlPlaneMachineSet의 부분 업데이트 규모 -
PUT
: 지정된 ControlPlaneMachineSet의 스케일링을 교체
-
/apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/status
-
GET
: 지정된 ControlPlaneMachineSet의 읽기 상태 -
PATCH
: 지정된 ControlPlaneMachineSet의 부분 업데이트 상태 -
PUT
: 지정된 ControlPlaneMachineSet의 상태 교체
-
4.2.1. /apis/machine.openshift.io/v1/controlplanemachinesets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- 종류의 ControlPlaneMachineSet의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
4.2.2. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ControlPlaneMachineSet 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- 종류의 ControlPlaneMachineSet의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- ControlPlaneMachineSet 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
4.2.3. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ControlPlaneMachineSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- ControlPlaneMachineSet 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 ControlPlaneMachineSet 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ControlPlaneMachineSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ControlPlaneMachineSet 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4.2.4. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/scale
매개변수 | 유형 | 설명 |
---|---|---|
|
| ControlPlaneMachineSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 ControlPlaneMachineSet의 스케일링
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ControlPlaneMachineSet의 부분적으로 업데이트 스케일링
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ControlPlaneMachineSet의 스케일링 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4.2.5. /apis/machine.openshift.io/v1/namespaces/{namespace}/controlplanemachinesets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ControlPlaneMachineSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 ControlPlaneMachineSet의 읽기 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ControlPlaneMachineSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ControlPlaneMachineSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
5장. KubeletConfig [machineconfiguration.openshift.io/v1]
- 설명
- KubeletConfig는 사용자 지정 Kubelet 구성을 설명합니다.
- 유형
-
object
- 필수 항목
-
spec
-
5.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 | |
|
| KubeletConfigSpec은 원하는 KubeletConfig 상태를 정의합니다. |
|
| KubeletConfigStatus는 KubeletConfig의 관찰 상태를 정의합니다. |
5.1.1. .spec
- 설명
- KubeletConfigSpec은 원하는 KubeletConfig 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 최적의 시스템 예약 |
| `` | kubelet 구성 필드는 kubernetes 업스트림에 정의되어 있습니다. 업스트림 kubernetes의 OpenShift에서 사용하는 버전/커밋에 정의된 유형을 참조하십시오. kubelet 구성 필드는 업스트림에서 직접 가져온 것이므로 해당 값의 검증은 kubelet에 의해 직접 처리됩니다. 이러한 필드의 유효한 값은 relavent kubernetes의 업스트림 버전을 참조하십시오. kubelet 구성 필드의 잘못된 값은 클러스터 노드를 사용할 수 없게 될 수 있습니다. |
|
| loglevel은 Kubelet의 로그 수준을 정의합니다. |
|
| 레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다. |
|
| tlsSecurityProfile은 ingresscontrollers의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값은 apiservers.config.openshift.io/cluster 리소스를 기반으로 합니다. Old, Intermediate 및 Modern 프로파일 유형을 사용하는 경우 유효한 프로파일 구성은 릴리스마다 변경될 수 있습니다. 예를 들어 릴리스 X.Y.Z에 배포된 Intermediate 프로파일을 사용하기 위한 사양이 있는 경우 릴리스 X.Y.Z+1로 업그레이드하면 새 프로필 구성이 Ingress 컨트롤러에 적용되어 롤아웃이 발생할 수 있습니다. Ingress 컨트롤러의 최소 TLS 버전은 1.1이며 최대 TLS 버전은 1.2입니다. 이 제한 사항은 TLS 1.3이 필요하므로 Modern TLS 프로필 유형을 사용할 수 없다는 것입니다. |
5.1.2. .spec.machineConfigPoolSelector
- 설명
- 레이블 선택기는 리소스 집합에 대한 레이블 쿼리입니다. matchLabels 및 matchExpressions의 결과는 ANDed입니다. 빈 라벨 선택기는 모든 오브젝트와 일치합니다. null 라벨 선택기는 오브젝트와 일치하지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
5.1.3. .spec.machineConfigPoolSelector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
5.1.4. .spec.machineConfigPoolSelector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
5.1.5. .spec.tlsSecurityProfile
- 설명
- tlsSecurityProfile은 ingresscontrollers의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값은 apiservers.config.openshift.io/cluster 리소스를 기반으로 합니다. Old, Intermediate 및 Modern 프로파일 유형을 사용하는 경우 유효한 프로파일 구성은 릴리스마다 변경될 수 있습니다. 예를 들어 릴리스 X.Y.Z에 배포된 Intermediate 프로파일을 사용하기 위한 사양이 있는 경우 릴리스 X.Y.Z+1로 업그레이드하면 새 프로필 구성이 Ingress 컨트롤러에 적용되어 롤아웃이 발생할 수 있습니다. Ingress 컨트롤러의 최소 TLS 버전은 1.1이며 최대 TLS 버전은 1.2입니다. 이 제한 사항은 TLS 1.3이 필요하므로 Modern TLS 프로필 유형을 사용할 수 없다는 것입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | Custom은 사용자 정의 TLS 보안 프로필입니다. 잘못된 구성으로 사용자 지정 프로필을 사용하는 것은 치명적일 수 있습니다. 사용자 정의 프로파일의 예는 다음과 같습니다: - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 minTLSVersion: TLSv1.1 |
| `` | Intermediate는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28recommended.29 및 looks like this (yaml): 암호화: - TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 - TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 minTLSVersion: TLSv1.2 |
| `` | modern는 https://wiki.mozilla.org/Security/Server_Side_TLS#Modern_compatibility 기반 TLS 보안 프로필입니다. (yaml): 암호화: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_POLY1305_POLY1305_SHA256 minTLSVersion: TLSv1.3 참고: 현재 지원되지 않습니다. |
| `` | Old는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility 및 looks like this (yaml): 암호화: - TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 - TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 - TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 - tls_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 - TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256_WITH_AES_128_CBC_WITH_AES_128_CBC_SHA256_WITH_AES_128_CBC_ECDSA_WITH_AES_128_CBC_SHA256_WITH_AES_128_SHA256_WITH - TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA - TLS_ECDHE_ECDSA_WITH_AES_256_SHA - TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA - TLS_RSA_WITH_AES_128_GCM_SHA256 - TLS_RSA_WITH_RSA_WITH_AES_256_GCM_SHA384 - TLS_RSA_WITH_AES_128_CBC_SHA - TLS_RSA_WITH_AES_128_CBC_SHA - TLS_RSA_WITH_AES_256_CBC_SHA - TLS_RSA_WITH_3DES_EDE_CBC_SHA minTLSVersion: TLSv1.0 |
|
| type은 Old, Intermediate, Modern 또는 Custom 중 하나입니다. Custom은 개별 TLS 보안 프로파일 매개변수를 지정하는 기능을 제공합니다. 이전, Intermediate 및 Modern는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations 프로필은 의도 기반이므로 새 암호가 개발되고 기존 암호가 안전하지 않은 것으로 확인되면 시간이 지남에 따라 변경될 수 있습니다. 프로세스에서 사용할 수 있는 암호에 따라 목록이 줄어들 수 있습니다. Modern 프로파일은 아직 공통 소프트웨어 라이브러리에서 잘 채택되지 않았기 때문에 현재 지원되지 않습니다. |
5.1.6. .status
- 설명
- KubeletConfigStatus는 KubeletConfig의 관찰 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| KubeletConfigCondition은 KubeletConfig의 상태를 정의합니다. |
|
| observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다. |
5.1.7. .status.conditions
- 설명
- 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
5.1.8. .status.conditions[]
- 설명
- KubeletConfigCondition은 KubeletConfig의 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | lastTransitionTime은 현재 상태 개체에 대한 마지막 업데이트 시간입니다. |
|
| message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. |
|
| 이유는 조건의 마지막 전환의 이유입니다. PascalCase 이유 |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| type은 Operator 조정 기능의 상태를 지정합니다. |
5.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machineconfiguration.openshift.io/v1/kubeletconfigs
-
DELETE
: KubeletConfig의 컬렉션 삭제 -
GET
: kind KubeletConfig의 오브젝트 나열 -
POST
: KubeletConfig 생성
-
/apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}
-
DELETE
: KubeletConfig 삭제 -
GET
: 지정된 KubeletConfig 읽기 -
PATCH
: 지정된 KubeletConfig를 부분적으로 업데이트 -
PUT
: 지정된 KubeletConfig를 교체
-
/apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}/status
-
GET
: 지정된 KubeletConfig의 읽기 상태 -
PATCH
: 지정된 KubeletConfig의 부분 업데이트 상태 -
PUT
: 지정된 KubeletConfig의 상태
-
5.2.1. /apis/machineconfiguration.openshift.io/v1/kubeletconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- KubeletConfig 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- kind KubeletConfig의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- KubeletConfig 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
5.2.2. /apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| KubeletConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- KubeletConfig 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 KubeletConfig 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 KubeletConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 KubeletConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
5.2.3. /apis/machineconfiguration.openshift.io/v1/kubeletconfigs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| KubeletConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 KubeletConfig의 읽기 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 KubeletConfig의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 KubeletConfig의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6장. MachineConfigPool [machineconfiguration.openshift.io/v1]
- 설명
- MachineConfigPool은 MachineConfigs 풀을 설명합니다.
- 유형
-
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 | |
|
| MachineConfigPoolSpec은 MachineConfigPool 리소스의 사양입니다. |
|
| MachineConfigPoolStatus는 MachineConfigPool 리소스의 상태입니다. |
6.1.1. .spec
- 설명
- MachineConfigPoolSpec은 MachineConfigPool 리소스의 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 머신 구성 풀의 대상 MachineConfig 오브젝트입니다. |
|
| machineConfigSelector는 MachineConfig에 대한 라벨 선택기를 지정합니다. 레이블 및 선택기 작동 방법에 대한 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ 를 참조하십시오. |
|
| maxUnavailable은 해당 풀에서 정수 수 또는 백분율로, 업데이트 중에 사용할 수 없음으로 이동할 수 있는 노드를 정의합니다. 여기에는 사용자 시작 코드, 실패한 노드 등을 포함하여 어떠한 이유로든 사용할 수 없는 노드가 포함됩니다. 기본값은 1입니다. 1보다 큰 값은 업데이트 중에 사용할 수 없는 여러 노드를 의미하며, 이는 나머지 노드에서 워크로드 부하에 영향을 미칠 수 있습니다. 업데이트를 중지하려면 이 값을 0으로 설정할 수 없습니다(기본값은 1); 업데이트를 중지하려면 대신 '중지됨' 속성을 사용합니다. drain은 maxUnavailable이 하나 이상인 경우에도 etcd 쿼럼 가드와 같은 PDB (Pod Disruption Budgets)를 준수합니다. |
|
| nodeSelector는 머신의 라벨 선택기를 지정합니다. |
|
| paused는 이 머신 구성 풀의 변경 사항을 중지해야 하는지 여부를 지정합니다. 여기에는 새로운 원하는MachineConfig 생성 및 머신 업데이트가 포함됩니다. |
6.1.2. .spec.configuration
- 설명
- 머신 구성 풀의 대상 MachineConfig 오브젝트입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
|
|
source는 |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
6.1.3. .spec.configuration.source
- 설명
-
source는
콘텐츠에
지정된 단일 MachineConfig 오브젝트를 생성하는 데 사용된 MachineConfig 오브젝트 목록입니다. - 유형
-
array
6.1.4. .spec.configuration.source[]
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
6.1.5. .spec.machineConfigSelector
- 설명
- machineConfigSelector는 MachineConfig에 대한 라벨 선택기를 지정합니다. 레이블 및 선택기 작동 방법에 대한 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/ 를 참조하십시오.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
6.1.6. .spec.machineConfigSelector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
6.1.7. .spec.machineConfigSelector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
6.1.8. .spec.nodeSelector
- 설명
- nodeSelector는 머신의 라벨 선택기를 지정합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
6.1.9. .spec.nodeSelector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
6.1.10. .spec.nodeSelector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
6.1.11. .status
- 설명
- MachineConfigPoolStatus는 MachineConfigPool 리소스의 상태입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다. |
|
| MachineConfigPoolCondition에는 MachineConfigPool에 대한 조건 정보가 포함되어 있습니다. |
|
| 구성은 머신 구성 풀의 현재 MachineConfig 오브젝트를 나타냅니다. |
|
| degradedMachineCount는 성능이 저하된 머신의 총 수를 나타냅니다(또는 호환되지 않음). 구성을 적용하는 데 실패한 경우 노드가 성능이 저하된 것으로 표시됩니다. |
|
| MACHINECOUNT는 머신 구성 풀의 총 머신 수를 나타냅니다. |
|
| observedGeneration은 컨트롤러에서 관찰하는 생성을 나타냅니다. |
|
| readyMachineCount는 풀을 대상으로 하는 준비된 총 머신 수를 나타냅니다. |
|
| unavailableMachineCount는 풀에서 대상으로 하는 사용 불가능한 (준비되지 않은) 머신의 총 수를 나타냅니다. 상태가 업데이트되었거나 NodeReady 조건이 false인 경우 노드를 사용할 수 없음으로 표시됩니다. |
|
| UPDATEDMACHINECOUNT는 Pool에서 대상으로 하는 총 머신 수를 나타내는 CurrentMachineConfig를 해당 구성으로 설정합니다. |
6.1.12. .status.conditions
- 설명
- 조건은 현재 상태에 대한 사용 가능한 최신 관찰을 나타냅니다.
- 유형
-
array
6.1.13. .status.conditions[]
- 설명
- MachineConfigPoolCondition에는 MachineConfigPool에 대한 조건 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | lastTransitionTime은 이 조건의 마지막 상태 변경에 해당하는 타임스탬프입니다. |
|
| message는 마지막 전환에 대한 세부 정보에 대해 사람이 읽을 수 있는 설명으로, 이유를 보완합니다. |
|
| 이유는 조건의 마지막 전환에 대한 간단한 머신에서 읽을 수 있는 설명입니다. |
|
| 조건의 상태, ('True', 'False', '알 수 없음') 중 하나입니다. |
|
| 조건의 유형 (''Done', 'Updating', 'Failed') |
6.1.14. .status.configuration
- 설명
- 구성은 머신 구성 풀의 현재 MachineConfig 오브젝트를 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
|
|
source는 |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids |
6.1.15. .status.configuration.source
- 설명
-
source는
콘텐츠에
지정된 단일 MachineConfig 오브젝트를 생성하는 데 사용된 MachineConfig 오브젝트 목록입니다. - 유형
-
array
6.1.16. .status.configuration.source[]
- 설명
- ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
6.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machineconfiguration.openshift.io/v1/machineconfigpools
-
DELETE
: MachineConfigPool의 컬렉션 삭제 -
GET
: 종류 MachineConfigPool의 오브젝트 나열 -
POST
: MachineConfigPool 생성
-
/apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}
-
DELETE
: MachineConfigPool 삭제 -
GET
: 지정된 MachineConfigPool 읽기 -
PATCH
: 지정된 MachineConfigPool을 부분적으로 업데이트 -
PUT
: 지정된 MachineConfigPool을 교체합니다.
-
/apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}/status
-
GET
: 지정된 MachineConfigPool의 읽기 상태 -
PATCH
: 지정된 MachineConfigPool의 부분 업데이트 상태 -
PUT
: 지정된 MachineConfigPool의 상태
-
6.2.1. /apis/machineconfiguration.openshift.io/v1/machineconfigpools
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineConfigPool 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- 종류 MachineConfigPool의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- MachineConfigPool을 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
6.2.2. /apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineConfigPool의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineConfigPool 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 MachineConfigPool 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineConfigPool을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineConfigPool을 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6.2.3. /apis/machineconfiguration.openshift.io/v1/machineconfigpools/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineConfigPool의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 MachineConfigPool의 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineConfigPool의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineConfigPool의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7장. MachineConfig [machineconfiguration.openshift.io/v1]
- 설명
- MachineConfig는 머신 구성을 정의합니다.
- 유형
-
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 | |
|
| MachineConfigSpec은 MachineConfig의 사양입니다. |
7.1.1. .spec
- 설명
- MachineConfigSpec은 MachineConfig의 사양입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| baseOSExtensionsContainerImage는 new-format OS 이미지와 일치하는 extensions 컨테이너를 가져오는 데 사용할 원격 위치를 지정합니다. |
| `` | config는 Ignition Config 오브젝트입니다. |
| `` | 호스트에서 활성화할 수 있는 추가 기능 목록 |
|
| FIPS에서 FIPS 모드를 제어 |
| `` | KernelArguments에는 추가할 커널 인수 목록이 포함되어 있습니다. |
|
| 기본(기존), 실시간처럼 실행하려는 커널을 포함합니다. |
|
| OSImageURL은 OS를 가져오는 데 사용할 원격 위치를 지정합니다. |
7.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machineconfiguration.openshift.io/v1/machineconfigs
-
DELETE
: MachineConfig의 컬렉션 삭제 -
GET
: 종류 MachineConfig의 오브젝트 나열 -
POST
: MachineConfig 생성
-
/apis/machineconfiguration.openshift.io/v1/machineconfigs/{name}
-
DELETE
: MachineConfig 삭제 -
GET
: 지정된 MachineConfig 읽기 -
PATCH
: 지정된 MachineConfig를 부분적으로 업데이트 -
PUT
: 지정된 MachineConfig를 교체
-
7.2.1. /apis/machineconfiguration.openshift.io/v1/machineconfigs
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineConfig 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- 종류 MachineConfig의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- MachineConfig 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
7.2.2. /apis/machineconfiguration.openshift.io/v1/machineconfigs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineConfig의 이름 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineConfig 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 MachineConfig 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineConfig를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineConfig를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8장. MachineHealthCheck [machine.openshift.io/v1beta1]
- 설명
- MachineHealthCheck는 machinehealthchecks API 호환성 수준 2의 스키마입니다. 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)에 대한 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
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 | |
|
| 머신 상태 점검 정책 사양 |
|
| 최근 MachineHealthCheck 리소스의 상태 |
8.1.1. .spec
- 설명
- 머신 상태 점검 정책 사양
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| "selector"에서 선택한 대부분의 "MaxUnhealthy" 머신이 정상이 아닌 경우에만 훨씬 더 많은 업데이트가 허용됩니다. postive 정수 값 또는 백분율 값이 필요합니다. 백분율 값은 양의 정수여야 하며 100%로 제한되어야 합니다. 0과 0%는 모두 유효하며 모든 수정을 차단합니다. |
|
| 노드가 없는 이 기간보다 오래된 머신은 실패한 것으로 간주되며 수정됩니다. 노드가 없는 머신이 제거되지 않도록 하려면 이 값을 명시적으로 "0"으로 설정하여 시작 검사를 비활성화합니다. 각각 선택적 분수와 단위 접미사(예: "300ms", "1.5h" 또는 "2h45m"가 있는 10진수의 부호 없는 기간 문자열이 필요합니다. 유효한 시간 단위는 "ns", "us"(또는 "us"), "ms", "s", "m", "h"입니다. |
|
| RemediationTemplate은 인프라 공급자가 제공하는 수정 템플릿에 대한 참조입니다. 이 필드는 완전히 선택 사항으로 채워지면 MachineHealthCheck 컨트롤러는 참조된 템플릿에서 새 오브젝트를 생성하고 머신 API Operator 외부에 있는 컨트롤러로 머신 수정을 종료합니다. |
|
| 상태를 실행할 시스템과 일치하는 라벨 선택기입니다. 참고: 빈 선택기는 모든 시스템과 일치합니다. |
|
| UnhealthyConditions에는 노드가 비정상으로 간주되는지 여부를 결정하는 조건 목록이 포함되어 있습니다. 조건은 논리 OR로 결합됩니다. 즉, 조건이 충족되면 노드가 비정상입니다. |
|
| UnhealthyCondition은 기간으로 지정된 타임아웃이 있는 노드 조건 유형 및 값을 나타냅니다. named 조건이 적어도 타임아웃 값에 대해 지정된 상태에 있는 경우 노드는 비정상으로 간주됩니다. |
8.1.2. .spec.remediationTemplate
- 설명
- RemediationTemplate은 인프라 공급자가 제공하는 수정 템플릿에 대한 참조입니다. 이 필드는 완전히 선택 사항으로 채워지면 MachineHealthCheck 컨트롤러는 참조된 템플릿에서 새 오브젝트를 생성하고 머신 API Operator 외부에 있는 컨트롤러로 머신 수정을 종료합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
8.1.3. .spec.selector
- 설명
- 상태를 실행할 시스템과 일치하는 라벨 선택기입니다. 참고: 빈 선택기는 모든 시스템과 일치합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
8.1.4. .spec.selector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
8.1.5. .spec.selector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
8.1.6. .spec.unhealthyConditions
- 설명
- UnhealthyConditions에는 노드가 비정상으로 간주되는지 여부를 결정하는 조건 목록이 포함되어 있습니다. 조건은 논리 OR로 결합됩니다. 즉, 조건이 충족되면 노드가 비정상입니다.
- 유형
-
array
8.1.7. .spec.unhealthyConditions[]
- 설명
- UnhealthyCondition은 기간으로 지정된 타임아웃이 있는 노드 조건 유형 및 값을 나타냅니다. named 조건이 적어도 타임아웃 값에 대해 지정된 상태에 있는 경우 노드는 비정상으로 간주됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| |
|
| 각각 선택적 분수와 단위 접미사(예: "300ms", "1.5h" 또는 "2h45m"가 있는 10진수의 부호 없는 기간 문자열이 필요합니다. 유효한 시간 단위는 "ns", "us"(또는 "us"), "ms", "s", "m", "h"입니다. |
|
|
8.1.8. .status
- 설명
- 최근 MachineHealthCheck 리소스의 상태
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| conditions는 MachineHealthCheck의 현재 상태를 정의합니다. |
|
| Condition은 Machine API 리소스 작동 상태를 관찰합니다. |
|
| 이 머신 상태 점검에서 계산한 총 머신 수 |
|
| 이 머신 상태 점검에서 계산한 총 머신 수 |
|
| RemediationsAllowed는 maxUnhealthy 단축 회로를 적용하기 전에 이 머신 상태 점검에서 허용하는 추가 수정 횟수입니다. |
8.1.9. .status.conditions
- 설명
- conditions는 MachineHealthCheck의 현재 상태를 정의합니다.
- 유형
-
array
8.1.10. .status.conditions[]
- 설명
- Condition은 Machine API 리소스 작동 상태를 관찰합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다. |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 이 필드는 비어 있을 수 있습니다. |
|
| CamelCase에서 조건의 마지막 전환 이유는 다음과 같습니다. 특정 API는 이 필드가 보장된 API로 간주되는지 여부를 선택할 수 있습니다. 이 필드는 비어 있지 않을 수 있습니다. |
|
| 심각도는 이유 코드에 대한 명시적 분류를 제공하므로 사용자 또는 머신이 현재 상황을 즉시 이해하고 그에 따라 조치를 취할 수 있습니다. 심각도 필드는 Status=False인 경우에만 설정해야 합니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다. 많은 .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. |
8.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machine.openshift.io/v1beta1/machinehealthchecks
-
GET
: MachineHealthCheck 유형의 오브젝트 나열
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks
-
DELETE
: MachineHealthCheck의 컬렉션 삭제 -
GET
: MachineHealthCheck 유형의 오브젝트 나열 -
POST
: MachineHealthCheck 생성
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}
-
DELETE
: MachineHealthCheck 삭제 -
GET
: 지정된 MachineHealthCheck 읽기 -
PATCH
: 지정된 MachineHealthCheck를 부분적으로 업데이트 -
PUT
: 지정된 MachineHealthCheck를 교체
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}/status
-
GET
: 지정된 MachineHealthCheck의 읽기 상태 -
PATCH
: 지정된 MachineHealthCheck의 부분적으로 업데이트 상태 -
PUT
: 지정된 MachineHealthCheck의 상태
-
8.2.1. /apis/machine.openshift.io/v1beta1/machinehealthchecks
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- MachineHealthCheck 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
8.2.2. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineHealthCheck 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- MachineHealthCheck 유형의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- MachineHealthCheck 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
8.2.3. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineHealthCheck의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineHealthCheck 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 MachineHealthCheck 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineHealthCheck를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineHealthCheck를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8.2.4. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinehealthchecks/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineHealthCheck의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 MachineHealthCheck의 읽기 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineHealthCheck의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineHealthCheck의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9장. Machine [machine.openshift.io/v1beta1]
- 설명
- 머신은 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 시스템 API 호환성 수준 2의 스키마입니다.
- 유형
-
object
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 |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| MachineSpec은 원하는 머신 상태를 정의합니다. |
|
| MachineStatus는 머신의 관찰 상태를 정의합니다. |
9.1.1. .spec
- 설명
- MachineSpec은 원하는 머신 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다. |
|
| ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다. |
|
| providerID는 공급자가 제공하는 머신의 ID입니다. 이 필드는 이 머신에 해당하는 노드 오브젝트에 표시된 공급자 ID와 일치해야 합니다. 이 필드는 cluster-api의 상위 수준 소비자에 필요합니다. 사용 사례는 cluster-api가 공급자인 클러스터 자동 스케일러입니다. 자동 스케일러의 정리 논리는 머신을 노드와 비교하여 Kubernetes 노드로 등록할 수 없는 공급자의 시스템을 찾습니다. 자동 스케일러의 일반 out-of-tree 공급자인 cluster-api를 사용하면 자동 스케일러에 시스템 목록의 공급자 보기를 사용할 수 있어야 합니다. k8s apiserver에서 다른 노드 목록을 쿼리한 다음, 등록되지 않은 시스템을 확인하기 위해 비교가 수행되며 삭제로 표시됩니다. 이 필드는 액추에이터에 의해 설정되며 일반 공급자로서 cluster-api와 상호 작용할 자동 스케일러와 같은 상위 수준 엔티티에서 사용합니다. |
|
| 노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다. |
|
| 추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다. |
|
| 이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다. |
9.1.2. .spec.lifecycleHooks
- 설명
- LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다. |
|
| LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다. |
|
| 사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다. |
|
| LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다. |
9.1.3. .spec.lifecycleHooks.preDrain
- 설명
- PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.
- 유형
-
array
9.1.4. .spec.lifecycleHooks.preDrain[]
- 설명
- LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
소유자
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다. |
|
| owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다. |
9.1.5. .spec.lifecycleHooks.preTerminate
- 설명
- 사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.
- 유형
-
array
9.1.6. .spec.lifecycleHooks.preTerminate[]
- 설명
- LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
소유자
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다. |
|
| owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다. |
9.1.7. .spec.metadata
- 설명
- ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations |
|
| generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency |
|
| 개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels |
|
| 이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces |
|
| 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다. |
|
| OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다. |
9.1.8. .spec.metadata.ownerReferences
- 설명
- 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
- 유형
-
array
9.1.9. .spec.metadata.ownerReferences[]
- 설명
- OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
- 유형
-
object
- 필수 항목
-
apiVersion
-
kind
-
name
-
uid
-
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다. |
|
| true인 경우 이 참조는 관리 컨트롤러를 가리킵니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| 참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids |
9.1.10. .spec.providerSpec
- 설명
- 노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | value는 리소스 구성을 인라인으로 직렬화한 표현입니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전이 지정된 API 유형을 구성 요소와 유사한 상태로 유지하는 것이 좋습니다. |
9.1.11. .spec.taints
- 설명
- 추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.
- 유형
-
array
9.1.12. .spec.taints[]
- 설명
- 이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.
- 유형
-
object
- 필수 항목
-
effect
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다. |
|
| 필수 항목입니다. 노드에 적용할 taint 키입니다. |
|
| TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다. |
|
| taint 키에 해당하는 taint 값입니다. |
9.1.13. .status
- 설명
- MachineStatus는 머신의 관찰 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| address는 시스템에 할당된 주소 목록입니다. 사용 가능한 경우 클라우드 공급자에서 쿼리합니다. |
|
| NodeAddress에는 노드 주소에 대한 정보가 포함되어 있습니다. |
|
| 조건은 머신의 현재 상태를 정의합니다. |
|
| Condition은 Machine API 리소스 작동 상태를 관찰합니다. |
|
| 시스템 조정 터미널 문제가 있는 경우 errorMessage가 설정되며 로깅 및 사용자 소비에 적합한 더 자세한 문자열이 포함됩니다. 이 필드는 시간이 지남에 따라 컨트롤러가 자동으로 수정될 것으로 예상되는 전송 오류(예: 서비스 중단)에 대해 설정하지 않아야 하지만 대신 머신 사양 또는 컨트롤러 구성에 근본적으로 문제가 있음을 나타내며 수동 개입이 필요하다는 것을 나타냅니다. 터미널 오류의 예로는 사양의 설정이 유효하지 않거나, 컨트롤러에서 지원하지 않는 값 또는 담당 컨트롤러 자체가 매우 잘못 구성되어 있습니다. 머신 조정 중에 발생하는 일시적인 오류는 머신 오브젝트에 이벤트로 추가 및/또는 컨트롤러의 출력에 로그인할 수 있습니다. |
|
| ErrorReason은 머신을 조정하는데 터미널 문제가 있는 경우 설정되며, 머신 해석에 적합한 succinct 값을 포함합니다. 이 필드는 시간이 지남에 따라 컨트롤러가 자동으로 수정될 것으로 예상되는 전송 오류(예: 서비스 중단)에 대해 설정하지 않아야 하지만 대신 머신 사양 또는 컨트롤러 구성에 근본적으로 문제가 있음을 나타내며 수동 개입이 필요하다는 것을 나타냅니다. 터미널 오류의 예로는 사양의 설정이 유효하지 않거나, 컨트롤러에서 지원하지 않는 값 또는 담당 컨트롤러 자체가 매우 잘못 구성되어 있습니다. 머신 조정 중에 발생하는 일시적인 오류는 머신 오브젝트에 이벤트로 추가 및/또는 컨트롤러의 출력에 로그인할 수 있습니다. |
|
| LastOperation은 machine-controller에서 수행한 마지막 작동을 설명합니다. 이 API는 특정 머신에서 수행되는 최신 작업의 관점에서 기록으로 유용할 수 있습니다. 또한 최신 작동 상태를 전달해야 합니다. 예를 들어 계속 진행 중이거나 실패하거나 성공적으로 완료된 경우입니다. |
|
| LastUpdated는 이 상태가 마지막으로 관찰된 시기를 식별합니다. |
|
| NodeRef는 해당 노드가 있는 경우 해당 노드를 가리킵니다. |
|
| 단계(Step)는 머신 작동의 현재 단계를 나타냅니다. 다음 중 하나: Failed, Provisioning, Provisioned, Running, Deleting |
| `` | providerStatus는 공급자별 상태를 자세히 설명합니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전의 API 유형을 유지 관리하는 것이 좋습니다. |
9.1.14. .status.addresses
- 설명
- address는 시스템에 할당된 주소 목록입니다. 사용 가능한 경우 클라우드 공급자에서 쿼리합니다.
- 유형
-
array
9.1.15. .status.addresses[]
- 설명
- NodeAddress에는 노드 주소에 대한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
address
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| 노드 주소입니다. |
|
| 노드 주소 유형, 호스트 이름, ExternalIP 또는 InternalIP 중 하나 |
9.1.16. .status.conditions
- 설명
- 조건은 머신의 현재 상태를 정의합니다.
- 유형
-
array
9.1.17. .status.conditions[]
- 설명
- Condition은 Machine API 리소스 작동 상태를 관찰합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다. |
|
| 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 이 필드는 비어 있을 수 있습니다. |
|
| CamelCase에서 조건의 마지막 전환 이유는 다음과 같습니다. 특정 API는 이 필드가 보장된 API로 간주되는지 여부를 선택할 수 있습니다. 이 필드는 비어 있지 않을 수 있습니다. |
|
| 심각도는 이유 코드에 대한 명시적 분류를 제공하므로 사용자 또는 머신이 현재 상황을 즉시 이해하고 그에 따라 조치를 취할 수 있습니다. 심각도 필드는 Status=False인 경우에만 설정해야 합니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| CamelCase 또는 foo.example.com/CamelCase의 조건 유형입니다. 많은 .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. |
9.1.18. .status.lastOperation
- 설명
- LastOperation은 machine-controller에서 수행한 마지막 작동을 설명합니다. 이 API는 특정 머신에서 수행되는 최신 작업의 관점에서 기록으로 유용할 수 있습니다. 또한 최신 작동 상태를 전달해야 합니다. 예를 들어 계속 진행 중이거나 실패하거나 성공적으로 완료된 경우입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 설명은 마지막 작업에 대해 사람이 읽을 수 있는 설명입니다. |
|
| LastUpdated는 LastOperation API가 마지막으로 업데이트된 타임스탬프입니다. |
|
| state는 마지막으로 수행된 작업의 현재 상태입니다. 예: 처리, 실패, 성공 등 |
|
| type은 마지막으로 수행된 작업 유형입니다. 예: 생성, 삭제, 업데이트 등 |
9.1.19. .status.nodeRef
- 설명
- NodeRef는 해당 노드가 있는 경우 해당 노드를 가리킵니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| 전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다. |
|
| 일종의 추천입니다. 자세한 내용은 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 |
9.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machine.openshift.io/v1beta1/machines
-
GET
: 종류의 개체를 나열합니다.
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines
-
DELETE
: 머신 컬렉션 삭제 -
GET
: 종류의 개체를 나열합니다. -
POST
: 머신 생성
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}
-
DELETE
: 머신 삭제 -
GET
: 지정된 머신 읽기 -
PATCH
: 지정된 머신을 부분적으로 업데이트 -
PUT
: 지정된 머신 교체
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}/status
-
GET
: 지정된 머신의 읽기 상태 -
PATCH
: 지정된 머신의 부분 업데이트 상태 -
PUT
: 지정된 머신의 상태 교체
-
9.2.1. /apis/machine.openshift.io/v1beta1/machines
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- Machine 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
9.2.2. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- 머신 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- Machine 유형의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 - 무단 | 빈 |
9.2.3. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{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
- 설명
- 지정된 머신 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 머신을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 머신 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9.2.4. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machines/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 머신의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 머신의 읽기 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 머신의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 머신의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10장. MachineSet [machine.openshift.io/v1beta1]
- 설명
- MachineSet은 지정된 수의 머신 복제본이 지정된 시간에 실행되도록 합니다. 호환성 수준 2: 주요 릴리스 내에서 최소 9 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 사용할 수 있습니다.
- 유형
-
object
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 |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| MachineSetSpec은 원하는 MachineSet 상태를 정의합니다. |
|
| MachineSetStatus는 MachineSet의 관찰 상태를 정의합니다. |
10.1.1. .spec
- 설명
- MachineSetSpec은 원하는 MachineSet 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| DeletePolicy는 축소 시 삭제할 노드를 식별하는 데 사용되는 정책을 정의합니다. 기본값은 "Random"입니다. 유효한 값은 "Random, "Newest", "Oldest"입니다. |
|
| minReadySeconds는 새로 생성된 시스템을 준비해야 하는 최소 시간(초)입니다. 기본값은 0입니다 (기계는 준비되는 즉시 사용 가능한 것으로 간주됨) |
|
| replicas는 원하는 복제본 수입니다. 이는 명시적 0과 지정되지 않음을 구분하기 위한 포인터입니다. 기본값은 1입니다. |
|
| selector는 복제본 수와 일치해야 하는 시스템의 레이블 쿼리입니다. 이 MachineSet에서 제어하려면 일치해야 하는 레이블 키와 값입니다. 머신 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors |
|
| 템플릿은 충분하지 않은 복제본이 감지되면 생성되는 머신을 설명하는 오브젝트입니다. |
10.1.2. .spec.selector
- 설명
- selector는 복제본 수와 일치해야 하는 시스템의 레이블 쿼리입니다. 이 MachineSet에서 제어하려면 일치해야 하는 레이블 키와 값입니다. 머신 템플릿의 레이블과 일치해야 합니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
10.1.3. .spec.selector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
10.1.4. .spec.selector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
10.1.5. .spec.template
- 설명
- 템플릿은 충분하지 않은 복제본이 감지되면 생성되는 머신을 설명하는 오브젝트입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata |
|
| 머신의 원하는 동작에 대한 사양입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status |
10.1.6. .spec.template.metadata
- 설명
- 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations |
|
| generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency |
|
| 개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels |
|
| 이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces |
|
| 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다. |
|
| OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다. |
10.1.7. .spec.template.metadata.ownerReferences
- 설명
- 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
- 유형
-
array
10.1.8. .spec.template.metadata.ownerReferences[]
- 설명
- OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
- 유형
-
object
- 필수 항목
-
apiVersion
-
kind
-
name
-
uid
-
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다. |
|
| true인 경우 이 참조는 관리 컨트롤러를 가리킵니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| 참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids |
10.1.9. .spec.template.spec
- 설명
- 머신의 원하는 동작에 대한 사양입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다. |
|
| ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다. |
|
| providerID는 공급자가 제공하는 머신의 ID입니다. 이 필드는 이 머신에 해당하는 노드 오브젝트에 표시된 공급자 ID와 일치해야 합니다. 이 필드는 cluster-api의 상위 수준 소비자에 필요합니다. 사용 사례는 cluster-api가 공급자인 클러스터 자동 스케일러입니다. 자동 스케일러의 정리 논리는 머신을 노드와 비교하여 Kubernetes 노드로 등록할 수 없는 공급자의 시스템을 찾습니다. 자동 스케일러의 일반 out-of-tree 공급자인 cluster-api를 사용하면 자동 스케일러에 시스템 목록의 공급자 보기를 사용할 수 있어야 합니다. k8s apiserver에서 다른 노드 목록을 쿼리한 다음, 등록되지 않은 시스템을 확인하기 위해 비교가 수행되며 삭제로 표시됩니다. 이 필드는 액추에이터에 의해 설정되며 일반 공급자로서 cluster-api와 상호 작용할 자동 스케일러와 같은 상위 수준 엔티티에서 사용합니다. |
|
| 노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다. |
|
| 추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다. |
|
| 이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다. |
10.1.10. .spec.template.spec.lifecycleHooks
- 설명
- LifecycleHooks를 사용하면 머신 라이프사이클 내에서 사전 정의된 특정 시점에서 머신에서 작업을 일시 중지할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다. |
|
| LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다. |
|
| 사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다. |
|
| LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다. |
10.1.11. .spec.template.spec.lifecycleHooks.preDrain
- 설명
- PreDrain 후크를 사용하면 시스템이 드레이닝되지 않습니다. 또한 종료와 같은 추가 라이프사이클 이벤트가 차단됩니다.
- 유형
-
array
10.1.12. .spec.template.spec.lifecycleHooks.preDrain[]
- 설명
- LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
소유자
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다. |
|
| owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다. |
10.1.13. .spec.template.spec.lifecycleHooks.preTerminate
- 설명
- 사전 종료 후크를 사용하면 시스템이 종료되지 않습니다. 사전 종료 후크는 머신이 드레인된 후 작동합니다.
- 유형
-
array
10.1.14. .spec.template.spec.lifecycleHooks.preTerminate[]
- 설명
- LifecycleHook은 라이프사이클 후크의 단일 인스턴스를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
소유자
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 lifcycle 후크의 고유한 이름을 정의합니다. 이름은 CamelCase에서 고유하고 설명적으로 1~3단어여야 하며, 네임스페이스(예: foo.example.com/CamelCase)여야 합니다. 이름은 고유해야 하며 단일 엔티티에서만 관리해야 합니다. |
|
| owner는 라이프사이클 후크의 소유자를 정의합니다. 이는 사용자가 라이프사이클 차단을 담당하는 사람/누구를 식별할 수 있도록 충분히 설명해야 합니다. 컨트롤러의 이름(예: clusteroperator/etcd) 또는 후크를 관리하는 관리자일 수 있습니다. |
10.1.15. .spec.template.spec.metadata
- 설명
- ObjectMeta가 생성된 노드를 자동으로 채웁니다. 이를 사용하여 노드를 생성할 때 사용해야 하는 레이블, 주석, 이름 접두사 등을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 주석은 임의의 메타데이터를 저장 및 검색하기 위해 외부 툴에서 설정할 수 있는 리소스와 함께 저장되는 구조화되지 않은 키 값 맵입니다. 오브젝트를 수정할 때 쿼리할 수 없으며 보존해야 합니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/annotations |
|
| generateName은 서버에서 사용하는 선택적 접두사로, Name 필드가 제공되지 않은 고유한 이름만 생성하는 데 사용됩니다. 이 필드를 사용하면 클라이언트에 반환되는 이름이 전달된 이름과 다릅니다. 이 값은 고유한 접미사와 결합됩니다. 제공된 값은 Name 필드와 동일한 검증 규칙을 가지며 서버에서 고유 값을 만드는 데 필요한 접미사 길이로 잘릴 수 있습니다. 이 필드가 지정되고 생성된 이름이 있는 경우 서버는 409를 반환하지 않습니다. 대신 201 Created 또는 500을 반환합니다. Reason ServerTimeout은 할당된 시간에 고유 이름을 찾을 수 없으며 클라이언트가 재시도해야 함을 나타냅니다(선택적으로 Retry-After 헤더에 표시된 시간 후). Name이 지정되지 않은 경우에만 적용됩니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency |
|
| 개체를 구성 및 분류(범위 및 선택)하는 데 사용할 수 있는 문자열 키와 값의 맵입니다. 복제 컨트롤러 및 서비스의 선택기와 일치할 수 있습니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/labels |
|
| 이름은 네임스페이스 내에서 고유해야 합니다. 일부 리소스는 클라이언트가 적절한 이름의 생성을 자동으로 요청할 수 있지만 리소스를 생성할 때 필요합니다. 이름은 주로 생성 멱등 및 구성 정의를 위한 것입니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| namespace는 각 이름 내의 공간을 고유해야 합니다. 빈 네임스페이스는 "default" 네임스페이스와 동일하지만 "default"는 표준 표현입니다. 모든 오브젝트의 범위를 네임스페이스로 지정해야 하는 것은 아닙니다. 해당 오브젝트에 대한 이 필드의 값은 비어 있습니다. DNS_LABEL이어야 합니다. CamelCase로 자세한 내용은 http://kubernetes.io/docs/user-guide/namespaces |
|
| 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다. |
|
| OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다. |
10.1.16. .spec.template.spec.metadata.ownerReferences
- 설명
- 이 오브젝트에서 사용하는 오브젝트 목록입니다. 목록에 있는 모든 개체가 삭제된 경우 이 개체는 가비지 수집됩니다. 컨트롤러에서 이 오브젝트를 관리하는 경우 이 목록의 항목이 이 컨트롤러를 가리키며 controller 필드가 true로 설정됩니다. 컨트롤러가 여러 개 있을 수 없습니다.
- 유형
-
array
10.1.17. .spec.template.spec.metadata.ownerReferences[]
- 설명
- OwnerReference에는 소유 개체를 식별할 수 있는 충분한 정보가 포함되어 있습니다. 소유 오브젝트는 종속 항목과 동일한 네임스페이스에 있거나 클러스터 범위여야 하므로 네임스페이스 필드가 없습니다.
- 유형
-
object
- 필수 항목
-
apiVersion
-
kind
-
name
-
uid
-
속성 | 유형 | 설명 |
---|---|---|
|
| 참조의 API 버전입니다. |
|
| If true, and if the owner has the "foreworkspaceDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. 가비지 수집기가 이 필드와 상호 작용하고 전경 삭제를 적용하는 방법은 https://kubernetes.io/docs/concepts/architecture/garbage-collection/#foreground-deletion 를 참조하십시오. 기본값은 false입니다. 이 필드를 설정하려면 사용자에게 소유자의 "삭제" 권한이 필요하며, 그렇지 않으면 422(프로세스할 수 없는 엔티티)가 반환됩니다. |
|
| true인 경우 이 참조는 관리 컨트롤러를 가리킵니다. |
|
| 일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 추천자의 이름입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#names |
|
| 참조의 UID입니다. 자세한 내용은 http://kubernetes.io/docs/user-guide/identifiers#uids |
10.1.18. .spec.template.spec.providerSpec
- 설명
- 노드 생성 중에 사용할 providerSpec 세부 정보 공급자별 구성입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | value는 리소스 구성을 인라인으로 직렬화한 표현입니다. 공급자는 이 필드에서 직렬화/직렬화해야 하는 자체 버전이 지정된 API 유형을 구성 요소와 유사한 상태로 유지하는 것이 좋습니다. |
10.1.19. .spec.template.spec.taints
- 설명
- 추가 방식으로 해당 노드에 적용할 테인트 목록입니다. 이 목록은 다른 엔티티에 의해 지속적으로 노드에 추가된 다른 테인트를 덮어쓰지 않습니다. 예를 들어 머신 컨트롤러에서 테인트를 적용하도록 요청한 다음 테인트를 수동으로 제거하도록 요청하는 경우 이러한 테인트를 적극적으로 조정해야 하지만 머신 컨트롤러에서 테인트를 제거하지는 않습니다.
- 유형
-
array
10.1.20. .spec.template.spec.taints[]
- 설명
- 이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.
- 유형
-
object
- 필수 항목
-
effect
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다. |
|
| 필수 항목입니다. 노드에 적용할 taint 키입니다. |
|
| TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다. |
|
| taint 키에 해당하는 taint 값입니다. |
10.1.21. .status
- 설명
- MachineSetStatus는 MachineSet의 관찰 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이 MachineSet에 대해 사용 가능한 복제본 수 (최소 minReadySeconds) 수입니다. |
|
| |
|
| 복제본을 조정하는 터미널 문제가 있는 경우 ErrorReason 및 ErrorMessage가 모두 설정됩니다. ErrorReason은 머신 해석에 적합한 succinct 값으로 채워지지만 ErrorMessage에는 로깅 및 인적 소비에 적합한 더 자세한 문자열이 포함됩니다. 이러한 필드는 시간이 지남에 따라 컨트롤러가 자동으로 수정될 것으로 예상되는 전송 오류(예: 서비스 중단)에 대해 설정되지 않아야 하지만 대신 MachineTemplate의 사양 또는 머신 컨트롤러 구성에 근본적으로 문제가 있음을 나타내며 수동 개입이 필요하다는 것을 나타냅니다. 터미널 오류의 예로는 사양의 설정이 유효하지 않거나, 머신 컨트롤러에서 지원하지 않는 값 또는 담당 머신 컨트롤러 자체가 매우 잘못 구성되어 있습니다. 머신 조정 중에 발생하는 일시적인 오류는 MachineSet 오브젝트에 이벤트로 추가 및/또는 컨트롤러의 출력에 로그인할 수 있습니다. |
|
| MachineSet의 머신 템플릿의 레이블과 일치하는 레이블이 있는 복제본 수입니다. |
|
| observedGeneration은 가장 최근에 관찰된 MachineSet의 생성을 반영합니다. |
|
| 이 MachineSet의 준비된 복제본 수입니다. 노드가 생성되고 "Ready"인 경우 시스템이 준비된 것으로 간주됩니다. |
|
| 복제본은 가장 최근에 관찰된 복제본 수입니다. |
10.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/machine.openshift.io/v1beta1/machinesets
-
GET
: 종류의 MachineSet의 오브젝트 나열
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets
-
DELETE
: MachineSet의 컬렉션 삭제 -
GET
: 종류의 MachineSet의 오브젝트 나열 -
POST
: MachineSet 생성
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}
-
DELETE
: MachineSet 삭제 -
GET
: 지정된 MachineSet 읽기 -
PATCH
: 지정된 MachineSet을 부분적으로 업데이트 -
PUT
: 지정된 MachineSet을 교체
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/scale
-
GET
: 지정된 MachineSet의 읽기 크기 -
PATCH
: 지정된 MachineSet의 부분 업데이트 규모 -
PUT
: 지정된 MachineSet의 스케일링을 교체
-
/apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/status
-
GET
: 지정된 MachineSet의 읽기 상태 -
PATCH
: 지정된 MachineSet의 부분 업데이트 상태 -
PUT
: 지정된 MachineSet의 상태 교체
-
10.2.1. /apis/machine.openshift.io/v1beta1/machinesets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- MachineSet 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
10.2.2. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets
매개변수 | 유형 | 설명 |
---|---|---|
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineSet의 컬렉션 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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 방법
-
GET
- 설명
- MachineSet 유형의 오브젝트 나열
매개변수 | 유형 | 설명 |
---|---|---|
|
| 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
- 설명
- MachineSet 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
10.2.3. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
DELETE
- 설명
- MachineSet 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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
- 설명
- 지정된 MachineSet 읽기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineSet 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10.2.4. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/scale
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 MachineSet의 읽기 크기
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineSet의 부분 업데이트 스케일링
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineSet의 스케일링 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10.2.5. /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| MachineSet의 이름 |
|
| 팀 및 프로젝트의 경우와 같은 오브젝트 이름 및 인증 범위 |
매개변수 | 유형 | 설명 |
---|---|---|
|
| 'true'인 경우 출력이 상당히 인쇄됩니다. |
- HTTP 방법
-
GET
- 설명
- 지정된 MachineSet의 읽기 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| resourceVersion은 요청이 제공할 수 있는 리소스 버전에 대한 제약 조건을 설정합니다. 자세한 내용은 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 을 참조하십시오. 기본값이 설정되지 않음 |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 MachineSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| Fieldmanager는 이러한 변경을 수행하는 작업자 또는 엔티티와 연결된 이름입니다. 값은 https://golang.org/pkg/unicode/#IsPrint 에서 정의한 대로 인쇄 가능한 문자만 포함하거나 128자 미만이어야 합니다. |
|
|
FieldValidation은 |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 MachineSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 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.