구성 API
구성 API에 대한 참조 가이드
초록
1장. 구성 API
1.1. APIServer [config.openshift.io/v1]
- 설명
- apiserver에는 시스템의 모든 API 서버에서 공유하는 구성(예: 인증서 제공, 클라이언트 CA 및 CORS 도메인 제공)이 있습니다. 특히 kube-apiserver 및 openshift-apiserver가 있습니다. 인스턴스의 표준 이름은 'cluster'입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.2. 인증 [config.openshift.io/v1]
- 설명
-
인증은 인증을 위한 클러스터 전체 설정(예: OAuth 및 Webhook 토큰 인증기)을 지정합니다. 인스턴스의 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.3. 빌드 [config.openshift.io/v1]
- 설명
- build는 전체 클러스터에 대한 OpenShift 빌드 동작을 구성합니다. 여기에는 BuildConfig 오브젝트에서 재정의할 수 있는 기본 설정이 포함되며 모든 빌드에 적용되는 덮어쓰기가 포함됩니다. 표준 이름은 "클러스터" 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴) 용 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.4. ClusterOperator [config.openshift.io/v1]
- 설명
- ClusterOperator는 Operator의 현재 상태를 가지고 있는 Custom Resource 오브젝트입니다. Operator는 이 오브젝트를 사용하여 클러스터의 나머지 부분에 상태를 전달합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.5. ClusterVersion [config.openshift.io/v1]
- 설명
- ClusterVersion은 ClusterVersionOperator의 구성입니다. 여기에서 자동 업데이트와 관련된 매개변수를 설정할 수 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.6. 콘솔 [config.openshift.io/v1]
- 설명
-
콘솔에는 로그 아웃 URL을 포함하여 웹 콘솔에 대한 클러스터 전체 구성이 있으며 콘솔의 공용 URL을 보고합니다. 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.7. DNS [config.openshift.io/v1]
- 설명
-
DNS에는 DNS에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.8. FeatureGate [config.openshift.io/v1]
- 설명
-
기능에는 기능 게이트에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.9. HelmChartRepository [helm.openshift.io/v1beta1]
- 설명
- HelmChartRepository는 프록시된 Helm 차트 리포지터리 호환성 수준 2에 대한 클러스터 전체 구성을 보유하고 있습니다. 2단계: 최소 9개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.10. Image [config.openshift.io/v1]
- 설명
- 이미지는 이미지 스트림 가져오기 및 외부 레지스트리의 런타임 구성과 관련된 정책을 관리합니다. 클러스터 관리자는 OpenShift가 이미지를 가져올 수 있는 레지스트리, 외부 레지스트리의 추가 CA 신뢰 번들, 레지스트리 호스트 이름을 차단하거나 허용하는 정책을 구성할 수 있습니다. OpenShift의 이미지 레지스트리를 공개에 노출할 때 클러스터 관리자가 외부 호스트 이름을 지정할 수도 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.11. ImageDigestMirrorSet [config.openshift.io/v1]
- 설명
- ImageDigestMirrorSet은 다이제스트 가져오기 사양을 사용하여 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.12. ImageContentPolicy [config.openshift.io/v1]
- 설명
- ImageContentPolicy에는 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.13. ImageTagMirrorSet [config.openshift.io/v1]
- 설명
- ImageTagMirrorSet은 태그 풀 사양을 사용하여 에서 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.14. 인프라 [config.openshift.io/v1]
- 설명
-
인프라에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.15. Ingress [config.openshift.io/v1]
- 설명
-
Ingress에는 경로에 사용되는 기본 인그레스 도메인을 포함하여 Ingress에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.16. Network [config.openshift.io/v1]
- 설명
-
네트워크에는 네트워크에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
cluster
입니다. 서비스/Pod IP의 IP 주소 풀, 네트워크 플러그인 등 원하는 네트워크 구성을 구성하는 데 사용됩니다. 이 리소스를 구성할 때 적용되는 사항에 대한 설명은 network.spec을 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.17. Node [config.openshift.io/v1]
- 설명
- 노드에는 노드별 기능에 대한 클러스터 전체 정보가 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.18. OAuth [config.openshift.io/v1]
- 설명
-
OAuth에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
cluster
입니다. 통합 OAuth 서버를 구성하는 데 사용됩니다. 이 구성은 최상위 인증 구성의 유형이 IntegratedOAuth로 설정된 경우에만 적용됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.19. OperatorHub [config.openshift.io/v1]
- 설명
- OperatorHub는 operatorhubs API의 스키마입니다. 클러스터의 OperatorHub의 기본 허브 소스의 상태를 enabled에서 disabled로 변경하고 그 반대의 경우도 마찬가지입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.20. Project [config.openshift.io/v1]
- 설명
-
프로젝트에는 프로젝트에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.21. ProjectHelmChartRepository [helm.openshift.io/v1beta1]
- 설명
- ProjectHelmChartRepository는 프록시된 Helm 차트 리포지터리 호환성 수준 2에 대한 네임스페이스 전체 구성을 보유하고 있습니다. 최소 9개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
1.22. Proxy [config.openshift.io/v1]
- 설명
-
proxy에는 클러스터의 기본 프록시를 구성하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
1.23. Scheduler [config.openshift.io/v1]
- 설명
-
스케줄러는 Kubernetes 스케줄러를 실행하고 배치 결정에 영향을 주기 위해 클러스터 전체 구성 정보를 보유합니다. 이 구성의 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
2장. APIServer [config.openshift.io/v1]
- 설명
- apiserver에는 시스템의 모든 API 서버에서 공유하는 구성(예: 인증서 제공, 클라이언트 CA 및 CORS 도메인 제공)이 있습니다. 특히 kube-apiserver 및 openshift-apiserver가 있습니다. 인스턴스의 표준 이름은 'cluster'입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
2.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
2.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| additionalCORSAllowedOrigins는 API 서버가 CORS 헤더를 사용하여 액세스할 수 있는 호스트를 설명하는 추가 사용자 정의 정규식을 나열합니다. JavaScript 애플리케이션에서 API 및 통합 OAuth 서버에 액세스하려면 이 작업이 필요할 수 있습니다. 값은 Golang 정규식 언어에 해당하는 정규식입니다. |
|
| audit은 클러스터의 모든 OpenShift 제공 API 서버에 적용할 감사 구성에 대한 설정을 지정합니다. |
|
| ClientCA는 Operator 관리 서명자 외에도 들어오는 클라이언트 인증서로 인식될 서명자의 인증서 번들이 포함된 ConfigMap을 참조합니다. 비어 있는 경우 운영자 관리 서명자만 유효합니다. 일반적으로 자체 PKI가 있는 경우에만 클라이언트 인증서를 준수해야 합니다. ConfigMap은 openshift-config 네임스페이스에 있어야 하며 - ConfigMap.Data["ca-bundle.crt"] - CA 번들의 필수 필드를 포함해야 합니다. |
|
| 암호화를 사용하면 데이터 저장소 계층에서 리소스의 암호화를 구성할 수 있습니다. |
|
| servingCert는 보안 트래픽을 제공하기 위한 TLS 인증서 정보입니다. 지정하지 않으면 Operator 관리 인증서가 보안 트래픽을 제공하는 데 사용됩니다. |
|
| tlsSecurityProfile은 외부에 노출된 서버의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값(릴리스 간에 변경될 수 있음)이 선택됩니다. Old, Intermediate 및 Custom 프로파일만 지원되며 사용 가능한 최대 minTLSVersion은 VersionTLS12입니다. |
2.1.2. .spec.audit
- 설명
- audit은 클러스터의 모든 OpenShift 제공 API 서버에 적용할 감사 구성에 대한 설정을 지정합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| customRules는 그룹당 프로필을 지정합니다. 이러한 프로필이 적용되는 경우 최상위 프로필 필드보다 우선합니다. 이러한 평가는 위에서 아래로 평가되며 일치하는 첫 번째 항목이 적용됩니다. |
|
| AuditCustomRule은 최상위 프로필보다 우선하는 감사 프로필에 대한 사용자 정의 규칙을 설명합니다. |
|
|
profile은 클러스터의 OpenShift 제공 API 서버(kube-apiserver, openshift-apiserver 및 oauth-apiserver)에 전송된 모든 요청에 적용할 상위 수준 감사 프로필의 이름을 지정하고 customRules 중 하나 이상과 일치하는 요청을 제외합니다. 다음 프로필이 제공됩니다. - Default: events를 제외하고 MetaData 수준 로깅을 의미하며(모두 기록되지 않음), oauthaccesstokens 및 oauthauthorizetokens(RequestBody 수준에서 모두 기록됨). - WriteRequestBody: 'Default'와 같이 기록 요청 및 응답 HTTP 페이로드(생성, 업데이트, 업데이트)를 의미합니다. patch). - AllRequestBodies: like 'WriteRequestBodies', but also logs request and response HTTP payload for read requests (get, list). - None: no requests are logged at all, not even oauthaccesstokens and oauthauthorizetokens. 경고: 문제를 해결할 때 유용할 수 있는 데이터를 로깅하지 않는 한 |
2.1.3. .spec.audit.customRules
- 설명
- customRules는 그룹당 프로필을 지정합니다. 이러한 프로필이 적용되는 경우 최상위 프로필 필드보다 우선합니다. 이러한 평가는 위에서 아래로 평가되며 일치하는 첫 번째 항목이 적용됩니다.
- 유형
-
array
2.1.4. .spec.audit.customRules[]
- 설명
- AuditCustomRule은 최상위 프로필보다 우선하는 감사 프로필에 대한 사용자 정의 규칙을 설명합니다.
- 유형
-
object
- 필수 항목
-
group
-
profile
-
속성 | 유형 | 설명 |
---|---|---|
|
| group은 이 프로필을 적용하려면 요청 사용자가 멤버여야 하는 그룹의 이름입니다. |
|
| profile은 클러스터의 모든 OpenShift 제공 API 서버에 배포할 원하는 감사 정책 구성의 이름을 지정합니다. 다음 프로필이 제공됩니다. - Default: 기존 기본 정책입니다. - WriteRequestBodies: 'Default'와 같이 'Default'와 같이 쓰기 요청(생성, 업데이트, 패치)에 대한 요청 및 응답 HTTP 페이로드(예: 'WriteRequestBodies') - AllRequestBodies:예: 'WriteRequestBodies', 로그 요청 및 응답 HTTP 페이로드(get, list). - None: 없음 설정되지 않은 경우 'Default' 프로필이 기본값으로 사용됩니다. |
2.1.5. .spec.clientCA
- 설명
- ClientCA는 Operator 관리 서명자 외에도 들어오는 클라이언트 인증서로 인식될 서명자의 인증서 번들이 포함된 ConfigMap을 참조합니다. 비어 있는 경우 운영자 관리 서명자만 유효합니다. 일반적으로 자체 PKI가 있는 경우에만 클라이언트 인증서를 준수해야 합니다. ConfigMap은 openshift-config 네임스페이스에 있어야 하며 - ConfigMap.Data["ca-bundle.crt"] - CA 번들의 필수 필드를 포함해야 합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
2.1.6. .spec.encryption
- 설명
- 암호화를 사용하면 데이터 저장소 계층에서 리소스의 암호화를 구성할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 데이터 저장소 계층에서 리소스를 암호화하는 데 사용해야 하는 암호화 유형을 정의합니다. 이 필드가 설정되지 않은 경우(즉, 빈 문자열로 설정된 경우) ID가 부정확합니다. 설정되지 않은 동작이 시간이 지남에 따라 변경될 수 있습니다. 암호화가 기본적으로 활성화되어 있어도 설정되지 않은 의미는 모범 사례 변경에 따라 다른 암호화 유형으로 변경될 수 있습니다. 암호화가 활성화되면 플랫폼과 함께 제공된 모든 중요한 리소스가 암호화됩니다. 이 중요한 리소스 목록은 시간이 지남에 따라 변경될 수 있습니다. 현재 권한 있는 목록은 1입니다. 보안 2. configmaps 3. routes.route.openshift.io 4. oauthaccesstokens.oauth.openshift.io 5. oauthauthorizetokens.oauth.openshift.io |
2.1.7. .spec.servingCerts
- 설명
- servingCert는 보안 트래픽을 제공하기 위한 TLS 인증서 정보입니다. 지정하지 않으면 Operator 관리 인증서가 보안 트래픽을 제공하는 데 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| namedCertificates는 특정 호스트 이름에 보안 트래픽을 제공하기 위한 TLS 인증서 정보가 포함된 시크릿을 참조합니다. 이름이 지정된 인증서가 제공되지 않거나 이름이 지정된 인증서가 클라이언트에서 이해한 대로 서버 이름과 일치하지 않으면 defaultServingCertificate가 사용됩니다. |
|
| APIServerNamedServingCert는 클라이언트에서 이해할 수 있는 서버 DNS 이름을 인증서에 매핑합니다. |
2.1.8. .spec.servingCerts.namedCertificates
- 설명
- namedCertificates는 특정 호스트 이름에 보안 트래픽을 제공하기 위한 TLS 인증서 정보가 포함된 시크릿을 참조합니다. 이름이 지정된 인증서가 제공되지 않거나 이름이 지정된 인증서가 클라이언트에서 이해한 대로 서버 이름과 일치하지 않으면 defaultServingCertificate가 사용됩니다.
- 유형
-
array
2.1.9. .spec.servingCerts.namedCertificates[]
- 설명
- APIServerNamedServingCert는 클라이언트에서 이해할 수 있는 서버 DNS 이름을 인증서에 매핑합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 이 인증서를 사용하여 보안 트래픽을 제공해야 하는 명시적 DNS 이름(허용 와일드카드)의 선택적 목록입니다. 이름을 제공하지 않으면 암시적 이름이 인증서에서 추출됩니다. 정확한 이름은 와일드카드 이름을 통해 추적됩니다. 여기에 정의된 명시적 이름은 추출된 암시적 이름보다 충돌합니다. |
|
| servingCertificate는 보안 트래픽을 제공하기 위한 TLS 인증서 정보가 포함된 kubernetes.io/tls 유형 시크릿을 참조합니다. 시크릿은 openshift-config 네임스페이스에 있어야 하며 다음과 같은 필수 필드를 포함해야 합니다. - Secret.Data["tls.key"] - TLS 개인 키. - Secret.Data["tls.crt"] - TLS 인증서. |
2.1.10. .spec.servingCerts.namedCertificates[].servingCertificate
- 설명
- servingCertificate는 보안 트래픽을 제공하기 위한 TLS 인증서 정보가 포함된 kubernetes.io/tls 유형 시크릿을 참조합니다. 시크릿은 openshift-config 네임스페이스에 있어야 하며 다음과 같은 필수 필드를 포함해야 합니다. - Secret.Data["tls.key"] - TLS 개인 키. - Secret.Data["tls.crt"] - TLS 인증서.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
2.1.11. .spec.tlsSecurityProfile
- 설명
- tlsSecurityProfile은 외부에 노출된 서버의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값(릴리스 간에 변경될 수 있음)이 선택됩니다. Old, Intermediate 및 Custom 프로파일만 지원되며 사용 가능한 최대 minTLSVersion은 VersionTLS12입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | Custom은 사용자 정의 TLS 보안 프로필입니다. 잘못된 구성으로 사용자 지정 프로필을 사용하는 것은 치명적일 수 있습니다. 사용자 정의 프로파일의 예는 다음과 같습니다: - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 minTLSVersion: VersionTLS11 |
| `` | Intermediate는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Intermediate_compatibility_.28recommended.29 (yaml): 암호화: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - DHE-RSA-AES128-GCM-SHA256 - DHE-RSA-AES256-GCM-SHA384 minTLSVersion: 버전TLS12 |
| `` | 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_SHA256 minTLSVersion: VersionTLS13 |
| `` | Old는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Old_backward_compatibility (yaml): 암호화: - TLS_AES_128_GCM_SHA256 - TLS_AES_256_GCM_SHA384 - TLS_CHACHA20_GCM_SHA384 - TLS_CHACHA20_POLY1305_SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-RSA-AES256-GCM-SHA384 - ECDHE-RSA-aes256-GCM-sha384 - ECDHE-ECDSA-chaCHA20-POLY1305 - ECDHE-RSA-chaCHA20-POLY1305 - DHE-RSA-aes128-GCM-sha256 - DHE-RSA-aes256-GCM-sha384 - DHE-RSA-chaCHA20-POLY1305 - ECDHE-ECDSA-aes128-sha256 - ECDHE-RSA-aes128-sha256 - ECDHE-ECDSA-SHA - ECDHE-RSA-aes128-aes128-aes128-aes256-sha384 - ECDHE-RSA-aes256-sha384 - ECDHE-ECDSA-aes256-ECDSA-aes256-RSA-aes-SHA-SHA - DHE-RSA-AES128-SHA256 - DHE-RSA-AES256-SHA256 - AES256-GCM-SHA256 - AES256-GCM-SHA384 - AES128-SHA256 - AES128-SHA - AES128-SHA - AES256-SHA - DES-CBC3-SHA minTLSVersion: 버전TLS10 |
|
| type은 Old, Intermediate, Modern 또는 Custom 중 하나입니다. Custom은 개별 TLS 보안 프로파일 매개변수를 지정하는 기능을 제공합니다. 이전, Intermediate 및 Modern는 다음을 기반으로 하는 TLS 보안 프로필입니다. https://wiki.mozilla.org/Security/Server_Side_TLS#Recommended_configurations 프로필은 의도 기반이므로 새 암호가 개발되고 기존 암호가 안전하지 않은 것으로 확인되면 시간이 지남에 따라 변경될 수 있습니다. 프로세스에서 사용할 수 있는 암호에 따라 목록이 줄어들 수 있습니다. Modern 프로파일은 아직 공통 소프트웨어 라이브러리에서 잘 채택되지 않았기 때문에 현재 지원되지 않습니다. |
2.1.12. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
2.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/apiservers
-
DELETE
: APIServer의 컬렉션 삭제 -
GET
: 종류 APIServer의 오브젝트 나열 -
POST
: APIServer 생성
-
/apis/config.openshift.io/v1/apiservers/{name}
-
DELETE
: APIServer 삭제 -
GET
: 지정된 APIServer 읽기 -
PATCH
: 지정된 APIServer를 부분적으로 업데이트 -
PUT
: 지정된 APIServer를 교체
-
/apis/config.openshift.io/v1/apiservers/{name}/status
-
GET
: 지정된 APIServer의 읽기 상태 -
PATCH
: 지정된 APIServer의 부분 업데이트 상태 -
PUT
: 지정된 APIServer의 상태 교체
-
2.2.1. /apis/config.openshift.io/v1/apiservers
- HTTP 방법
-
DELETE
- 설명
- APIServer의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류 APIServer의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- APIServer 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
2.2.2. /apis/config.openshift.io/v1/apiservers/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| APIServer의 이름 |
- HTTP 방법
-
DELETE
- 설명
- APIServer 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 APIServer 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 APIServer를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 APIServer를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
2.2.3. /apis/config.openshift.io/v1/apiservers/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| APIServer의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 APIServer의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 APIServer의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 APIServer의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3장. 인증 [config.openshift.io/v1]
- 설명
-
인증은 인증을 위한 클러스터 전체 설정(예: OAuth 및 Webhook 토큰 인증기)을 지정합니다. 인스턴스의 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
3.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| oauthMetadata에는 외부 OAuth 서버의 OAuth 2.0 인증 서버 메타데이터에 대한 검색 끝점 데이터가 포함되어 있습니다. 이 검색 문서는 제공된 위치에서 확인할 수 있습니다. oc get --raw '/.well-known/oauth-authorization-server' 자세한 내용은 IETF Draft: https://tools.ietf.org/html/draft-ietf-oauth-discovery-04#section-2 If oauthMetadata.name is non-empty, this value has precedence over any metadata reference stored in status. "oauthMetadata" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 메타데이터가 제공되지 않습니다. 지정된 메타데이터가 유효하지 않으면 메타데이터가 제공되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| serviceAccountIssuer는 바인딩된 서비스 계정 토큰 발행자의 식별자입니다. 기본값은 https://kubernetes.default.svc WARNING: 이 필드 업데이트로 인해 이전 발행자 값으로 바인딩된 모든 토큰이 즉시 무효화되지 않습니다. 대신 이전 서비스 계정 발행자가 발행한 토큰은 플랫폼에서 선택한 기간(현재 24h로 설정) 동안 계속 신뢰할 수 있습니다. 이 기간은 시간에 따라 변경될 수 있습니다. 이를 통해 내부 구성 요소가 서비스 중단 없이 새 서비스 계정 발행자를 사용할 수 있습니다. |
|
| type은 사용 중인 클러스터의 사용자 관리 인증 모드를 식별합니다. 특히 로그인 시도에 응답하는 구성 요소를 관리합니다. 기본값은 IntegratedOAuth입니다. |
|
| webhookTokenAuthenticator는 원격 토큰 검토자를 구성합니다. 이러한 원격 인증 Webhook는 tokenreviews.authentication.k8s.io REST API를 통해 전달자 토큰을 확인하는 데 사용할 수 있습니다. 이는 외부 인증 서비스에서 프로비저닝한 전달자 토큰을 준수하는 데 필요합니다. "Type"이 "None"으로 설정된 경우에만 설정할 수 있습니다. |
|
| webhookTokenAuthenticators는 DEPRECATED이며 설정해도 적용되지 않습니다. |
|
| deprecatedWebhookTokenAuthenticator에는 원격 토큰 인증기에 필요한 구성 옵션이 있습니다. 이는 WebhookTokenAuthenticator와 동일하지만 KubeConfig 필드에 대한 '필수' 검증이 누락되어 있습니다. |
3.1.2. .spec.oauthMetadata
- 설명
- oauthMetadata에는 외부 OAuth 서버의 OAuth 2.0 인증 서버 메타데이터에 대한 검색 끝점 데이터가 포함되어 있습니다. 이 검색 문서는 제공된 위치에서 확인할 수 있습니다. oc get --raw '/.well-known/oauth-authorization-server' 자세한 내용은 IETF Draft: https://tools.ietf.org/html/draft-ietf-oauth-discovery-04#section-2 If oauthMetadata.name is non-empty, this value has precedence over any metadata reference stored in status. "oauthMetadata" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 메타데이터가 제공되지 않습니다. 지정된 메타데이터가 유효하지 않으면 메타데이터가 제공되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
3.1.3. .spec.webhookTokenAuthenticator
- 설명
- webhookTokenAuthenticator는 원격 토큰 검토자를 구성합니다. 이러한 원격 인증 Webhook는 tokenreviews.authentication.k8s.io REST API를 통해 전달자 토큰을 확인하는 데 사용할 수 있습니다. 이는 외부 인증 서비스에서 프로비저닝한 전달자 토큰을 준수하는 데 필요합니다. "Type"이 "None"으로 설정된 경우에만 설정할 수 있습니다.
- 유형
-
object
- 필수 항목
-
kubeConfig
-
속성 | 유형 | 설명 |
---|---|---|
|
| kubeconfig는 원격 Webhook 서비스에 액세스하는 방법을 설명하는 kube 구성 파일 데이터가 포함된 시크릿을 참조합니다. 참조된 시크릿의 네임스페이스는 openshift-config입니다. 자세한 내용은 https://kubernetes.io/docs/reference/access-authn-authz/authentication/#webhook-token-authentication 키를 사용하여 데이터를 찾습니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 Webhook가 적용되지 않습니다. 지정된 kube 구성 데이터가 유효하지 않으면 Webhook가 적용되지 않습니다. |
3.1.4. .spec.webhookTokenAuthenticator.kubeConfig
- 설명
- kubeconfig는 원격 Webhook 서비스에 액세스하는 방법을 설명하는 kube 구성 파일 데이터가 포함된 시크릿을 참조합니다. 참조된 시크릿의 네임스페이스는 openshift-config입니다. 자세한 내용은 https://kubernetes.io/docs/reference/access-authn-authz/authentication/#webhook-token-authentication 키를 사용하여 데이터를 찾습니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 Webhook가 적용되지 않습니다. 지정된 kube 구성 데이터가 유효하지 않으면 Webhook가 적용되지 않습니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
3.1.5. .spec.webhookTokenAuthenticators
- 설명
- webhookTokenAuthenticators는 DEPRECATED이며 설정해도 적용되지 않습니다.
- 유형
-
array
3.1.6. .spec.webhookTokenAuthenticators[]
- 설명
- deprecatedWebhookTokenAuthenticator에는 원격 토큰 인증기에 필요한 구성 옵션이 있습니다. 이는 WebhookTokenAuthenticator와 동일하지만 KubeConfig 필드에 대한 '필수' 검증이 누락되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| kubeconfig에는 원격 Webhook 서비스에 액세스하는 방법을 설명하는 kube 구성 파일 데이터가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/reference/access-authn-authz/authentication/#webhook-token-authentication 키를 사용하여 데이터를 찾습니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 Webhook가 적용되지 않습니다. 지정된 kube 구성 데이터가 유효하지 않으면 Webhook가 적용되지 않습니다. 이 보안의 네임스페이스는 사용 지점에 따라 결정됩니다. |
3.1.7. .spec.webhookTokenAuthenticators[].kubeConfig
- 설명
- kubeconfig에는 원격 Webhook 서비스에 액세스하는 방법을 설명하는 kube 구성 파일 데이터가 포함되어 있습니다. 자세한 내용은 https://kubernetes.io/docs/reference/access-authn-authz/authentication/#webhook-token-authentication 키를 사용하여 데이터를 찾습니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 Webhook가 적용되지 않습니다. 지정된 kube 구성 데이터가 유효하지 않으면 Webhook가 적용되지 않습니다. 이 보안의 네임스페이스는 사용 지점에 따라 결정됩니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
3.1.8. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| integratedOAuthMetadata에는 클러스터 내 통합 OAuth 서버의 OAuth 2.0 인증 서버 메타데이터에 대한 검색 끝점 데이터가 포함되어 있습니다. 이 검색 문서는 제공된 위치에서 확인할 수 있습니다. oc get --raw '/.well-known/oauth-authorization-server' 자세한 내용은 IETF Draft: https://tools.ietf.org/html/draft-ietf-oauth-discovery-04#section-2 클러스터 상태를 기반으로 관찰된 값이 포함되어 있습니다. spec.oauthMetadata에서 명시적으로 설정된 값이 이 필드보다 우선합니다. 인증 spec.type이 IntegratedOAuth로 설정되지 않은 경우 이 필드는 의미가 없습니다. "oauthMetadata" 키는 데이터를 찾는 데 사용됩니다. 구성 맵 또는 예상 키를 찾을 수 없는 경우 메타데이터가 제공되지 않습니다. 지정된 메타데이터가 유효하지 않으면 메타데이터가 제공되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config-managed입니다. |
3.1.9. .status.integratedOAuthMetadata
- 설명
- integratedOAuthMetadata에는 클러스터 내 통합 OAuth 서버의 OAuth 2.0 인증 서버 메타데이터에 대한 검색 끝점 데이터가 포함되어 있습니다. 이 검색 문서는 제공된 위치에서 확인할 수 있습니다. oc get --raw '/.well-known/oauth-authorization-server' 자세한 내용은 IETF Draft: https://tools.ietf.org/html/draft-ietf-oauth-discovery-04#section-2 클러스터 상태를 기반으로 관찰된 값이 포함되어 있습니다. spec.oauthMetadata에서 명시적으로 설정된 값이 이 필드보다 우선합니다. 인증 spec.type이 IntegratedOAuth로 설정되지 않은 경우 이 필드는 의미가 없습니다. "oauthMetadata" 키는 데이터를 찾는 데 사용됩니다. 구성 맵 또는 예상 키를 찾을 수 없는 경우 메타데이터가 제공되지 않습니다. 지정된 메타데이터가 유효하지 않으면 메타데이터가 제공되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config-managed입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
3.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/authentications
-
DELETE
: 인증 컬렉션 삭제 -
GET
: 종류의 인증 오브젝트 나열 -
POST
: 인증 생성
-
/apis/config.openshift.io/v1/authentications/{name}
-
DELETE
: 인증 삭제 -
GET
: 지정된 인증 읽기 -
PATCH
: 지정된 인증을 부분적으로 업데이트 -
PUT
: 지정된 인증을 교체
-
/apis/config.openshift.io/v1/authentications/{name}/status
-
GET
: 지정된 인증의 읽기 상태 -
PATCH
: 지정된 인증의 부분적으로 업데이트됨 -
PUT
: 지정된 인증의 상태
-
3.2.1. /apis/config.openshift.io/v1/authentications
- HTTP 방법
-
DELETE
- 설명
- 인증 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 인증 유형 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 인증 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
3.2.2. /apis/config.openshift.io/v1/authentications/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 인증의 이름 |
- HTTP 방법
-
DELETE
- 설명
- 인증 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 인증 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 인증을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 인증 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
3.2.3. /apis/config.openshift.io/v1/authentications/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 인증의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 인증의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 인증의 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 인증의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4장. 빌드 [config.openshift.io/v1]
- 설명
- build는 전체 클러스터에 대한 OpenShift 빌드 동작을 구성합니다. 여기에는 BuildConfig 오브젝트에서 재정의할 수 있는 기본 설정이 포함되며 모든 빌드에 적용되는 덮어쓰기가 포함됩니다. 표준 이름은 "클러스터" 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴) 용 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
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 | |
|
| spec에는 빌드 컨트롤러 구성에 대한 사용자 설정 가능 값이 있습니다. |
4.1.1. .spec
- 설명
- spec에는 빌드 컨트롤러 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| additionalTrustedCA는 빌드 중에 이미지 푸시 및 가져오기에 대해 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. DEPRECATED: 이미지 가져오기 및 푸시를 위한 추가 CA는 대신 image.config.openshift.io/cluster에 설정해야 합니다. |
|
| BuildDefaults는 빌드의 기본 정보를 제어합니다. |
|
| BuildOverrides는 빌드에 대한 덮어쓰기 설정 제어 |
4.1.2. .spec.additionalTrustedCA
- 설명
- additionalTrustedCA는 빌드 중에 이미지 푸시 및 가져오기에 대해 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. DEPRECATED: 이미지 가져오기 및 푸시를 위한 추가 CA는 대신 image.config.openshift.io/cluster에 설정해야 합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
4.1.3. .spec.buildDefaults
- 설명
- BuildDefaults는 빌드의 기본 정보를 제어합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
DefaultProxy에는 이미지 풀/push 및 소스 다운로드를 포함하여 모든 빌드 작업에 대한 기본 프록시 설정이 포함되어 있습니다. 빌드 구성의 전략에 |
|
| env는 지정된 변수가 빌드에 없는 경우 빌드에 적용되는 기본 환경 변수 세트입니다. |
|
| EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다. |
|
| GitProxy에는 git 작업에 대한 프록시 설정만 포함되어 있습니다. 설정하면 git clone과 같은 모든 git 명령의 모든 프록시 설정을 덮어씁니다. 여기에 설정되지 않은 값은 DefaultProxy에서 상속됩니다. |
|
| imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자는 Build/BuildConfig에 동일한 이름으로 라벨을 제공하여 기본 레이블을 덮어쓸 수 있습니다. |
|
| |
|
| resources는 빌드를 실행하기 위한 리소스 요구 사항을 정의합니다. |
4.1.4. .spec.buildDefaults.defaultProxy
- 설명
-
DefaultProxy에는 이미지 풀/push 및 소스 다운로드를 포함하여 모든 빌드 작업에 대한 기본 프록시 설정이 포함되어 있습니다. 빌드 구성의 전략에
HTTP_PROXY
,HTTPS_PROXY
및NO_PROXY
환경 변수를 설정하여 값을 덮어쓸 수 있습니다. - 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| httpsProxy는 HTTPS 요청의 프록시 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 및/또는 IP 목록입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| readinessEndpoints는 프록시 준비 상태를 확인하는 데 사용되는 끝점 목록입니다. |
|
| trustedCA는 CA 인증서 번들이 포함된 ConfigMap에 대한 참조입니다. trustedCA 필드는 프록시 검증기에서만 사용해야 합니다. 검증자는 필수 키 "ca-bundle.crt"에서 인증서 번들을 읽고 시스템 기본 신뢰 번들과 병합한 후 "openshift-config-managed" 네임스페이스의 "trusted-ca-bundle"이라는 ConfigMap에 병합된 신뢰 번들을 작성합니다. 프록시 연결을 수행할 것으로 예상되는 클라이언트는 프록시에 대한 모든 HTTPS 요청에 trusted-ca-bundle을 사용해야 하며, 프록시 이외의 HTTPS 요청에도 trusted-ca-bundle을 사용할 수 있습니다. trustedCA에서 참조하는 ConfigMap의 네임스페이스는 "openshift-config"입니다. 다음은 ConfigMap (in yaml): apiVersion: v1 kind: ConfigMap metadata: name: user-ca-bundle namespace: openshift-config data: ca-bundle.crt: | -----BEGIN CERTIFICATE---- Custom CA 인증서 번들입니다. -----END CERTIFICATE------END CERTIFICATE------------ |
4.1.5. .spec.buildDefaults.defaultProxy.trustedCA
- 설명
- trustedCA는 CA 인증서 번들이 포함된 ConfigMap에 대한 참조입니다. trustedCA 필드는 프록시 검증기에서만 사용해야 합니다. 검증자는 필수 키 "ca-bundle.crt"에서 인증서 번들을 읽고 시스템 기본 신뢰 번들과 병합한 후 "openshift-config-managed" 네임스페이스의 "trusted-ca-bundle"이라는 ConfigMap에 병합된 신뢰 번들을 작성합니다. 프록시 연결을 수행할 것으로 예상되는 클라이언트는 프록시에 대한 모든 HTTPS 요청에 trusted-ca-bundle을 사용해야 하며, 프록시 이외의 HTTPS 요청에도 trusted-ca-bundle을 사용할 수 있습니다. trustedCA에서 참조하는 ConfigMap의 네임스페이스는 "openshift-config"입니다. 다음은 ConfigMap (in yaml): apiVersion: v1 kind: ConfigMap metadata: name: user-ca-bundle namespace: openshift-bundle.crt: ca-bundle.crt: \| -----BEGIN CERTIFICATE---- Custom CA 인증서 번들입니다. -----END CERTIFICATE-------END CERTIFICATE---------------------
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
4.1.6. .spec.buildDefaults.env
- 설명
- env는 지정된 변수가 빌드에 없는 경우 빌드에 적용되는 기본 환경 변수 세트입니다.
- 유형
-
array
4.1.7. .spec.buildDefaults.env[]
- 설명
- EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| 환경 변수의 이름입니다. C_IDENTIFIER여야 합니다. |
|
| 변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다. |
|
| 환경 변수의 값의 소스입니다. 값이 비어 있지 않은 경우 사용할 수 없습니다. |
4.1.8. .spec.buildDefaults.env[].valueFrom
- 설명
- 환경 변수의 값의 소스입니다. 값이 비어 있지 않은 경우 사용할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConfigMap의 키를 선택합니다. |
|
|
Pod의 필드를 선택합니다. 은 metadata.name, metadata.namespace, |
|
| 컨테이너의 리소스 선택: 리소스 제한 및 요청(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory, requests.ephemeral-storage)만 현재 지원됩니다. |
|
| Pod의 네임스페이스에서 시크릿 키 선택 |
4.1.9. .spec.buildDefaults.env[].valueFrom.configMapKeyRef
- 설명
- ConfigMap의 키를 선택합니다.
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 키입니다. |
|
|
추천자의 이름입니다. 이 필드는 효과적으로 필요하지만 이전 버전과의 호환성으로 인해 비어 있을 수 있습니다. 여기에 빈 값이 있는 이 유형의 인스턴스는 거의 잘못된 것입니다. TODO: 다른 유용한 필드를 추가합니다. apiVersion, kind, uid? 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: controller-gen이 https://github.com/kubernetes-sigs/kubebuilder/issues/3896 가 필요하지 않은 경우 Drop |
|
| ConfigMap 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
4.1.10. .spec.buildDefaults.env[].valueFrom.fieldRef
- 설명
-
Pod의 필드를 선택합니다. 은 metadata.name, metadata.namespace,
metadata.labels['<KEY>']
,metadata.annotations['<KEY>']
, spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs를 선택합니다. - 유형
-
object
- 필수 항목
-
fieldPath
-
속성 | 유형 | 설명 |
---|---|---|
|
| FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다. |
|
| 지정된 API 버전에서 선택할 필드의 경로입니다. |
4.1.11. .spec.buildDefaults.env[].valueFrom.resourceFieldRef
- 설명
- 컨테이너의 리소스 선택: 리소스 제한 및 요청(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory, requests.ephemeral-storage)만 현재 지원됩니다.
- 유형
-
object
- 필수 항목
-
resource
-
속성 | 유형 | 설명 |
---|---|---|
|
| 컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항 |
|
| 노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다. |
|
| 필수: 선택할 리소스 |
4.1.12. .spec.buildDefaults.env[].valueFrom.secretKeyRef
- 설명
- Pod의 네임스페이스에서 시크릿 키 선택
- 유형
-
object
- 필수 항목
-
key
-
속성 | 유형 | 설명 |
---|---|---|
|
| 선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다. |
|
|
추천자의 이름입니다. 이 필드는 효과적으로 필요하지만 이전 버전과의 호환성으로 인해 비어 있을 수 있습니다. 여기에 빈 값이 있는 이 유형의 인스턴스는 거의 잘못된 것입니다. TODO: 다른 유용한 필드를 추가합니다. apiVersion, kind, uid? 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: controller-gen이 https://github.com/kubernetes-sigs/kubebuilder/issues/3896 가 필요하지 않은 경우 Drop |
|
| 시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다. |
4.1.13. .spec.buildDefaults.gitProxy
- 설명
- GitProxy에는 git 작업에 대한 프록시 설정만 포함되어 있습니다. 설정하면 git clone과 같은 모든 git 명령의 모든 프록시 설정을 덮어씁니다. 여기에 설정되지 않은 값은 DefaultProxy에서 상속됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| httpsProxy는 HTTPS 요청의 프록시 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 및/또는 IP 목록입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| readinessEndpoints는 프록시 준비 상태를 확인하는 데 사용되는 끝점 목록입니다. |
|
| trustedCA는 CA 인증서 번들이 포함된 ConfigMap에 대한 참조입니다. trustedCA 필드는 프록시 검증기에서만 사용해야 합니다. 검증자는 필수 키 "ca-bundle.crt"에서 인증서 번들을 읽고 시스템 기본 신뢰 번들과 병합한 후 "openshift-config-managed" 네임스페이스의 "trusted-ca-bundle"이라는 ConfigMap에 병합된 신뢰 번들을 작성합니다. 프록시 연결을 수행할 것으로 예상되는 클라이언트는 프록시에 대한 모든 HTTPS 요청에 trusted-ca-bundle을 사용해야 하며, 프록시 이외의 HTTPS 요청에도 trusted-ca-bundle을 사용할 수 있습니다. trustedCA에서 참조하는 ConfigMap의 네임스페이스는 "openshift-config"입니다. 다음은 ConfigMap (in yaml): apiVersion: v1 kind: ConfigMap metadata: name: user-ca-bundle namespace: openshift-config data: ca-bundle.crt: | -----BEGIN CERTIFICATE---- Custom CA 인증서 번들입니다. -----END CERTIFICATE------END CERTIFICATE------------ |
4.1.14. .spec.buildDefaults.gitProxy.trustedCA
- 설명
- trustedCA는 CA 인증서 번들이 포함된 ConfigMap에 대한 참조입니다. trustedCA 필드는 프록시 검증기에서만 사용해야 합니다. 검증자는 필수 키 "ca-bundle.crt"에서 인증서 번들을 읽고 시스템 기본 신뢰 번들과 병합한 후 "openshift-config-managed" 네임스페이스의 "trusted-ca-bundle"이라는 ConfigMap에 병합된 신뢰 번들을 작성합니다. 프록시 연결을 수행할 것으로 예상되는 클라이언트는 프록시에 대한 모든 HTTPS 요청에 trusted-ca-bundle을 사용해야 하며, 프록시 이외의 HTTPS 요청에도 trusted-ca-bundle을 사용할 수 있습니다. trustedCA에서 참조하는 ConfigMap의 네임스페이스는 "openshift-config"입니다. 다음은 ConfigMap (in yaml): apiVersion: v1 kind: ConfigMap metadata: name: user-ca-bundle namespace: openshift-bundle.crt: ca-bundle.crt: \| -----BEGIN CERTIFICATE---- Custom CA 인증서 번들입니다. -----END CERTIFICATE-------END CERTIFICATE---------------------
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
4.1.15. .spec.buildDefaults.imageLabels
- 설명
- imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자는 Build/BuildConfig에 동일한 이름으로 라벨을 제공하여 기본 레이블을 덮어쓸 수 있습니다.
- 유형
-
array
4.1.16. .spec.buildDefaults.imageLabels[]
- 설명
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다. |
|
| value는 레이블의 리터럴 값을 정의합니다. |
4.1.17. .spec.buildDefaults.resources
- 설명
- resources는 빌드를 실행하기 위한 리소스 요구 사항을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 클레임은 이 컨테이너에서 사용하는 spec.resourceClaims에 정의된 리소스의 이름을 나열합니다. 이 필드는 alpha 필드이며 DynamicResourceAllocation 기능 게이트를 활성화해야 합니다. 이 필드는 변경할 수 없습니다. 컨테이너에 대해서만 설정할 수 있습니다. |
|
| ResourceClaim은 PodSpec.ResourceClaims에서 하나의 항목을 참조합니다. |
|
| 제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
|
| 요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 Requests를 생략하면 구현 정의된 값을 제외하고 명시적으로 지정된 경우 기본값은 Limits로 설정됩니다. 요청은 제한을 초과할 수 없습니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ |
4.1.18. .spec.buildDefaults.resources.claims
- 설명
- 클레임은 이 컨테이너에서 사용하는 spec.resourceClaims에 정의된 리소스의 이름을 나열합니다. 이 필드는 alpha 필드이며 DynamicResourceAllocation 기능 게이트를 활성화해야 합니다. 이 필드는 변경할 수 없습니다. 컨테이너에 대해서만 설정할 수 있습니다.
- 유형
-
array
4.1.19. .spec.buildDefaults.resources.claims[]
- 설명
- ResourceClaim은 PodSpec.ResourceClaims에서 하나의 항목을 참조합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 이 필드가 사용되는 Pod의 pod.spec.resourceClaims에서 하나의 항목 이름과 일치해야 합니다. 컨테이너 내에서 해당 리소스를 사용할 수 있도록 합니다. |
4.1.20. .spec.buildOverrides
- 설명
- BuildOverrides는 빌드에 대한 덮어쓰기 설정 제어
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| forcePull overrides, if set, the equivalent value in the builds, i.e. false disables force pull for all builds, true enables force pull for all builds, independently of each build specifies itself |
|
| imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자가 이 목록에 있는 것과 동일한 이름으로 Build/BuildConfig에 레이블을 제공한 경우 사용자의 레이블을 덮어씁니다. |
|
| |
|
| nodeSelector는 빌드 Pod가 노드에 적합하도록 true여야 하는 선택기입니다. |
|
| 허용 오차는 빌드 Pod에 설정된 기존 허용 오차를 재정의하는 허용 목록입니다. |
|
| 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다. |
4.1.21. .spec.buildOverrides.imageLabels
- 설명
- imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자가 이 목록에 있는 것과 동일한 이름으로 Build/BuildConfig에 레이블을 제공한 경우 사용자의 레이블을 덮어씁니다.
- 유형
-
array
4.1.22. .spec.buildOverrides.imageLabels[]
- 설명
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 레이블의 이름을 정의합니다. 길이가 0이 아니어야 합니다. |
|
| value는 레이블의 리터럴 값을 정의합니다. |
4.1.23. .spec.buildOverrides.tolerations
- 설명
- 허용 오차는 빌드 Pod에 설정된 기존 허용 오차를 재정의하는 허용 목록입니다.
- 유형
-
array
4.1.24. .spec.buildOverrides.tolerations[]
- 설명
- 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다. |
|
| 키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다. |
|
| Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다. |
|
| tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다. |
|
| 값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다. |
4.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/builds
-
DELETE
: Build의 컬렉션 삭제 -
GET
: 종류의 오브젝트 나열 -
POST
: 빌드 생성
-
/apis/config.openshift.io/v1/builds/{name}
-
DELETE
: 빌드를 삭제 -
GET
: 지정된 빌드 읽기 -
PATCH
: 지정된 빌드를 부분적으로 업데이트 -
PUT
: 지정된 빌드로 교체
-
/apis/config.openshift.io/v1/builds/{name}/status
-
GET
: 지정된 빌드의 읽기 상태 -
PATCH
: 지정된 빌드의 부분 업데이트 상태 -
PUT
: 지정된 빌드의 상태 교체
-
4.2.1. /apis/config.openshift.io/v1/builds
- HTTP 방법
-
DELETE
- 설명
- 빌드 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 빌드 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 빌드 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
4.2.2. /apis/config.openshift.io/v1/builds/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
- HTTP 방법
-
DELETE
- 설명
- 빌드 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 빌드 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Build를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 빌드로 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
4.2.3. /apis/config.openshift.io/v1/builds/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 빌드의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 빌드의 상태 확인
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 빌드의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 빌드의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
5장. ClusterOperator [config.openshift.io/v1]
- 설명
- ClusterOperator는 Operator의 현재 상태를 가지고 있는 Custom Resource 오브젝트입니다. Operator는 이 오브젝트를 사용하여 클러스터의 나머지 부분에 상태를 전달합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
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 | |
|
| spec에는 모든 Operator에 적용할 수 있는 구성이 있습니다. |
|
| 상태에는 Operator 상태에 대한 정보가 포함되어 있습니다. Kubernetes 에코시스템의 상태 정보와 일치합니다. |
5.1.1. .spec
- 설명
- spec에는 모든 Operator에 적용할 수 있는 구성이 있습니다.
- 유형
-
object
5.1.2. .status
- 설명
- 상태에는 Operator 상태에 대한 정보가 포함되어 있습니다. Kubernetes 에코시스템의 상태 정보와 일치합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 Operator의 관리 및 모니터링된 구성 요소의 상태를 설명합니다. |
|
| ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다. |
| `` | 확장에는 이 status 오브젝트를 소유한 Operator와 관련된 추가 상태 정보가 포함되어 있습니다. |
|
| relatedObjects는 이 연산자와 관련된 개체 목록입니다. 일반적인 용도는 1입니다. operator 2. operator 네임스페이스 3. 피연산자 네임스페이스를 구동하는 자세한 리소스 |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
|
| 버전은 operator 및 피연산자 버전 튜플의 슬라이스입니다. 여러 피연산자를 관리하는 연산자는 배열에 여러 피연산자 항목이 있습니다.Operators which manage multiple operands will have multiple operand entries in the array. 사용 가능한 Operator는 "operator"라는 이름으로 Operator 자체의 버전을 보고해야 합니다. Operator는 새 버전을 모든 피연산자에 롤아웃하면 새 "operator" 버전을 보고합니다. |
|
|
5.1.3. .status.conditions
- 설명
- 조건은 Operator의 관리 및 모니터링된 구성 요소의 상태를 설명합니다.
- 유형
-
array
5.1.4. .status.conditions[]
- 설명
- ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
lastTransitionTime
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| lastTransitionTime은 현재 상태 속성에 대한 마지막 업데이트 시간입니다. |
|
| message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다. |
|
| 이유는 조건의 현재 상태에 대한 CamelCase 이유입니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| type은 이 조건에서 보고한 측면을 지정합니다. |
5.1.7. .status.versions
- 설명
- 버전은 operator 및 피연산자 버전 튜플의 슬라이스입니다. 여러 피연산자를 관리하는 연산자는 배열에 여러 피연산자 항목이 있습니다.Operators which manage multiple operands will have multiple operand entries in the array. 사용 가능한 Operator는 "operator"라는 이름으로 Operator 자체의 버전을 보고해야 합니다. Operator는 새 버전을 모든 피연산자에 롤아웃하면 새 "operator" 버전을 보고합니다.
- 유형
-
array
5.1.8. .status.versions[]
- 설명
- 유형
-
object
- 필수 항목
-
name
-
version
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 이 버전이 있는 특정 피연산자의 이름입니다. 일반적으로 Operator가 아닌 컨테이너 이미지와 일치합니다. |
|
| version은 현재 관리 중인 특정 피연산자의 버전을 나타냅니다. 항상 사용 가능한 피연산자와 일치해야 합니다. 1.0.0이 Available인 경우 Operator가 1.1.0을 롤아웃하려고 하는 경우에도 1.0.0을 표시해야 합니다. |
5.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/clusteroperators
-
DELETE
: ClusterOperator의 컬렉션 삭제 -
GET
: ClusterOperator 유형의 오브젝트 나열 -
POST
: ClusterOperator 생성
-
/apis/config.openshift.io/v1/clusteroperators/{name}
-
DELETE
: ClusterOperator 삭제 -
GET
: 지정된 ClusterOperator 읽기 -
PATCH
: 지정된 ClusterOperator를 부분적으로 업데이트 -
PUT
: 지정된 ClusterOperator를 교체
-
/apis/config.openshift.io/v1/clusteroperators/{name}/status
-
GET
: 지정된 ClusterOperator의 읽기 상태 -
PATCH
: 지정된 ClusterOperator의 부분적으로 업데이트 상태 -
PUT
: 지정된 ClusterOperator의 상태 교체
-
5.2.1. /apis/config.openshift.io/v1/clusteroperators
- HTTP 방법
-
DELETE
- 설명
- ClusterOperator의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ClusterOperator 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ClusterOperator 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
5.2.2. /apis/config.openshift.io/v1/clusteroperators/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ClusterOperator의 이름 |
- HTTP 방법
-
DELETE
- 설명
- ClusterOperator 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ClusterOperator 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ClusterOperator를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ClusterOperator를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
5.2.3. /apis/config.openshift.io/v1/clusteroperators/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ClusterOperator의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 ClusterOperator의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ClusterOperator의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ClusterOperator의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6장. ClusterVersion [config.openshift.io/v1]
- 설명
- ClusterVersion은 ClusterVersionOperator의 구성입니다. 여기에서 자동 업데이트와 관련된 매개변수를 설정할 수 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
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 | |
|
| spec은 클러스터 버전의 원하는 상태입니다. Operator는 원하는 버전이 클러스터에 적용되도록 작동합니다. |
|
| 상태에는 사용 가능한 업데이트 및 진행 중인 업데이트에 대한 정보가 포함되어 있습니다. |
6.1.1. .spec
- 설명
- spec은 클러스터 버전의 원하는 상태입니다. Operator는 원하는 버전이 클러스터에 적용되도록 작동합니다.
- 유형
-
object
- 필수 항목
-
clusterID
-
속성 | 유형 | 설명 |
---|---|---|
|
| 기능은 선택적 핵심 클러스터 구성 요소의 설치를 구성합니다. 여기에 null 값은 빈 개체와 동일합니다. 기본 의미 체계에 대한 하위 속성을 참조하십시오. |
|
| 채널은 기본이 아닌 업데이트 세트가 이 클러스터에 적용되도록 명시적으로 요청하는 식별자입니다. 기본 채널에는 프로덕션 클러스터에 적합한 안정적인 업데이트가 포함됩니다. |
|
| ClusterID는 이 클러스터를 고유하게 식별합니다. 이는 RFC4122 UUID 값(16진수 값의 xxxx xxxx-xxxx-xxxxxxxx)이어야 합니다. 이 필드는 필수 항목입니다. |
|
| desiredUpdate는 클러스터 버전의 원하는 값을 나타내는 선택적 필드입니다. 이 값을 설정하면 업그레이드가 트리거됩니다(현재 버전이 원하는 버전과 일치하지 않는 경우). 권장 업데이트 값 세트는 상태에 사용 가능한 업데이트의 일부로 나열되며 해당 범위를 벗어나는 값을 설정하면 업그레이드가 실패할 수 있습니다. 필드 중 일부는 여기에 설명된 제한 및 의미와 관련이 있습니다. 1. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정됩니다. API 검증 오류. 2. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 이 작업을 수행하지 않아야 합니다. 버전은 자동으로 무시되고 이미지가 사용됩니다. 3. 이미지가 지정되고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 4. 이미지가 지정되고 버전이 지정되지 않으며, 아키텍처가 지정되지 않았습니다. 이미지가 사용됩니다. 5. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정됩니다. 버전 및 원하는 아키텍처는 이미지를 선택하는 데 사용됩니다. 6. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 버전 및 현재 아키텍처는 이미지를 선택하는 데 사용됩니다. 7. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 8. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정되지 않습니다. API 검증 오류. 업그레이드에 실패하면 Operator가 중지되고 실패한 구성 요소에 대한 상태를 보고합니다. 원하는 업데이트 값을 이전 버전으로 다시 설정하면 롤백이 수행됩니다. 모든 롤백이 성공하는 것은 아닙니다. |
|
| 덮어쓰기는 클러스터 버전 Operator에서 관리하는 구성 요소에 대한 덮어쓰기 목록입니다. 구성 요소를 비관리적으로 표시하면 Operator가 개체를 만들거나 업데이트할 수 없습니다. |
|
| ComponentOverride를 사용하면 구성 요소에 대한 클러스터 버전 Operator의 동작을 덮어쓸 수 있습니다. |
|
| 업스트림을 사용하여 기본 업데이트 서버를 지정할 수 있습니다. 기본적으로 클러스터 및 지역에 적절한 업데이트 서버를 사용합니다. |
6.1.2. .spec.capabilities
- 설명
- 기능은 선택적 핵심 클러스터 구성 요소의 설치를 구성합니다. 여기에 null 값은 빈 개체와 동일합니다. 기본 의미 체계에 대한 하위 속성을 참조하십시오.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| additionalEnabledCapabilities는 baselineCapabilitySet에 정의된 기준 이상으로 관리되는 기능 세트를 확장합니다. 기본값은 빈 세트입니다. |
|
| baselineCapabilitySet은 활성화할 선택적 기능 세트를 선택합니다. 이 기능은 additionalEnabledCapabilities를 통해 확장할 수 있습니다. 설정되지 않은 경우 클러스터는 기본값을 선택하고 시간이 지남에 따라 기본값이 변경될 수 있습니다. 현재 기본값은 v current입니다. |
6.1.3. .spec.desiredUpdate
- 설명
- desiredUpdate는 클러스터 버전의 원하는 값을 나타내는 선택적 필드입니다. 이 값을 설정하면 업그레이드가 트리거됩니다(현재 버전이 원하는 버전과 일치하지 않는 경우). 권장 업데이트 값 세트는 상태에 사용 가능한 업데이트의 일부로 나열되며 해당 범위를 벗어나는 값을 설정하면 업그레이드가 실패할 수 있습니다. 필드 중 일부는 여기에 설명된 제한 및 의미와 관련이 있습니다. 1. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정됩니다. API 검증 오류. 2. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 이 작업을 수행하지 않아야 합니다. 버전은 자동으로 무시되고 이미지가 사용됩니다. 3. 이미지가 지정되고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 4. 이미지가 지정되고 버전이 지정되지 않으며, 아키텍처가 지정되지 않았습니다. 이미지가 사용됩니다. 5. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정됩니다. 버전 및 원하는 아키텍처는 이미지를 선택하는 데 사용됩니다. 6. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 버전 및 현재 아키텍처는 이미지를 선택하는 데 사용됩니다. 7. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 8. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정되지 않습니다. API 검증 오류. 업그레이드에 실패하면 Operator가 중지되고 실패한 구성 요소에 대한 상태를 보고합니다. 원하는 업데이트 값을 이전 버전으로 다시 설정하면 롤백이 수행됩니다. 모든 롤백이 성공하는 것은 아닙니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 아키텍처는 클러스터 아키텍처의 원하는 값을 나타내는 선택적 필드입니다. 이 컨텍스트 클러스터 아키텍처에서는 단일 아키텍처 또는 다중 아키텍처를 의미합니다. 아키텍처는 Multi로만 설정할 수 있으므로 단일에서 다중 아키텍처로만 업데이트할 수 있습니다. 아키텍처가 설정된 경우 이미지를 설정할 수 없으며 버전을 설정해야 합니다. 유효한 값은 'Multi'이며 비어 있습니다. |
|
| 강제를 사용하면 관리자가 확인 실패 또는 업그레이드 가능한 검사가 있는 이미지로 업데이트할 수 있습니다. 제공된 이미지가 클러스터에 대한 전체 관리 액세스 권한으로 실행되므로 이 옵션은 제공된 이미지의 진위 여부를 대역에서 확인할 때만 사용해야 합니다. 알 수 없거나 잠재적으로 악의적인 소스에서 제공되는 이미지에 이 플래그를 사용하지 마십시오. |
|
| 이미지는 업데이트가 포함된 컨테이너 이미지 위치입니다. 원하는 버전이 availableUpdates 또는 history에 없는 경우 이미지를 사용해야 합니다. image가 설정되면 버전이 무시됩니다. image가 설정되면 버전이 비어 있어야 합니다. 이미지가 설정되면 아키텍처를 지정할 수 없습니다. |
|
| 버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 아키텍처가 지정된 경우 image가 지정되고 필요한 경우 버전이 무시됩니다. |
6.1.4. .spec.overrides
- 설명
- 덮어쓰기는 클러스터 버전 Operator에서 관리하는 구성 요소에 대한 덮어쓰기 목록입니다. 구성 요소를 비관리적으로 표시하면 Operator가 개체를 만들거나 업데이트할 수 없습니다.
- 유형
-
array
6.1.5. .spec.overrides[]
- 설명
- ComponentOverride를 사용하면 구성 요소에 대한 클러스터 버전 Operator의 동작을 덮어쓸 수 있습니다.
- 유형
-
object
- 필수 항목
-
group
-
kind
-
name
-
네임스페이스
-
Unmanaged
-
속성 | 유형 | 설명 |
---|---|---|
|
| group은 kind가 속한 API 그룹을 식별합니다. |
|
| kind는 재정의할 오브젝트를 들여쓰기합니다. |
|
| 구성 요소의 이름입니다. |
|
| 네임스페이스는 구성 요소의 네임스페이스입니다. 리소스가 클러스터 범위인 경우 네임스페이스가 비어 있어야 합니다. |
|
| 클러스터 버전 Operator가 이 클러스터의 리소스 관리를 중단해야 하는지 여부를 비관리 제어합니다. 기본값: false |
6.1.6. .status
- 설명
- 상태에는 사용 가능한 업데이트 및 진행 중인 업데이트에 대한 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
desired
-
observedGeneration
-
versionHash
-
속성 | 유형 | 설명 |
---|---|---|
| `` | availableUpdates에는 이 클러스터에 권장되는 업데이트가 포함되어 있습니다. conditionalUpdates에 표시되지만 availableUpdates에는 이 클러스터가 알려진 문제에 노출될 수 있습니다. 권장 업데이트가 없거나 업데이트 서비스를 사용할 수 없거나 잘못된 채널이 지정된 경우 이 목록이 비어 있을 수 있습니다. |
|
| 기능은 선택 사항인 핵심 클러스터 구성 요소의 상태를 설명합니다. |
|
| conditionalUpdates에는 특정 필수 조건을 충족하는 경우 이 클러스터에 권장되는 업데이트 목록이 포함되어 있습니다. 이 클러스터에 권장되는 업데이트 세트에 관심이 있는 소비자는 availableUpdates를 사용해야 합니다. 권장 업데이트가 없거나 업데이트 서비스를 사용할 수 없거나 비어 있거나 잘못된 채널이 지정된 경우 이 목록이 비어 있을 수 있습니다. |
|
| ConditionalUpdate는 현재 클러스터가 조정되어 있지만 현재 클러스터에 권장되지 않는 일부 클러스터에 권장되는 업데이트를 나타냅니다. |
|
| conditions는 클러스터 버전에 대한 정보를 제공합니다. desiredUpdate에 도달한 경우 "Available" 조건이 true로 설정됩니다. 업데이트가 적용되는 경우 "Progressing" 조건이 true로 설정됩니다. 현재 업데이트가 임시 또는 영구 오류로 차단되면 "Degraded" 조건이 true로 설정됩니다. 조건은 metadata.generation이 status.generation과 같은 경우 현재 desiredUpdate에만 유효합니다. |
|
| ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다. |
|
| 원하는 버전은 클러스터가 조정되는 버전입니다. 클러스터가 아직 완전히 초기화되지 않은 경우 사용 가능한 정보로 설정됩니다. 이 정보는 이미지 또는 태그일 수 있습니다. |
|
| 기록에는 클러스터에 적용된 최신 버전 목록이 포함되어 있습니다. 이 값은 클러스터를 시작하는 동안 비어 있을 수 있으며 새 업데이트가 적용되면 업데이트됩니다. 최신 업데이트는 목록의 첫 번째이며 업데이트 빈도에 따라 정렬됩니다. 롤아웃이 완료되면 기록의 업데이트 상태가 Completed로 표시됩니다 - 업데이트가 실패한 경우 또는 절반으로 적용된 상태가 Partial이 됩니다. 제한된 양의 업데이트 기록만 유지됩니다. |
|
| UpdateHistory는 클러스터의 시도된 단일 업데이트입니다. |
|
| observedGeneration은 동기화되는 사양 버전을 보고합니다. 이 값이 metadata.generation과 같지 않으면 원하는 및 조건 필드가 이전 버전을 나타낼 수 있습니다. |
|
| versionHash는 클러스터가 업데이트될 콘텐츠의 지문입니다. Operator는 불필요한 작업을 피하기 위해 사용되며 내부 용도로만 사용됩니다. |
6.1.7. .status.capabilities
- 설명
- 기능은 선택 사항인 핵심 클러스터 구성 요소의 상태를 설명합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| enabled 기능은 현재 관리되는 모든 기능을 나열합니다. |
|
| 알려진 기능은 현재 클러스터에 알려진 모든 기능을 나열합니다. |
6.1.8. .status.conditionalUpdates
- 설명
- conditionalUpdates에는 특정 필수 조건을 충족하는 경우 이 클러스터에 권장되는 업데이트 목록이 포함되어 있습니다. 이 클러스터에 권장되는 업데이트 세트에 관심이 있는 소비자는 availableUpdates를 사용해야 합니다. 권장 업데이트가 없거나 업데이트 서비스를 사용할 수 없거나 비어 있거나 잘못된 채널이 지정된 경우 이 목록이 비어 있을 수 있습니다.
- 유형
-
array
6.1.9. .status.conditionalUpdates[]
- 설명
- ConditionalUpdate는 현재 클러스터가 조정되어 있지만 현재 클러스터에 권장되지 않는 일부 클러스터에 권장되는 업데이트를 나타냅니다.
- 유형
-
object
- 필수 항목
-
릴리스
-
위험
-
속성 | 유형 | 설명 |
---|---|---|
|
| 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 [] |
|
| 릴리스는 업데이트의 대상입니다. |
|
| 위험은 대상 릴리스 업데이트와 관련된 문제의 범위를 나타냅니다. cluster-version Operator는 모든 항목을 평가하고 하나 이상의 항목이 있고 모든 항목이 업데이트를 권장하는 경우에만 업데이트를 권장합니다. |
|
| ConditionalUpdateRisk는 조건부 업데이트를 권장하지 않는 이유 및 cluster-state를 나타냅니다. |
6.1.10. .status.conditionalUpdates[].conditions
- 설명
- conditions는 조건부 업데이트의 현재 상태를 관찰하는 것을 나타냅니다. 알려진 유형은 현재 클러스터에 업데이트를 권장하는지 여부에 대한 권장 사항입니다.
- 유형
-
array
6.1.11. .status.conditionalUpdates[].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)입니다. |
6.1.12. .status.conditionalUpdates[].release
- 설명
- 릴리스는 업데이트의 대상입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 채널은 릴리스가 현재 속한 Cincinnati 채널의 집합입니다. |
|
| image는 업데이트가 포함된 컨테이너 이미지 위치입니다. 이 필드가 spec의 일부이면 version이 지정되고 availableUpdates 필드에 일치하는 버전이 포함된 경우 이미지는 선택 사항입니다. |
|
| URL에는 이 릴리스에 대한 정보가 포함되어 있습니다. 이 URL은 릴리스의 'url' 메타데이터 속성 또는 업데이트 API에서 반환된 메타데이터에 의해 설정되며 사용자 인터페이스에 링크로 표시되어야 합니다. 테스트 또는 야간 릴리스에 대해 URL 필드를 설정하지 않을 수 있습니다. |
|
| 버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 이 필드가 spec의 일부인 경우 이미지가 지정된 경우 버전이 선택 사항입니다. |
6.1.13. .status.conditionalUpdates[].risks
- 설명
- 위험은 대상 릴리스 업데이트와 관련된 문제의 범위를 나타냅니다. cluster-version Operator는 모든 항목을 평가하고 하나 이상의 항목이 있고 모든 항목이 업데이트를 권장하는 경우에만 업데이트를 권장합니다.
- 유형
-
array
6.1.14. .status.conditionalUpdates[].risks[]
- 설명
- ConditionalUpdateRisk는 조건부 업데이트를 권장하지 않는 이유 및 cluster-state를 나타냅니다.
- 유형
-
object
- 필수 항목
-
matchingRules
-
message
-
name
-
url
-
속성 | 유형 | 설명 |
---|---|---|
|
| matchingRules는 어떤 클러스터가 위험과 일치하지 않는지 결정하는 조건 조각입니다. 슬라이스는 우선순위를 줄임으로써 정렬됩니다. cluster-version Operator는 슬라이스를 순서대로 실행하고 첫 번째 평가를 수행한 후 중지합니다. 조건이 성공적으로 평가되지 않으면 업데이트가 권장되지 않습니다. |
|
| ClusterCondition은 입력된 클러스터 조건의 결합입니다. 'type' 속성은 관련 유형별 속성을 결정합니다. 클러스터에서 평가되면 조건이 일치하거나 일치하지 않거나 평가되지 않을 수 있습니다. |
|
| message는Rules가 클러스터 상태와 일치하는 경우 업데이트 위험에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다. |
|
| Rules가 클러스터 상태와 일치하는 경우 name은 조건부 업데이트를 권장하지 않는 CamelCase 이유입니다. |
|
| URL에는 이 위험에 대한 정보가 포함되어 있습니다. |
6.1.15. .status.conditionalUpdates[].risks[].matchingRules
- 설명
- matchingRules는 어떤 클러스터가 위험과 일치하지 않는지 결정하는 조건 조각입니다. 슬라이스는 우선순위를 줄임으로써 정렬됩니다. cluster-version Operator는 슬라이스를 순서대로 실행하고 첫 번째 평가를 수행한 후 중지합니다. 조건이 성공적으로 평가되지 않으면 업데이트가 권장되지 않습니다.
- 유형
-
array
6.1.16. .status.conditionalUpdates[].risks[].matchingRules[]
- 설명
- ClusterCondition은 입력된 클러스터 조건의 결합입니다. 'type' 속성은 관련 유형별 속성을 결정합니다. 클러스터에서 평가되면 조건이 일치하거나 일치하지 않거나 평가되지 않을 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| PromQL은 PromQL을 기반으로 하는 클러스터 조건을 나타냅니다. |
|
| type은 cluster-condition 유형을 나타냅니다. 이는 추가 속성의 멤버 및 의미 체계를 정의합니다. |
6.1.17. .status.conditionalUpdates[].risks[].matchingRules[].promql
- 설명
- PromQL은 PromQL을 기반으로 하는 클러스터 조건을 나타냅니다.
- 유형
-
object
- 필수 항목
-
promql
-
속성 | 유형 | 설명 |
---|---|---|
|
| PromQL은 클러스터를 분류하는 PromQL 쿼리입니다. 이 쿼리 쿼리는 일치 항목에 1을 반환하고 does-not-match 경우 0을 반환해야 합니다. 시계열을 반환하지 않거나 0 또는 1 이외의 값을 반환하는 쿼리는 평가 실패입니다. |
6.1.18. .status.conditions
- 설명
- conditions는 클러스터 버전에 대한 정보를 제공합니다. desiredUpdate에 도달한 경우 "Available" 조건이 true로 설정됩니다. 업데이트가 적용되는 경우 "Progressing" 조건이 true로 설정됩니다. 현재 업데이트가 임시 또는 영구 오류로 차단되면 "Degraded" 조건이 true로 설정됩니다. 조건은 metadata.generation이 status.generation과 같은 경우 현재 desiredUpdate에만 유효합니다.
- 유형
-
array
6.1.19. .status.conditions[]
- 설명
- ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다.
- 유형
-
object
- 필수 항목
-
lastTransitionTime
-
status
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| lastTransitionTime은 현재 상태 속성에 대한 마지막 업데이트 시간입니다. |
|
| message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다. |
|
| 이유는 조건의 현재 상태에 대한 CamelCase 이유입니다. |
|
| 조건의 상태, True, False, 알 수 없음. |
|
| type은 이 조건에서 보고한 측면을 지정합니다. |
6.1.20. .status.desired
- 설명
- 원하는 버전은 클러스터가 조정되는 버전입니다. 클러스터가 아직 완전히 초기화되지 않은 경우 사용 가능한 정보로 설정됩니다. 이 정보는 이미지 또는 태그일 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 채널은 릴리스가 현재 속한 Cincinnati 채널의 집합입니다. |
|
| image는 업데이트가 포함된 컨테이너 이미지 위치입니다. 이 필드가 spec의 일부이면 version이 지정되고 availableUpdates 필드에 일치하는 버전이 포함된 경우 이미지는 선택 사항입니다. |
|
| URL에는 이 릴리스에 대한 정보가 포함되어 있습니다. 이 URL은 릴리스의 'url' 메타데이터 속성 또는 업데이트 API에서 반환된 메타데이터에 의해 설정되며 사용자 인터페이스에 링크로 표시되어야 합니다. 테스트 또는 야간 릴리스에 대해 URL 필드를 설정하지 않을 수 있습니다. |
|
| 버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 이 필드가 spec의 일부인 경우 이미지가 지정된 경우 버전이 선택 사항입니다. |
6.1.21. .status.history
- 설명
- 기록에는 클러스터에 적용된 최신 버전 목록이 포함되어 있습니다. 이 값은 클러스터를 시작하는 동안 비어 있을 수 있으며 새 업데이트가 적용되면 업데이트됩니다. 최신 업데이트는 목록의 첫 번째이며 업데이트 빈도에 따라 정렬됩니다. 롤아웃이 완료되면 기록의 업데이트 상태가 Completed로 표시됩니다 - 업데이트가 실패한 경우 또는 절반으로 적용된 상태가 Partial이 됩니다. 제한된 양의 업데이트 기록만 유지됩니다.
- 유형
-
array
6.1.22. .status.history[]
- 설명
- UpdateHistory는 클러스터의 시도된 단일 업데이트입니다.
- 유형
-
object
- 필수 항목
-
image
-
startedTime
-
상태
-
검증됨
-
속성 | 유형 | 설명 |
---|---|---|
|
| acceptedRisks는 업데이트를 시작하기 위해 허용되는 위험을 기록합니다. 예를 들어 Upgradeable=False 또는 desiredUpdate.force를 통해 재정의된 서명이 누락되거나 권장 업데이트 대상 세트의 availableUpdates 세트에 없는 업데이트가 시작될 수 있습니다. |
| `` | completionTime이 설정되면 업데이트가 완전히 적용된 것입니다. 현재 적용 중인 업데이트에는 null 완료 시간이 있습니다. 완료 시간은 현재 업데이트가 아닌 항목에 대해 항상 설정됩니다(일반적으로 다음 업데이트의 시작 시점까지). |
|
| image는 업데이트가 포함된 컨테이너 이미지 위치입니다. 이 값은 항상 채워집니다. |
|
| startedTime은 업데이트가 시작된 시간입니다. |
|
| 상태는 업데이트가 완전히 적용되었는지 여부를 반영합니다. Partial 상태는 업데이트가 완전히 적용되지 않았음을 나타내며 Completed 상태는 업데이트가 한 번 이상 롤아웃되었음을 나타냅니다(업데이트의 모든 부분이 성공적으로 적용됨). |
|
| verified는 설치 전에 제공된 업데이트가 올바르게 확인되었는지 여부를 나타냅니다. false인 경우 클러스터를 신뢰할 수 없습니다. 확인은 업데이트 대상이 수락될 때 클러스터 상태에 따라 달라지는 업그레이드 가능한 검사에는 적용되지 않습니다. |
|
| 버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 요청된 이미지가 버전을 정의하지 않거나 이미지를 검색하는 동안 오류가 발생하면 이 값이 비어 있을 수 있습니다. |
6.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/clusterversions
-
DELETE
: ClusterVersion의 컬렉션 삭제 -
GET
: ClusterVersion 유형의 오브젝트 나열 -
POST
: ClusterVersion 생성
-
/apis/config.openshift.io/v1/clusterversions/{name}
-
DELETE
: ClusterVersion 삭제 -
GET
: 지정된 ClusterVersion 읽기 -
PATCH
: 지정된 ClusterVersion을 부분적으로 업데이트 -
PUT
: 지정된 ClusterVersion으로 교체
-
/apis/config.openshift.io/v1/clusterversions/{name}/status
-
GET
: 지정된 ClusterVersion의 읽기 상태 -
PATCH
: 지정된 ClusterVersion의 부분적으로 업데이트 상태 -
PUT
: 지정된 ClusterVersion의 상태
-
6.2.1. /apis/config.openshift.io/v1/clusterversions
- HTTP 방법
-
DELETE
- 설명
- ClusterVersion의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ClusterVersion 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ClusterVersion 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
6.2.2. /apis/config.openshift.io/v1/clusterversions/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ClusterVersion의 이름 |
- HTTP 방법
-
DELETE
- 설명
- ClusterVersion 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ClusterVersion 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ClusterVersion을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ClusterVersion으로 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
6.2.3. /apis/config.openshift.io/v1/clusterversions/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ClusterVersion의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 ClusterVersion의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ClusterVersion의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ClusterVersion의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7장. 콘솔 [config.openshift.io/v1]
- 설명
-
콘솔에는 로그 아웃 URL을 포함하여 웹 콘솔에 대한 클러스터 전체 구성이 있으며 콘솔의 공용 URL을 보고합니다. 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
7.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| ConsoleAuthentication은 콘솔 인증을 위한 선택적 구성 목록을 정의합니다. |
7.1.2. .spec.authentication
- 설명
- ConsoleAuthentication은 콘솔 인증을 위한 선택적 구성 목록을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 웹 브라우저를 콘솔에서 로그아웃한 후 로 리디렉션하는 선택적 절대 URL입니다. 지정하지 않으면 기본 로그인 페이지로 리디렉션됩니다. 이는 - OpenID (Keycloak, Azure) - RequestHeader (GSSAPI, SSPI, SAML) - 콘솔에서 OAuth(GitHub, GitLab, Google) 로깅과 같은 SSO(Single Sign-On)를 지원하는 ID 공급자를 사용하면 사용자 토큰이 삭제됩니다. logoutRedirect는 사용자에게 단일 사인온 세션을 제거하기 위해 ID 공급자를 통해 단일 로그 아웃(SLO)을 수행할 수 있는 옵션을 제공합니다. |
7.1.3. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 콘솔의 URL입니다. 이는 콘솔에 생성된 경로에 대해 호스트에서 파생됩니다. |
7.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/consoles
-
DELETE
: 콘솔 컬렉션 삭제 -
GET
: 종류의 오브젝트 나열 콘솔 -
POST
: 콘솔 생성
-
/apis/config.openshift.io/v1/consoles/{name}
-
DELETE
: 콘솔 삭제 -
GET
: 지정된 콘솔 읽기 -
PATCH
: 지정된 콘솔을 부분적으로 업데이트 -
PUT
: 지정된 콘솔을 교체
-
/apis/config.openshift.io/v1/consoles/{name}/status
-
GET
: 지정된 콘솔의 읽기 상태 -
PATCH
: 지정된 콘솔의 부분 업데이트 상태 -
PUT
: 지정된 콘솔의 상태 교체
-
7.2.1. /apis/config.openshift.io/v1/consoles
- HTTP 방법
-
DELETE
- 설명
- 콘솔 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 콘솔 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 콘솔 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
7.2.2. /apis/config.openshift.io/v1/consoles/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 콘솔 이름 |
- HTTP 방법
-
DELETE
- 설명
- 콘솔 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 콘솔 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 콘솔을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 콘솔 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
7.2.3. /apis/config.openshift.io/v1/consoles/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 콘솔 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 콘솔의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 콘솔의 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 콘솔의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8장. DNS [config.openshift.io/v1]
- 설명
-
DNS에는 DNS에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
8.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
baseDomain은 클러스터의 기본 도메인입니다. 모든 관리형 DNS 레코드는 이 기본 도메인의 하위 도메인이 됩니다. 예를 들어 기본 도메인 |
|
| 플랫폼에는 DNS의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. |
|
| privateZone은 클러스터에서만 사용할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 개인 레코드를 생성할 수 없습니다. 설정한 후에는 이 필드를 변경할 수 없습니다. |
|
| publicZone은 공개적으로 인터넷에 액세스할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 공용 레코드를 생성하지 않아야 합니다. 설정한 후에는 이 필드를 변경할 수 없습니다. |
8.1.2. .spec.platform
- 설명
- 플랫폼에는 DNS의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| AWS에는 Amazon Web Services 클라우드 공급자와 관련된 DNS 구성이 포함되어 있습니다. |
|
| type은 클러스터의 기본 인프라 공급자입니다. 허용되는 값: "", "AWS". 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 가장 안전한 기본값을 사용하여 인식되지 않은 플랫폼을 처리해야 합니다. |
8.1.3. .spec.platform.aws
- 설명
- AWS에는 Amazon Web Services 클라우드 공급자와 관련된 DNS 구성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PrivateZoneIAMRole에는 클러스터 DNS 구성에 지정된 클러스터의 프라이빗 호스팅 영역에서 작업을 수행할 때 가정해야 하는 IAM 역할의 ARN이 포함되어 있습니다. 비어 있는 경우 역할을 가정하지 않아야 합니다. |
8.1.4. .spec.privateZone
- 설명
- privateZone은 클러스터에서만 사용할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 개인 레코드를 생성할 수 없습니다. 설정한 후에는 이 필드를 변경할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
ID는 DNS 호스팅 영역을 찾는 데 사용할 수 있는 식별자입니다. AWS 영역에서 |
|
|
태그는 DNS 호스팅 영역을 쿼리하는 데 사용할 수 있습니다. AWS의 resourcegroupstaggingapi [1]은 태그 필터로 |
8.1.5. .spec.publicZone
- 설명
- publicZone은 공개적으로 인터넷에 액세스할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 공용 레코드를 생성하지 않아야 합니다. 설정한 후에는 이 필드를 변경할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
ID는 DNS 호스팅 영역을 찾는 데 사용할 수 있는 식별자입니다. AWS 영역에서 |
|
|
태그는 DNS 호스팅 영역을 쿼리하는 데 사용할 수 있습니다. AWS의 resourcegroupstaggingapi [1]은 태그 필터로 |
8.1.6. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
8.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/dnses
-
DELETE
: DNS 컬렉션 삭제 -
GET
: 종류 DNS의 오브젝트 나열 -
POST
: DNS 생성
-
/apis/config.openshift.io/v1/dnses/{name}
-
DELETE
: DNS 삭제 -
GET
: 지정된 DNS 읽기 -
PATCH
: 지정된 DNS를 부분적으로 업데이트 -
PUT
: 지정된 DNS를 교체
-
/apis/config.openshift.io/v1/dnses/{name}/status
-
GET
: 지정된 DNS의 읽기 상태 -
PATCH
: 지정된 DNS의 부분 업데이트 상태 -
PUT
: 지정된 DNS의 상태 교체
-
8.2.1. /apis/config.openshift.io/v1/dnses
- HTTP 방법
-
DELETE
- 설명
- DNS 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류 DNS의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- DNS 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
8.2.2. /apis/config.openshift.io/v1/dnses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| DNS 이름 |
- HTTP 방법
-
DELETE
- 설명
- DNS 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 DNS 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 DNS를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 DNS를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
8.2.3. /apis/config.openshift.io/v1/dnses/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| DNS 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 DNS의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 DNS의 상태를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 DNS의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9장. FeatureGate [config.openshift.io/v1]
- 설명
-
기능에는 기능 게이트에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
9.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
9.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
| `` | CustomNoUpgrade를 사용하면 모든 기능을 활성화 또는 비활성화할 수 있습니다. 이 기능을 켜는 것은 지원되지 않음, cannot SUPDONE, 그리고 PREVENTS UPGRADES입니다. 해당 특성으로 인해 이 설정을 검증할 수 없습니다. 오타가 있거나 실수로 잘못된 조합을 적용하는 경우 클러스터에서 복구할 수 없는 방식으로 실패할 수 있습니다. featureSet은 "CustomNoUpgrade"와 같아야 합니다. |
|
| featureSet은 클러스터의 기능 목록을 변경합니다. 기본값은 비어 있습니다. 이 설정을 신중하게 조정합니다. 기능을 켜거나 끄면 클러스터에서 되돌릴 수 없으므로 취소할 수 없습니다. |
9.1.2. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 현재 상태의 관찰을 나타냅니다. 알려진 .status.conditions.type은 "DeterminationDegraded"입니다. |
|
|
condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] |
|
| FeatureGates에는 payloadVersion에서 키를 지정하는 enabled 및 disabled featureGates 목록이 포함되어 있습니다. CVO 및 cluster-config-operator 이외의 Operator는 .status.featureGates를 읽고, 관리 중인 버전을 찾고, 활성화/비활성화된 기능 게이트를 찾고, 피연산자와 Operator를 일치시켜야 합니다. 특정 버전에 대해 활성화된/비활성화된 값은 다양한 .spec.featureSet 값이 선택되면 클러스터 수명 동안 변경될 수 있습니다. Operator는 프로세스를 다시 시작하여 이러한 변경 사항을 선택하도록 선택할 수 있지만 이전에 활성화/비활성화된 목록은 이 API의 범위를 벗어나며 개별 Operator의 책임이 있습니다. ClusterVersion.status에서 .version이 있는 featureGates만 이 목록에 표시됩니다. |
|
|
9.1.3. .status.conditions
- 설명
- 조건은 현재 상태의 관찰을 나타냅니다. 알려진 .status.conditions.type은 "DeterminationDegraded"입니다.
- 유형
-
array
9.1.4. .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)입니다. |
9.1.5. .status.featureGates
- 설명
- FeatureGates에는 payloadVersion에서 키를 지정하는 enabled 및 disabled featureGates 목록이 포함되어 있습니다. CVO 및 cluster-config-operator 이외의 Operator는 .status.featureGates를 읽고, 관리 중인 버전을 찾고, 활성화/비활성화된 기능 게이트를 찾고, 피연산자와 Operator를 일치시켜야 합니다. 특정 버전에 대해 활성화된/비활성화된 값은 다양한 .spec.featureSet 값이 선택되면 클러스터 수명 동안 변경될 수 있습니다. Operator는 프로세스를 다시 시작하여 이러한 변경 사항을 선택하도록 선택할 수 있지만 이전에 활성화/비활성화된 목록은 이 API의 범위를 벗어나며 개별 Operator의 책임이 있습니다. ClusterVersion.status에서 .version이 있는 featureGates만 이 목록에 표시됩니다.
- 유형
-
array
9.1.6. .status.featureGates[]
- 설명
- 유형
-
object
- 필수 항목
-
version
-
속성 | 유형 | 설명 |
---|---|---|
|
| disabled는 이름이 지정된 버전에 대해 클러스터에서 비활성화된 모든 기능 게이트 목록입니다. |
|
| |
|
| enabled는 이름이 지정된 버전에 대해 클러스터에서 활성화된 모든 기능 게이트 목록입니다. |
|
| |
|
| Version은 ClusterVersion 및 ClusterOperator.Status.Versions 필드에서 제공하는 버전과 일치합니다. |
9.1.7. .status.featureGates[].disabled
- 설명
- disabled는 이름이 지정된 버전에 대해 클러스터에서 비활성화된 모든 기능 게이트 목록입니다.
- 유형
-
array
9.1.8. .status.featureGates[].disabled[]
- 설명
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 FeatureGate의 이름입니다. |
9.1.9. .status.featureGates[].enabled
- 설명
- enabled는 이름이 지정된 버전에 대해 클러스터에서 활성화된 모든 기능 게이트 목록입니다.
- 유형
-
array
9.1.10. .status.featureGates[].enabled[]
- 설명
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 FeatureGate의 이름입니다. |
9.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/featuregates
-
DELETE
: FeatureGate 컬렉션 삭제 -
GET
: FeatureGate 유형의 오브젝트 나열 -
POST
: FeatureGate 생성
-
/apis/config.openshift.io/v1/featuregates/{name}
-
DELETE
: FeatureGate 삭제 -
GET
: 지정된 FeatureGate 읽기 -
PATCH
: 지정된 FeatureGate를 부분적으로 업데이트 -
PUT
: 지정된 FeatureGate를 교체
-
/apis/config.openshift.io/v1/featuregates/{name}/status
-
GET
: 지정된 FeatureGate의 읽기 상태 -
PATCH
: 지정된 FeatureGate의 부분 업데이트 상태 -
PUT
: 지정된 FeatureGate의 상태
-
9.2.1. /apis/config.openshift.io/v1/featuregates
- HTTP 방법
-
DELETE
- 설명
- FeatureGate 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- FeatureGate 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- FeatureGate 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
9.2.2. /apis/config.openshift.io/v1/featuregates/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| FeatureGate의 이름 |
- HTTP 방법
-
DELETE
- 설명
- FeatureGate 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 FeatureGate 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 FeatureGate를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 FeatureGate를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
9.2.3. /apis/config.openshift.io/v1/featuregates/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| FeatureGate의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 FeatureGate의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 FeatureGate의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 FeatureGate의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
10장. HelmChartRepository [helm.openshift.io/v1beta1]
- 설명
- HelmChartRepository는 프록시된 Helm 차트 리포지터리 호환성 수준 2에 대한 클러스터 전체 구성을 보유하고 있습니다. 2단계: 최소 9개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
10.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| 클러스터 내에서 리포지토리의 상태를 확인합니다. |
10.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 차트 리포지터리 연결에 필요한 구성 |
|
| 사람이 읽을 수 있는 선택적 리포지토리 설명인 UI에서 용도를 표시하는 데 사용할 수 있습니다. |
|
| true로 설정하면 클러스터/네임스에서 리포지토리 사용량을 비활성화합니다. |
|
| 사람이 읽을 수 있는 선택적 리포지토리 이름, UI에서 용도를 표시하는 데 사용할 수 있습니다. |
10.1.2. .spec.connectionConfig
- 설명
- 차트 리포지터리 연결에 필요한 구성
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| 차트 리포지터리 URL |
10.1.3. .spec.connectionConfig.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
10.1.4. .spec.connectionConfig.tlsClientConfig
- 설명
- tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
10.1.5. .status
- 설명
- 클러스터 내에서 리포지토리의 상태를 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 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 [] |
10.1.6. .status.conditions
- 설명
- conditions는 조건 및 상태 목록입니다.
- 유형
-
array
10.1.7. .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)입니다. |
10.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/helm.openshift.io/v1beta1/helmchartrepositories
-
DELETE
: HelmChartRepository의 컬렉션 삭제 -
GET
: HelmChartRepository 유형의 오브젝트 나열 -
POST
: HelmChartRepository 생성
-
/apis/helm.openshift.io/v1beta1/helmchartrepositories/{name}
-
DELETE
: delete a HelmChartRepository -
GET
: 지정된 HelmChartRepository 읽기 -
PATCH
: 지정된 HelmChartRepository를 부분적으로 업데이트 -
PUT
: 지정된 HelmChartRepository를 교체
-
/apis/helm.openshift.io/v1beta1/helmchartrepositories/{name}/status
-
GET
: 지정된 HelmChartRepository의 읽기 상태 -
PATCH
: 지정된 HelmChartRepository의 부분적으로 업데이트 상태 -
PUT
: 지정된 HelmChartRepository의 상태 교체
-
10.2.1. /apis/helm.openshift.io/v1beta1/helmchartrepositories
- HTTP 방법
-
DELETE
- 설명
- HelmChartRepository 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- HelmChartRepository 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- HelmChartRepository 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
10.2.2. /apis/helm.openshift.io/v1beta1/helmchartrepositories/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| HelmChartRepository 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a HelmChartRepository
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 HelmChartRepository 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 HelmChartRepository를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 HelmChartRepository를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
10.2.3. /apis/helm.openshift.io/v1beta1/helmchartrepositories/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| HelmChartRepository 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 HelmChartRepository의 상태 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 HelmChartRepository의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 HelmChartRepository의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
11장. Image [config.openshift.io/v1]
- 설명
- 이미지는 이미지 스트림 가져오기 및 외부 레지스트리의 런타임 구성과 관련된 정책을 관리합니다. 클러스터 관리자는 OpenShift가 이미지를 가져올 수 있는 레지스트리, 외부 레지스트리의 추가 CA 신뢰 번들, 레지스트리 호스트 이름을 차단하거나 허용하는 정책을 구성할 수 있습니다. OpenShift의 이미지 레지스트리를 공개에 노출할 때 클러스터 관리자가 외부 호스트 이름을 지정할 수도 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
11.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
11.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| additionalTrustedCA는 이미지 스트림 가져오기, Pod 이미지 가져오기, 빌드 이미지 가져오기 및 imageregistry pullthrough 중에 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| allowedRegistriesForImport는 일반 사용자가 이미지를 가져올 수 있는 컨테이너 이미지 레지스트리를 제한합니다. 이 목록을 유효한 Docker 이미지를 포함하고 애플리케이션을 가져올 수 있도록 신뢰하는 레지스트리로 설정합니다. API를 통해 이미지 또는 ImageStreamMapping을 생성할 수 있는 권한이 있는 사용자는 이 정책의 영향을 받지 않습니다. 일반적으로 관리자 또는 시스템 통합에만 이러한 권한이 있습니다. |
|
| RegistryLocation에는 레지스트리 도메인 이름으로 지정된 레지스트리 위치가 포함되어 있습니다. 도메인 이름에는 '*' 또는 '?'와 같은 와일드카드가 포함될 수 있습니다. |
|
| externalRegistryHostnames는 기본 외부 이미지 레지스트리의 호스트 이름을 제공합니다. 외부 호스트 이름은 이미지 레지스트리가 외부에 노출되는 경우에만 설정되어야 합니다. 첫 번째 값은 ImageStreams의 'publicDockerImageRepository' 필드에서 사용됩니다. 값은 "hostname[:port]" 형식이어야 합니다. |
|
| registrySources에는 builds+pods의 이미지에 액세스하는 경우 컨테이너 런타임에서 개별 레지스트리를 처리하는 방법을 결정하는 구성이 포함되어 있습니다(예: 비보안 액세스를 허용할지 여부). 내부 클러스터 레지스트리에 대한 구성은 포함되어 있지 않습니다. |
11.1.2. .spec.additionalTrustedCA
- 설명
- additionalTrustedCA는 이미지 스트림 가져오기, Pod 이미지 가져오기, 빌드 이미지 가져오기 및 imageregistry pullthrough 중에 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
11.1.3. .spec.allowedRegistriesForImport
- 설명
- allowedRegistriesForImport는 일반 사용자가 이미지를 가져올 수 있는 컨테이너 이미지 레지스트리를 제한합니다. 이 목록을 유효한 Docker 이미지를 포함하고 애플리케이션을 가져올 수 있도록 신뢰하는 레지스트리로 설정합니다. API를 통해 이미지 또는 ImageStreamMapping을 생성할 수 있는 권한이 있는 사용자는 이 정책의 영향을 받지 않습니다. 일반적으로 관리자 또는 시스템 통합에만 이러한 권한이 있습니다.
- 유형
-
array
11.1.4. .spec.allowedRegistriesForImport[]
- 설명
- RegistryLocation에는 레지스트리 도메인 이름으로 지정된 레지스트리 위치가 포함되어 있습니다. 도메인 이름에는 '*' 또는 '?'와 같은 와일드카드가 포함될 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| domainname은 레지스트리의 도메인 이름을 지정합니다. 레지스트리가 비표준(80 또는 443) 포트를 사용하는 경우 도메인 이름에도 포트가 포함되어야 합니다. |
|
| insecure는 레지스트리가 보안(https)인지 아니면 비보안(http)인지(지정되지 않은 경우) 레지스트리가 안전한 것으로 간주되는지 여부를 나타냅니다. |
11.1.5. .spec.registrySources
- 설명
- registrySources에는 builds+pods의 이미지에 액세스하는 경우 컨테이너 런타임에서 개별 레지스트리를 처리하는 방법을 결정하는 구성이 포함되어 있습니다(예: 비보안 액세스를 허용할지 여부). 내부 클러스터 레지스트리에 대한 구성은 포함되어 있지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowedRegistries는 이미지 가져오기 및 푸시 작업에 허용되는 유일한 레지스트리입니다. 다른 모든 레지스트리는 거부됩니다. BlockedRegistries 또는 AllowedRegistries 중 하나만 설정할 수 있습니다. |
|
| blockedRegistries는 이미지 가져오기 및 푸시 작업에 사용할 수 없습니다. 다른 모든 레지스트리는 허용됩니다. BlockedRegistries 또는 AllowedRegistries 중 하나만 설정할 수 있습니다. |
|
| containerRuntimeSearchRegistries는 가져오기 사양에 정규화된 도메인이 없는 이미지를 가져올 때 검색할 레지스트리입니다. 목록에 제공된 순서대로 레지스트리가 검색됩니다. 참고: 이 검색 목록은 컨테이너 런타임, 즉 CRI-O에서만 작동합니다. 빌드 또는 이미지 스트림 가져오기에서는 작동하지 않습니다. |
|
| insecureRegistries는 유효한 TLS 인증서가 없거나 HTTP 연결만 지원하는 레지스트리입니다. |
11.1.6. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| externalRegistryHostnames는 기본 외부 이미지 레지스트리의 호스트 이름을 제공합니다. 외부 호스트 이름은 이미지 레지스트리가 외부에 노출되는 경우에만 설정되어야 합니다. 첫 번째 값은 ImageStreams의 'publicDockerImageRepository' 필드에서 사용됩니다. 값은 "hostname[:port]" 형식이어야 합니다. |
|
| internalRegistryHostname은 기본 내부 이미지 레지스트리의 호스트 이름을 설정합니다. 값은 "hostname[:port]" 형식이어야 합니다. 이 값은 내부 레지스트리 호스트 이름을 제어하는 이미지 레지스트리 Operator에 의해 설정됩니다. |
11.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/images
-
DELETE
: 이미지 컬렉션 삭제 -
GET
: 종류의 이미지 오브젝트 나열 -
POST
: 이미지 생성
-
/apis/config.openshift.io/v1/images/{name}
-
DELETE
: 이미지 삭제 -
GET
: 지정된 이미지 읽기 -
PATCH
: 지정된 이미지를 부분적으로 업데이트 -
PUT
: 지정된 이미지 교체
-
/apis/config.openshift.io/v1/images/{name}/status
-
GET
: 지정된 이미지의 읽기 상태 -
PATCH
: 지정된 이미지의 부분 업데이트 상태 -
PUT
: 지정된 이미지의 상태 교체
-
11.2.1. /apis/config.openshift.io/v1/images
- HTTP 방법
-
DELETE
- 설명
- 이미지 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류의 이미지 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 이미지 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
11.2.2. /apis/config.openshift.io/v1/images/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 이미지 이름 |
- HTTP 방법
-
DELETE
- 설명
- 이미지 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 이미지 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 이미지를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 이미지 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
11.2.3. /apis/config.openshift.io/v1/images/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 이미지 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 이미지의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 이미지의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 이미지의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
12장. ImageDigestMirrorSet [config.openshift.io/v1]
- 설명
- ImageDigestMirrorSet은 다이제스트 가져오기 사양을 사용하여 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
12.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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| 상태에는 리소스의 관찰된 상태가 포함됩니다. |
12.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
imageDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 대체 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 imageDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 미러를 사용하여 태그 사양을 사용하여 이미지를 가져오려면 사용자가 "ImageTagMirrorSet" CRD를 사용하여 미러 목록을 구성해야 합니다. 이미지 가져오기 사양이 여러 imagedigestmirrorset 오브젝트에서 "source"의 리포지토리와 일치하는 경우 가장 구체적인 네임스페이스 일치를 정의하는 오브젝트만 사용됩니다. 예를 들어 quay.io/libpod 및 quay.io/libpod/busybox를 "source"로 사용하는 오브젝트가 있는 경우 quay.io/libpod/busybox를 사용하는 오브젝트만 가져오기 사양 quay.io/libpod/busybox에 적용됩니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러 |
|
| ImageDigestMirrors 레지스트리 구성에서 미러를 처리하는 방법에 대한 클러스터 전체 정보가 있습니다. |
12.1.2. .spec.imageDigestMirrors
- 설명
-
imageDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 대체 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 imageDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 미러를 사용하여 태그 사양을 사용하여 이미지를 가져오려면 사용자가 "ImageTagMirrorSet" CRD를 사용하여 미러 목록을 구성해야 합니다. 이미지 가져오기 사양이 여러 imagedigestmirrorset 오브젝트에서 "source"의 리포지토리와 일치하는 경우 가장 구체적인 네임스페이스 일치를 정의하는 오브젝트만 사용됩니다. 예를 들어 quay.io/libpod 및 quay.io/libpod/busybox를 "source"로 사용하는 오브젝트가 있는 경우 quay.io/libpod/busybox를 사용하는 오브젝트만 가져오기 사양 quay.io/libpod/busybox에 적용됩니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러
a, b, c
및 정책 B에 미러c, d, e
가 있는 경우 미러는a, b, c, d, e
순서로 사용됩니다. 미러 항목 순서가 충돌하는 경우(예:a, b
vs).b
) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다. 특정 미러 순서를 사용하려는 사용자는 예상 순서를 사용하여 하나의 미러 목록으로 구성해야 합니다. - 유형
-
array
12.1.3. .spec.imageDigestMirrors[]
- 설명
- ImageDigestMirrors 레지스트리 구성에서 미러를 처리하는 방법에 대한 클러스터 전체 정보가 있습니다.
- 유형
-
object
- 필수 항목
-
소스
-
속성 | 유형 | 설명 |
---|---|---|
|
| mirrorSourcePolicy는 미러에서 이미지를 가져오지 못하는 경우 대체 정책을 정의합니다. 설정되지 않은 경우 pull spec의 저장소에서 이미지를 계속 가져옵니다. sourcePolicy는 하나 이상의 미러가 미러 목록에 있는 경우에만 유효한 구성입니다. |
|
| 미러는 동일한 이미지를 포함할 수도 있는 0개 이상의 위치입니다. 지정하지 않으면 미러가 구성되지 않습니다. 이미지는 다이제스트에서 참조하는 경우에만 이러한 미러에서 가져올 수 있습니다. 미러링된 위치는 소스와 일치하는 입력 참조의 부분을 미러 항목으로 교체합니다. 예를 들어 registry.redhat.io/product/repo 참조, (소스, 미러) 쌍 *.redhat.io, mirror.local/redhat은 mirror.local/redhat/product/repo 저장소를 사용합니다. 이 목록의 미러 순서는 사용자의 원하는 우선 순위로 처리되지만 소스는 기본적으로 모든 미러보다 낮은 우선 순위로 간주됩니다. 미러가 지정되지 않았거나 미러 목록의 모든 이미지 가져오기가 실패해도 다른 imageDigestMirrors 오브젝트를 포함하여 "mirrorSourcePolicy" 기타 클러스터 구성으로 명시적으로 금지되지 않는 한 pull 사양의 저장소에서 이미지를 가져올 수 있습니다. 따라서 주문 보장 대신 기본 설정으로 간주됩니다. "mirrors"는 다음 형식 중 하나를 사용합니다. host[:port]/namespace[/namespace…] host[:port]/namespace…]/repo는 형식에 대한 자세한 내용을 참조하십시오. 위치 필드에 대한 문서를 참조하십시오. https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table |
|
| 소스는 사용자가 참조하는 리포지토리(예: 이미지 가져오기 사양)와 일치합니다. source를 레지스트리 호스트 이름으로 설정하면 docker.io. quay.io 또는 registry.redhat.io와 같은 레지스트리 호스트 이름으로 설정하면 corressponding 레지스트리의 이미지 가져오기 사양과 일치합니다. "source"는 다음 형식 중 하나를 사용합니다. host[:port]/namespace[/namespace…] host[:port]/namespace…] host[:port]/namespace…]/repo [*.host] https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table |
12.1.4. .status
- 설명
- 상태에는 리소스의 관찰된 상태가 포함됩니다.
- 유형
-
object
12.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/imagedigestmirrorsets
-
DELETE
: ImageDigestMirrorSet의 컬렉션 삭제 -
GET
: 종류의 ImageDigestMirrorSet의 오브젝트 나열 -
POST
: ImageDigestMirrorSet을 생성
-
/apis/config.openshift.io/v1/imagedigestmirrorsets/{name}
-
DELETE
: delete an ImageDigestMirrorSet -
GET
: 지정된 ImageDigestMirrorSet 읽기 -
PATCH
: 지정된 ImageDigestMirrorSet을 부분적으로 업데이트합니다. -
PUT
: 지정된 ImageDigestMirrorSet을 교체합니다.
-
/apis/config.openshift.io/v1/imagedigestmirrorsets/{name}/status
-
GET
: 지정된 ImageDigestMirrorSet의 읽기 상태 -
PATCH
: 지정된 ImageDigestMirrorSet의 부분 업데이트 상태 -
PUT
: 지정된 ImageDigestMirrorSet의 상태 교체
-
12.2.1. /apis/config.openshift.io/v1/imagedigestmirrorsets
- HTTP 방법
-
DELETE
- 설명
- ImageDigestMirrorSet의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ImageDigestMirrorSet 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ImageDigestMirrorSet 만들기
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
12.2.2. /apis/config.openshift.io/v1/imagedigestmirrorsets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ImageDigestMirrorSet의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete an ImageDigestMirrorSet
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ImageDigestMirrorSet 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ImageDigestMirrorSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ImageDigestMirrorSet을 교체합니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
12.2.3. /apis/config.openshift.io/v1/imagedigestmirrorsets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ImageDigestMirrorSet의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 ImageDigestMirrorSet의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ImageDigestMirrorSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ImageDigestMirrorSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
13장. ImageContentPolicy [config.openshift.io/v1]
- 설명
- ImageContentPolicy에는 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
13.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
13.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
repositoryDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 RepositoryDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 태그를 통해 미러에서 이미지를 가져오려면 "allowMirrorByTags"를 설정해야 합니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러 |
|
| RepositoryDigestMirrors 레지스트리 구성에서 미러를 처리하는 방법에 대한 클러스터 전체 정보가 있습니다. |
13.1.2. .spec.repositoryDigestMirrors
- 설명
-
repositoryDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 RepositoryDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 태그를 통해 미러에서 이미지를 가져오려면 "allowMirrorByTags"를 설정해야 합니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러
a, b, c
및 정책 B에 미러c, d, e
가 있는 경우 미러는a, b, c, d, e
순서로 사용됩니다. 미러 항목 순서가 충돌하는 경우(예:a, b
vs).b
) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다. - 유형
-
array
13.1.3. .spec.repositoryDigestMirrors[]
- 설명
- RepositoryDigestMirrors 레지스트리 구성에서 미러를 처리하는 방법에 대한 클러스터 전체 정보가 있습니다.
- 유형
-
object
- 필수 항목
-
소스
-
속성 | 유형 | 설명 |
---|---|---|
|
| allowMirrorByTags true인 경우 미러를 사용하여 태그에서 참조하는 이미지를 가져올 수 있습니다. 기본값은 false이며 미러는 다이제스트에서 참조하는 이미지를 가져올 때만 작동합니다. 태그로 이미지를 가져오면 가져오는 끝점에 따라 잠재적으로 다른 이미지를 생성할 수 있습니다. 미러에 대한 digest-pulls를 강제 적용하면 이러한 문제가 발생하지 않습니다. |
|
| 미러는 동일한 이미지를 포함할 수도 있는 0개 이상의 리포지토리입니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 미러가 구성되지 않습니다. 이 목록의 미러 순서는 사용자의 원하는 우선 순위로 처리되지만 소스는 기본적으로 모든 미러보다 낮은 우선 순위로 간주됩니다. 다른 repositoryDigestMirrors 오브젝트를 포함한 기타 클러스터 구성은 다른 repositoryDigestMirrors 오브젝트에 영향을 미칠 수 있고, 정확한 순서 지정에 영향을 미치거나, 일부 미러는 병렬로 연락을 취할 수 있으므로 주문 보장 대신 기본 설정으로 간주해야 합니다. |
|
| source는 사용자가 참조하는 리포지토리입니다(예: 이미지 가져오기 사양에서). |
13.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/imagecontentpolicies
-
DELETE
: ImageContentPolicy 컬렉션 삭제 -
GET
: 종류의 ImageContentPolicy의 오브젝트 나열 -
POST
: ImageContentPolicy 생성
-
/apis/config.openshift.io/v1/imagecontentpolicies/{name}
-
DELETE
: delete an ImageContentPolicy -
GET
: 지정된 ImageContentPolicy 읽기 -
PATCH
: 지정된 ImageContentPolicy를 부분적으로 업데이트 -
PUT
: 지정된 ImageContentPolicy를 교체
-
/apis/config.openshift.io/v1/imagecontentpolicies/{name}/status
-
GET
: 지정된 ImageContentPolicy의 읽기 상태 -
PATCH
: 지정된 ImageContentPolicy의 부분적으로 업데이트 상태 -
PUT
: 지정된 ImageContentPolicy의 상태 교체
-
13.2.1. /apis/config.openshift.io/v1/imagecontentpolicies
- HTTP 방법
-
DELETE
- 설명
- ImageContentPolicy 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ImageContentPolicy 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ImageContentPolicy 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
13.2.2. /apis/config.openshift.io/v1/imagecontentpolicies/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ImageContentPolicy 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete an ImageContentPolicy
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ImageContentPolicy 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ImageContentPolicy를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ImageContentPolicy를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
13.2.3. /apis/config.openshift.io/v1/imagecontentpolicies/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ImageContentPolicy 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 ImageContentPolicy의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ImageContentPolicy의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ImageContentPolicy의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
14장. ImageTagMirrorSet [config.openshift.io/v1]
- 설명
- ImageTagMirrorSet은 태그 풀 사양을 사용하여 에서 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
14.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| 상태에는 리소스의 관찰된 상태가 포함됩니다. |
14.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
imageTagMirrors를 사용하면 Pod의 이미지 태그에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 imageTagMirrors에 설명된 소스 위치와 비교되며, 이미지가 지정된 저장소 대신 목록의 미러 중 하나에서 아래로 내려져 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 미러를 사용하여 다이제스트 사양을 사용하여 이미지를 가져오려면 사용자가 "ImageDigestMirrorSet" CRD를 사용하여 미러 목록을 구성해야 합니다. 이미지 가져오기 사양이 여러 imagetagmirrorset 오브젝트에서 "source"의 리포지토리와 일치하는 경우 가장 구체적인 네임스페이스 일치를 정의하는 오브젝트만 사용됩니다. 예를 들어 quay.io/libpod 및 quay.io/libpod/busybox를 "source"로 사용하는 오브젝트가 있는 경우 quay.io/libpod/busybox를 사용하는 오브젝트만 가져오기 사양 quay.io/libpod/busybox에 적용됩니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러 |
|
| ImageTagMirrors 레지스트리 구성에서 미러를 처리하는 방법에 대한 클러스터 전체 정보가 있습니다. |
14.1.2. .spec.imageTagMirrors
- 설명
-
imageTagMirrors를 사용하면 Pod의 이미지 태그에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 imageTagMirrors에 설명된 소스 위치와 비교되며, 이미지가 지정된 저장소 대신 목록의 미러 중 하나에서 아래로 내려져 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 미러를 사용하여 다이제스트 사양을 사용하여 이미지를 가져오려면 사용자가 "ImageDigestMirrorSet" CRD를 사용하여 미러 목록을 구성해야 합니다. 이미지 가져오기 사양이 여러 imagetagmirrorset 오브젝트에서 "source"의 리포지토리와 일치하는 경우 가장 구체적인 네임스페이스 일치를 정의하는 오브젝트만 사용됩니다. 예를 들어 quay.io/libpod 및 quay.io/libpod/busybox를 "source"로 사용하는 오브젝트가 있는 경우 quay.io/libpod/busybox를 사용하는 오브젝트만 가져오기 사양 quay.io/libpod/busybox에 적용됩니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러
a, b, c
및 정책 B에 미러c, d, e
가 있는 경우 미러는a, b, c, d, e
순서로 사용됩니다. 미러 항목 순서가 충돌하는 경우(예:a, b
vs).b
) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다. 미러의 결정적 순서를 사용하려는 사용자는 예상 순서를 사용하여 하나의 미러 목록으로 구성해야 합니다. - 유형
-
array
14.1.3. .spec.imageTagMirrors[]
- 설명
- ImageTagMirrors 레지스트리 구성에서 미러를 처리하는 방법에 대한 클러스터 전체 정보가 있습니다.
- 유형
-
object
- 필수 항목
-
소스
-
속성 | 유형 | 설명 |
---|---|---|
|
| mirrorSourcePolicy는 미러에서 이미지를 가져오지 못하는 경우 대체 정책을 정의합니다. 설정되지 않은 경우 pull spec의 저장소에서 이미지를 계속 가져옵니다. sourcePolicy는 하나 이상의 미러가 미러 목록에 있는 경우에만 유효합니다. |
|
| 미러는 동일한 이미지를 포함할 수도 있는 0개 이상의 위치입니다. 지정하지 않으면 미러가 구성되지 않습니다. 이러한 미러는 태그에서 참조하는 경우에만 이미지를 가져올 수 있습니다. 미러링된 위치는 소스와 일치하는 입력 참조의 부분을 미러 항목으로 교체합니다. 예를 들어 registry.redhat.io/product/repo 참조, (소스, 미러) 쌍 *.redhat.io, mirror.local/redhat은 mirror.local/redhat/product/repo 저장소를 사용합니다. 태그로 이미지를 가져오면 가져오는 끝점에 따라 잠재적으로 다른 이미지를 생성할 수 있습니다. "ImageDigestMirrorSet" CRD를 사용하여 미러 목록을 구성하고 미러에 대해 digest-pulls를 강제 적용하면 이 문제가 발생하지 않습니다. 이 목록의 미러 순서는 사용자의 원하는 우선 순위로 처리되지만 소스는 기본적으로 모든 미러보다 낮은 우선 순위로 간주됩니다. 미러가 지정되지 않았거나 미러 목록에서 모든 이미지를 가져오지 못하면 "mirrorSourcePolicy"에서 명시적으로 금지하지 않는 한 이미지를 가져오기 사양의 저장소에서 계속 가져옵니다. 다른 imageTagMirrors 오브젝트를 포함하여(제한되지 않음) 기타 클러스터 구성은 다른 imageTagMirrors 오브젝트에 연결되어 있을 수 있습니다. 또는 일부 미러가 병렬로 연결할 수 있으므로 주문 보장 대신 기본 설정으로 간주해야 합니다. "mirrors"는 다음 형식 중 하나를 사용합니다. "mirrors"는 다음 형식 중 하나를 사용합니다. host[:port]/namespace[/namespace] host:port]/namespace]/namespace] 위치 필드에 대한 문서를 참조하십시오. https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table |
|
| 소스는 사용자가 참조하는 리포지토리(예: 이미지 가져오기 사양)와 일치합니다. source를 레지스트리 호스트 이름으로 설정하면 docker.io. quay.io 또는 registry.redhat.io와 같은 레지스트리 호스트 이름으로 설정하면 corressponding 레지스트리의 이미지 가져오기 사양과 일치합니다. "source"는 다음 형식 중 하나를 사용합니다. host[:port]/namespace[/namespace…] host[:port]/namespace…] host[:port]/namespace…]/repo [*.host] https://github.com/containers/image/blob/main/docs/containers-registries.conf.5.md#choosing-a-registry-toml-table |
14.1.4. .status
- 설명
- 상태에는 리소스의 관찰된 상태가 포함됩니다.
- 유형
-
object
14.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/imagetagmirrorsets
-
DELETE
: ImageTagMirrorSet의 컬렉션 삭제 -
GET
: 종류의 ImageTagMirrorSet의 오브젝트 나열 -
POST
: ImageTagMirrorSet을 생성
-
/apis/config.openshift.io/v1/imagetagmirrorsets/{name}
-
DELETE
: delete an ImageTagMirrorSet -
GET
: 지정된 ImageTagMirrorSet을 읽습니다. -
PATCH
: 지정된 ImageTagMirrorSet을 부분적으로 업데이트합니다. -
PUT
: 지정된 ImageTagMirrorSet을 바꿉니다.
-
/apis/config.openshift.io/v1/imagetagmirrorsets/{name}/status
-
GET
: 지정된 ImageTagMirrorSet의 읽기 상태 -
PATCH
: 지정된 ImageTagMirrorSet의 부분적으로 업데이트 상태 -
PUT
: 지정된 ImageTagMirrorSet의 상태 교체
-
14.2.1. /apis/config.openshift.io/v1/imagetagmirrorsets
- HTTP 방법
-
DELETE
- 설명
- ImageTagMirrorSet의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ImageTagMirrorSet 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ImageTagMirrorSet 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
14.2.2. /apis/config.openshift.io/v1/imagetagmirrorsets/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ImageTagMirrorSet의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete an ImageTagMirrorSet
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ImageTagMirrorSet 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ImageTagMirrorSet을 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ImageTagMirrorSet을 교체합니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
14.2.3. /apis/config.openshift.io/v1/imagetagmirrorsets/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ImageTagMirrorSet의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 ImageTagMirrorSet의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ImageTagMirrorSet의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ImageTagMirrorSet의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
15장. 인프라 [config.openshift.io/v1]
- 설명
-
인프라에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
15.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
15.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
cloudConfig는 클라우드 공급자 구성 파일이 포함된 ConfigMap에 대한 참조입니다. 이 구성 파일은 기본 제공 클라우드 공급자 통합 또는 외부 클라우드 컨트롤러 관리자를 사용할 때 Kubernetes 클라우드 공급자 통합을 구성하는 데 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. cloudConfig는 kube_cloud_config 컨트롤러에서만 사용해야 합니다. 컨트롤러는 다양한 플랫폼의 사양에서 사용자 구성을 사용하고 이 필드에 사용자가 제공한 ConfigMap과 결합하여 stitched kube 클라우드 구성을 생성합니다. 컨트롤러는 kube 클라우드 구성이 |
|
| platformSpec은 기본 인프라 공급자와 관련된 원하는 정보를 보유합니다. |
15.1.2. .spec.cloudConfig
- 설명
-
cloudConfig는 클라우드 공급자 구성 파일이 포함된 ConfigMap에 대한 참조입니다. 이 구성 파일은 기본 제공 클라우드 공급자 통합 또는 외부 클라우드 컨트롤러 관리자를 사용할 때 Kubernetes 클라우드 공급자 통합을 구성하는 데 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. cloudConfig는 kube_cloud_config 컨트롤러에서만 사용해야 합니다. 컨트롤러는 다양한 플랫폼의 사양에서 사용자 구성을 사용하고 이 필드에 사용자가 제공한 ConfigMap과 결합하여 stitched kube 클라우드 구성을 생성합니다. 컨트롤러는 kube 클라우드 구성이
cloud.conf
키에 저장된openshift-config-managed
네임스페이스에 ConfigMapkube-cloud-config
를 생성합니다. 모든 클라이언트는 생성된 ConfigMap만 사용해야 합니다. - 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| key를 사용하면 configmap 내의 특정 키/값을 가리킬 수 있습니다. 이는 논리 파일 참조에 유용합니다. |
|
|
15.1.3. .spec.platformSpec
- 설명
- platformSpec은 기본 인프라 공급자와 관련된 원하는 정보를 보유합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다. |
|
| EquinixMetal에는 Equinix Metal 인프라 공급자에 대한 설정이 포함되어 있습니다. |
|
| ExternalPlatformType은 일반 인프라 공급자를 나타냅니다. 플랫폼별 구성 요소는 별도로 보완해야 합니다. |
|
| GCP에는 Google Cloud Platform 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다. |
|
| ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| PowerVS에는 IBM Power Systems Virtual Servers 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| type은 클러스터의 기본 인프라 공급자입니다. 이 값은 서비스 로드 밸런서, 동적 볼륨 프로비저닝, 머신 생성 및 삭제와 같은 인프라 자동화가 활성화되는지 여부를 제어합니다. None인 경우 인프라 자동화가 활성화되지 않습니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" 및 "None"입니다. 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 해당 플랫폼을 지원하지 않는 경우 인식되지 않은 플랫폼을 None으로 처리해야 합니다. |
|
| vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
15.1.4. .spec.platformSpec.alibabaCloud
- 설명
- alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
15.1.5. .spec.platformSpec.aws
- 설명
- AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| serviceEndpoints 목록에는 AWS Services의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점이 포함되어 있습니다. 서비스에는 하나의 ServiceEndpoint만 있어야 합니다. |
|
| AWSServiceEndpoint는 사용자 정의 URL 구성을 저장하여 AWS Services의 기존 기본값을 재정의합니다. |
15.1.6. .spec.platformSpec.aws.serviceEndpoints
- 설명
- serviceEndpoints 목록에는 AWS Services의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점이 포함되어 있습니다. 서비스에는 하나의 ServiceEndpoint만 있어야 합니다.
- 유형
-
array
15.1.7. .spec.platformSpec.aws.serviceEndpoints[]
- 설명
- AWSServiceEndpoint는 사용자 정의 URL 구성을 저장하여 AWS Services의 기존 기본값을 재정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 AWS 서비스의 이름입니다. 모든 서비스 이름 목록은 https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html 에서 확인할 수 있으며 제공해야 하며 비워 둘 수 없습니다. |
|
| URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다. |
15.1.8. .spec.platformSpec.azure
- 설명
- Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
15.1.9. .spec.platformSpec.baremetal
- 설명
- baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.apiServerInternalIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.ingressIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다. |
|
| machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. 각 네트워크는 CIDR 형식으로 제공되며 IPv4 또는 IPv6(예: "10.0.0.0/8" 또는 "fd00::/8")이어야 합니다. |
15.1.10. .spec.platformSpec.equinixMetal
- 설명
- EquinixMetal에는 Equinix Metal 인프라 공급자에 대한 설정이 포함되어 있습니다.
- 유형
-
object
15.1.11. .spec.platformSpec.external
- 설명
- ExternalPlatformType은 일반 인프라 공급자를 나타냅니다. 플랫폼별 구성 요소는 별도로 보완해야 합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| PlatformName에는 설치 시 설정될 것으로 예상되는 인프라 공급자 이름을 나타내는 임의의 문자열이 있습니다. 이 필드는 정보 및 보고 목적으로만 사용되며 의사 결정용으로는 사용되지 않을 것으로 예상됩니다. |
15.1.12. .spec.platformSpec.gcp
- 설명
- GCP에는 Google Cloud Platform 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
15.1.13. .spec.platformSpec.ibmcloud
- 설명
- IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
15.1.14. .spec.platformSpec.kubevirt
- 설명
- kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
15.1.15. .spec.platformSpec.nutanix
- 설명
- Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
prismCentral
-
prismElements
-
속성 | 유형 | 설명 |
---|---|---|
|
| failureDomains는 Nutanix 플랫폼에 대한 실패 도메인 정보를 구성합니다. 설정하면 여기에 정의된 장애 도메인을 사용하여 클러스터의 내결함성을 개선하기 위해 prism 요소 클러스터에 머신을 분배할 수 있습니다. |
|
| NutanixFailureDomain은 Nutanix 플랫폼에 대한 실패 도메인 정보를 구성합니다. |
|
| prismCentral에는 Nutanix Prism Central에 액세스할 수 있는 엔드포인트 주소와 포트가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오. |
|
| prism Cryostats에는 Nutanix Prism Central의 Nutanix Prism Cryostat (클러스터)에 액세스하기 위해 하나 이상의 엔드 포인트 주소와 포트 데이터가 있습니다. 현재 OpenShift 클러스터에 사용되는 모든 Nutanix 리소스(VM, 서브넷, 볼륨 등)가 있는 OpenShift 클러스터에 대해 하나의 Prism Element(클러스터)만 지원합니다. 앞으로는 Prism Central의 여러 Prism Cryostat(클러스터)에 걸쳐 Nutanix 리소스(VM 등)를 지원할 수 있습니다. |
|
| NutanixPrism CryostatEndpoint에는 Prism Element (cluster)의 이름 및 엔드포인트 데이터가 있습니다. |
15.1.16. .spec.platformSpec.nutanix.failureDomains
- 설명
- failureDomains는 Nutanix 플랫폼에 대한 실패 도메인 정보를 구성합니다. 설정하면 여기에 정의된 장애 도메인을 사용하여 클러스터의 내결함성을 개선하기 위해 prism 요소 클러스터에 머신을 분배할 수 있습니다.
- 유형
-
array
15.1.17. .spec.platformSpec.nutanix.failureDomains[]
- 설명
- NutanixFailureDomain은 Nutanix 플랫폼에 대한 실패 도메인 정보를 구성합니다.
- 유형
-
object
- 필수 항목
-
cluster
-
name
-
subnets
-
속성 | 유형 | 설명 |
---|---|---|
|
| 클러스터는 머신의 VM을 생성할 클러스터(프리즈m Central의 관리 하에서 Presm Element)를 식별하는 것입니다. 클러스터 식별자(uuid 또는 name)는 Prism Central 콘솔에서 또는 prism_central API를 사용하여 가져올 수 있습니다. |
|
| name은 실패 도메인의 고유한 이름을 정의합니다. 이름은 필수이며 최대 64자여야 합니다. 소문자 영숫자 및 하이픈(-)만 구성되어야 합니다. 영숫자 문자로 시작하고 끝나야 합니다. 이 값은 임의의 값이며 플랫폼 내에서 장애 도메인을 식별하는 데 사용됩니다. |
|
| 서브넷에는 머신의 VM에 연결할 클러스터의 네트워크 서브넷의 식별자 목록(하나 이상)이 있습니다. 서브넷 식별자(uuid 또는 name)는 Prism Central 콘솔에서 또는 prism_central API를 사용하여 가져올 수 있습니다. |
|
| NutanixResourceIdentifier는 Nutanix PC 리소스 (클러스터, 이미지, 서브넷 등)의 ID를 보유하고 있습니다. |
15.1.18. .spec.platformSpec.nutanix.failureDomains[].cluster
- 설명
- 클러스터는 머신의 VM을 생성할 클러스터(프리즈m Central의 관리 하에서 Presm Element)를 식별하는 것입니다. 클러스터 식별자(uuid 또는 name)는 Prism Central 콘솔에서 또는 prism_central API를 사용하여 가져올 수 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 PC의 리소스 이름입니다. 유형이 Name인 경우 비워 둘 수 없습니다. |
|
| type은 이 리소스에 사용할 식별자 유형입니다. |
|
| UUID는 PC에 있는 리소스의 UUID입니다. 유형이 UUID인 경우 비워 둘 수 없습니다. |
15.1.19. .spec.platformSpec.nutanix.failureDomains[].subnets
- 설명
- 서브넷에는 머신의 VM에 연결할 클러스터의 네트워크 서브넷의 식별자 목록(하나 이상)이 있습니다. 서브넷 식별자(uuid 또는 name)는 Prism Central 콘솔에서 또는 prism_central API를 사용하여 가져올 수 있습니다.
- 유형
-
array
15.1.20. .spec.platformSpec.nutanix.failureDomains[].subnets[]
- 설명
- NutanixResourceIdentifier는 Nutanix PC 리소스 (클러스터, 이미지, 서브넷 등)의 ID를 보유하고 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 PC의 리소스 이름입니다. 유형이 Name인 경우 비워 둘 수 없습니다. |
|
| type은 이 리소스에 사용할 식별자 유형입니다. |
|
| UUID는 PC에 있는 리소스의 UUID입니다. 유형이 UUID인 경우 비워 둘 수 없습니다. |
15.1.21. .spec.platformSpec.nutanix.prismCentral
- 설명
- prismCentral에는 Nutanix Prism Central에 액세스할 수 있는 엔드포인트 주소와 포트가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오.
- 유형
-
object
- 필수 항목
-
address
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| address는 Nutanix Prism Central 또는 Element (cluster)의 엔드포인트 주소(DNS 이름 또는 IP 주소)입니다. |
|
| port는 Nutanix Prism Central 또는 Element (cluster)에 액세스하는 포트 번호입니다. |
15.1.22. .spec.platformSpec.nutanix.prismElements
- 설명
- prism Cryostats에는 Nutanix Prism Central의 Nutanix Prism Cryostat (클러스터)에 액세스하기 위해 하나 이상의 엔드 포인트 주소와 포트 데이터가 있습니다. 현재 OpenShift 클러스터에 사용되는 모든 Nutanix 리소스(VM, 서브넷, 볼륨 등)가 있는 OpenShift 클러스터에 대해 하나의 Prism Element(클러스터)만 지원합니다. 앞으로는 Prism Central의 여러 Prism Cryostat(클러스터)에 걸쳐 Nutanix 리소스(VM 등)를 지원할 수 있습니다.
- 유형
-
array
15.1.23. .spec.platformSpec.nutanix.prismElements[]
- 설명
- NutanixPrism CryostatEndpoint에는 Prism Element (cluster)의 이름 및 엔드포인트 데이터가 있습니다.
- 유형
-
object
- 필수 항목
-
endpoint
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| endpoint에는 Prism Element (cluster)의 엔드포인트 주소 및 포트 데이터가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오. |
|
| name은 Prism Element (cluster)의 이름입니다. 이 값은 다른 리소스(예: 머신, PVC 등)에 구성된 클러스터 필드에 해당합니다. |
15.1.24. .spec.platformSpec.nutanix.prismElements[].endpoint
- 설명
- endpoint에는 Prism Element (cluster)의 엔드포인트 주소 및 포트 데이터가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오.
- 유형
-
object
- 필수 항목
-
address
-
port
-
속성 | 유형 | 설명 |
---|---|---|
|
| address는 Nutanix Prism Central 또는 Element (cluster)의 엔드포인트 주소(DNS 이름 또는 IP 주소)입니다. |
|
| port는 Nutanix Prism Central 또는 Element (cluster)에 액세스하는 포트 번호입니다. |
15.1.25. .spec.platformSpec.openstack
- 설명
- OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.apiServerInternalIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.ingressIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다. |
|
| machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. 각 네트워크는 CIDR 형식으로 제공되며 IPv4 또는 IPv6(예: "10.0.0.0/8" 또는 "fd00::/8")이어야 합니다. |
15.1.26. .spec.platformSpec.ovirt
- 설명
- ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
15.1.27. .spec.platformSpec.powervs
- 설명
- PowerVS에는 IBM Power Systems Virtual Servers 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| serviceEndpoints는 Power VS 서비스의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점 목록입니다. |
|
| PowervsServiceEndpoint는 사용자 지정 URL의 구성을 저장하여 PowerVS 서비스의 기존 기본값을 재정의합니다. |
15.1.28. .spec.platformSpec.powervs.serviceEndpoints
- 설명
- serviceEndpoints는 Power VS 서비스의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점 목록입니다.
- 유형
-
array
15.1.29. .spec.platformSpec.powervs.serviceEndpoints[]
- 설명
- PowervsServiceEndpoint는 사용자 지정 URL의 구성을 저장하여 PowerVS 서비스의 기존 기본값을 재정의합니다.
- 유형
-
object
- 필수 항목
-
name
-
url
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 Power VS 서비스의 이름입니다. IAM 서비스 중 몇 개 - https://cloud.ibm.com/apidocs/iam-identity-token-api ResourceController - https://cloud.ibm.com/apidocs/resource-controller/resource-controller Power Cloud - https://cloud.ibm.com/apidocs/power-cloud |
|
| URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다. |
15.1.30. .spec.platformSpec.vsphere
- 설명
- vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.apiServerInternalIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다. |
|
| failureDomains에는 지역, 영역 및 vCenter 토폴로지의 정의가 포함되어 있습니다. 실패 도메인(지역 및 영역)을 생략하면 사용되지 않습니다. |
|
| VSpherePlatformFailureDomainSpec에는 리전 및 영역 장애 도메인과 해당 실패 도메인의 vCenter 토폴로지가 있습니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.ingressIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다. |
|
| machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. 각 네트워크는 CIDR 형식으로 제공되며 IPv4 또는 IPv6(예: "10.0.0.0/8" 또는 "fd00::/8")이어야 합니다. |
|
| nodeNetworking에는 노드의 네트워킹을 할당하기 위한 내부 및 외부 네트워크 제약 조건의 정의가 포함되어 있습니다. 이 필드를 생략하면 네트워킹은 기본적으로 단일 주소만 지원하고 발견된 첫 번째 주소를 반환하는 기존 주소 선택 동작으로 설정됩니다. |
|
| vCenter에는 vCenter와 통신할 서비스의 연결 세부 정보가 있습니다. 현재 단일 vCenter만 지원됩니다. --- |
|
| VSpherePlatformVCenterSpec은 vCenter 연결 필드를 저장합니다. vSphere CCM에서 사용합니다. |
15.1.31. .spec.platformSpec.vsphere.failureDomains
- 설명
- failureDomains에는 지역, 영역 및 vCenter 토폴로지의 정의가 포함되어 있습니다. 실패 도메인(지역 및 영역)을 생략하면 사용되지 않습니다.
- 유형
-
array
15.1.32. .spec.platformSpec.vsphere.failureDomains[]
- 설명
- VSpherePlatformFailureDomainSpec에는 리전 및 영역 장애 도메인과 해당 실패 도메인의 vCenter 토폴로지가 있습니다.
- 유형
-
object
- 필수 항목
-
name
-
region
-
server
-
토폴로지
-
영역
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 실패 도메인의 임의의 고유 이름을 정의합니다. |
|
| region은 vCenter 데이터 센터에 연결할 리전 태그의 이름을 정의합니다. vCenter의 태그 카테고리 이름은 openshift-region이어야 합니다. |
|
| server는 정규화된 도메인 이름 또는 vCenter 서버의 IP 주소입니다. --- |
|
| 토폴로지는 vSphere 구성을 사용하여 지정된 실패 도메인을 설명합니다. |
|
| zone은 vCenter 클러스터에 연결할 영역 태그의 이름을 정의합니다. vCenter의 태그 카테고리는 이름이 openshift-zone이어야 합니다. |
15.1.33. .spec.platformSpec.vsphere.failureDomains[].topology
- 설명
- 토폴로지는 vSphere 구성을 사용하여 지정된 실패 도메인을 설명합니다.
- 유형
-
object
- 필수 항목
-
computeCluster
-
데이터 센터
-
데이터 저장소
-
네트워크
-
속성 | 유형 | 설명 |
---|---|---|
|
| computeCluster 가상 머신이 있을 vCenter 클러스터의 절대 경로입니다. 절대 경로는 /<datacenter>/host/<cluster> 형식입니다. 경로의 최대 길이는 2048자입니다. |
|
| 데이터센터는 가상 머신이 있을 vCenter 데이터 센터의 이름입니다. 데이터 센터 이름의 최대 길이는 80자입니다. |
|
| Datastore는 가상 머신이 있는 데이터 저장소의 절대 경로입니다. 절대 경로는 /<datacenter>/datastore/<datastore> 최대 경로 길이는 2048자입니다. |
|
| 폴더는 가상 머신이 있는 폴더의 절대 경로입니다. 절대 경로는 /<datacenter>/vm/<folder> 형식입니다. 경로의 최대 길이는 2048자입니다. |
|
|
네트워크는 이 실패 도메인 내의 포트 그룹 네트워크 이름 목록입니다. 현재는 RHCOS 가상 머신당 단일 인터페이스만 지원합니다. 사용 가능한 네트워크(포트 그룹)는 |
|
| ResourcePool은 가상 머신이 생성될 리소스 풀의 절대 경로입니다. 절대 경로는 /<datacenter>/host/<cluster>/Resources/<resourcepool> 형식입니다. 경로의 최대 길이는 2048자입니다. |
|
| 템플릿은 이 장애 도메인에서 새 시스템을 생성할 때 복제할 가상 머신 또는 템플릿의 전체 인벤토리 경로입니다. 경로의 최대 길이는 2048자입니다. 생략하면 VSpherePlatformFailureDomainSpec에 정의된 리전 및 영역에 따라 컨트롤 플레인 머신 세트 Operator에 의해 템플릿이 계산됩니다. 예를 들어 zone=zonea, region=region1 및 인프라 name=test의 경우 템플릿 경로는 /<datacenter>/vm/test-rhcos-region1-zonea로 계산됩니다. |
15.1.34. .spec.platformSpec.vsphere.nodeNetworking
- 설명
- nodeNetworking에는 노드의 네트워킹을 할당하기 위한 내부 및 외부 네트워크 제약 조건의 정의가 포함되어 있습니다. 이 필드를 생략하면 네트워킹은 기본적으로 단일 주소만 지원하고 발견된 첫 번째 주소를 반환하는 기존 주소 선택 동작으로 설정됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| external은 외부에서 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다. |
|
| internal은 클러스터 내에서만 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다. |
15.1.35. .spec.platformSpec.vsphere.nodeNetworking.external
- 설명
- external은 외부에서 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| status.addresses 필드에 사용할 VirtualMachine의 VM에서 IP 주소를 선택할 때 서브넷 범위의 excludeNetworkSubnetCidr IP 주소가 제외됩니다. --- |
|
|
status.addresses 필드를 검색할 때 사용할 Network VirtualMachine의 VM 네트워크 이름입니다. internal.networkSubnetCIDR 및 external.networkSubnetCIDR가 설정되지 않은 경우 이 네트워크에 연결된 vNIC에는 단일 IP 주소만 있어야 합니다. 사용 가능한 네트워크(포트 그룹)는 |
|
| 각 status.addresses 필드에 사용할 필드의 CIDR에 포함된 VirtualMachine의 네트워크 인터페이스의 NetworkSubnetCidr IP 주소입니다. --- |
15.1.36. .spec.platformSpec.vsphere.nodeNetworking.internal
- 설명
- internal은 클러스터 내에서만 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| status.addresses 필드에 사용할 VirtualMachine의 VM에서 IP 주소를 선택할 때 서브넷 범위의 excludeNetworkSubnetCidr IP 주소가 제외됩니다. --- |
|
|
status.addresses 필드를 검색할 때 사용할 Network VirtualMachine의 VM 네트워크 이름입니다. internal.networkSubnetCIDR 및 external.networkSubnetCIDR가 설정되지 않은 경우 이 네트워크에 연결된 vNIC에는 단일 IP 주소만 있어야 합니다. 사용 가능한 네트워크(포트 그룹)는 |
|
| 각 status.addresses 필드에 사용할 필드의 CIDR에 포함된 VirtualMachine의 네트워크 인터페이스의 NetworkSubnetCidr IP 주소입니다. --- |
15.1.37. .spec.platformSpec.vsphere.vcenters
- 설명
- vCenter에는 vCenter와 통신할 서비스의 연결 세부 정보가 있습니다. 현재 단일 vCenter만 지원됩니다. ---
- 유형
-
array
15.1.38. .spec.platformSpec.vsphere.vcenters[]
- 설명
- VSpherePlatformVCenterSpec은 vCenter 연결 필드를 저장합니다. vSphere CCM에서 사용합니다.
- 유형
-
object
- 필수 항목
-
데이터센터
-
server
-
속성 | 유형 | 설명 |
---|---|---|
|
| RHCOS vm 게스트가 있는 vCenter Datacenters 이 필드는 Cloud Controller Manager에서 사용합니다. 여기에 나열된 각 데이터 센터를 토폴로지 내에서 사용해야 합니다. |
|
| port는 vCenter 엔드포인트와 통신하는 데 사용할 TCP 포트입니다. 생략하면 사용자에게 의견이 없으며 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택하는 것이 플랫폼에 달려 있습니다. |
|
| server는 정규화된 도메인 이름 또는 vCenter 서버의 IP 주소입니다. --- |
15.1.39. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalURL은 스키마 'https', 주소 및 선택적으로 포트(기본값: 443)가 있는 유효한 URI입니다. Kubernetes 네트워킹이 아닌 인프라 공급자를 사용하여 kubelets와 같은 구성 요소에서 apiServerInternalURL을 사용할 수 있습니다. |
|
| apiServerURL은 스키마 'https', 주소 및 선택적으로 포트(선택 사항)가 있는 유효한 URI입니다. 웹 콘솔과 같은 구성 요소에서 apiServerURL을 사용하여 Kubernetes API를 찾을 위치를 사용자에게 알릴 수 있습니다. |
|
| controlPlaneTopology는 일반적으로 컨트롤 노드에서 실행되는 피연산자에 대한 기대치를 나타냅니다. 기본값은 'HighlyAvailable'이며, 이는 Operator가 "일반" 클러스터에 있는 동작을 나타냅니다. 'SingleReplica' 모드는 단일 노드 배포에서 사용되며 Operator는 고가용성 작업에 대한 피연산자를 구성하지 않아야 합니다. 'External' 모드는 컨트롤 플레인이 클러스터에 외부에 호스팅되고 해당 구성 요소가 클러스터 내에 표시되지 않음을 나타냅니다. |
|
| cpu Cryostat는 클러스터에서 CPU 파티셔닝이 현재 활성화된 기능인지 여부를 나타냅니다. CPU 파티셔닝은 이 클러스터가 특정 CPU 세트에 대한 워크로드 파티셔닝을 지원할 수 있음을 의미합니다. 유효한 값은 "None" 및 "AllNodes"입니다. 생략하면 기본값은 "없음"입니다. 기본값 "없음"은 CPU 파티셔닝으로 노드가 설정되지 않음을 나타냅니다. "AllNodes" 값은 모든 노드가 CPU 파티셔닝으로 설정되었음을 나타내며 PerformanceProfile API를 통해 추가로 구성할 수 있습니다. |
|
| etcdDiscoveryDomain은 etcd 서버 및 클라이언트를 검색하기 위해 SRV 레코드를 가져오는 데 사용되는 도메인입니다. 자세한 정보: https://github.com/etcd-io/etcd/blob/329be66e8b3f9e2e6af83c123ff89297e49ebd15/Documentation/op-guide/clustering.md#dns-discovery 더 이상 사용되지 않음: 4.7부터 이 필드는 더 이상 설정되거나 적용되지 않습니다. 향후 릴리스에서 제거됩니다. |
|
| infrastructureName은 사람이 친숙한 이름으로 클러스터를 고유하게 식별합니다. 설정한 후에는 변경할 수 없습니다. 최대 길이 27이어야 하며 영숫자 또는 하이픈 문자만 있어야 합니다. |
|
|
infrastructureTopology는 컨트롤 플레인 노드에서 실행되지 않는 인프라 서비스에 대한 기대치를 표현합니다. 일반적으로 |
|
| 플랫폼은 클러스터의 기본 인프라 공급자입니다. deprecated: 대신 platformStatus.type을 사용합니다. |
|
| platformStatus는 기본 인프라 공급자와 관련된 상태 정보를 보유합니다. |
15.1.40. .status.platformStatus
- 설명
- platformStatus는 기본 인프라 공급자와 관련된 상태 정보를 보유합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다. |
|
| EquinixMetal에는 Equinix Metal 인프라 공급자에 대한 설정이 포함되어 있습니다. |
|
| external에는 일반 외부 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| GCP에는 Google Cloud Platform 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다. |
|
| ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| PowerVS에는 Power Systems Virtual Servers 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
|
type은 클러스터의 기본 인프라 공급자입니다. 이 값은 서비스 로드 밸런서, 동적 볼륨 프로비저닝, 머신 생성 및 삭제와 같은 인프라 자동화가 활성화되는지 여부를 제어합니다. None인 경우 인프라 자동화가 활성화되지 않습니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" 및 "None"입니다. 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 해당 플랫폼을 지원하지 않는 경우 인식되지 않은 플랫폼을 None으로 처리해야 합니다. 이 값은 |
|
| vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
15.1.41. .status.platformStatus.alibabaCloud
- 설명
- alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
region
-
속성 | 유형 | 설명 |
---|---|---|
|
| region은 클러스터에 대해 생성된 Alibaba Cloud 리소스의 리전을 지정합니다. |
|
| resourceGroupID는 클러스터의 리소스 그룹의 ID입니다. |
|
| resourceTags는 클러스터에 대해 생성된 Alibaba Cloud 리소스에 적용할 추가 태그 목록입니다. |
|
| AlibabaCloudResourceTag는 리소스에 적용할 태그 세트입니다. |
15.1.42. .status.platformStatus.alibabaCloud.resourceTags
- 설명
- resourceTags는 클러스터에 대해 생성된 Alibaba Cloud 리소스에 적용할 추가 태그 목록입니다.
- 유형
-
array
15.1.43. .status.platformStatus.alibabaCloud.resourceTags[]
- 설명
- AlibabaCloudResourceTag는 리소스에 적용할 태그 세트입니다.
- 유형
-
object
- 필수 항목
-
key
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 태그의 키입니다. |
|
| value는 태그의 값입니다. |
15.1.44. .status.platformStatus.aws
- 설명
- AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 리전에는 클러스터에서 생성한 새 AWS 리소스의 기본 AWS 리전이 있습니다. |
|
| resourceTags는 클러스터에 대해 생성된 AWS 리소스에 적용할 추가 태그 목록입니다. AWS 리소스 태그 지정에 대한 자세한 내용은 https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html 을 참조하십시오. AWS는 리소스당 최대 50개의 태그를 지원합니다. OpenShift는 사용할 수 있도록 25개의 태그를 예약하고 사용자가 사용할 수 있는 25개의 태그를 사용할 수 있습니다. |
|
| AWSResourceTag는 클러스터에 대해 생성된 AWS 리소스에 적용할 태그입니다. |
|
| serviceEndpoints 목록에는 AWS Services의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점이 포함되어 있습니다. 서비스에는 하나의 ServiceEndpoint만 있어야 합니다. |
|
| AWSServiceEndpoint는 사용자 정의 URL 구성을 저장하여 AWS Services의 기존 기본값을 재정의합니다. |
15.1.45. .status.platformStatus.aws.resourceTags
- 설명
- resourceTags는 클러스터에 대해 생성된 AWS 리소스에 적용할 추가 태그 목록입니다. AWS 리소스 태그 지정에 대한 자세한 내용은 https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html 을 참조하십시오. AWS는 리소스당 최대 50개의 태그를 지원합니다. OpenShift는 사용할 수 있도록 25개의 태그를 예약하고 사용자가 사용할 수 있는 25개의 태그를 사용할 수 있습니다.
- 유형
-
array
15.1.46. .status.platformStatus.aws.resourceTags[]
- 설명
- AWSResourceTag는 클러스터에 대해 생성된 AWS 리소스에 적용할 태그입니다.
- 유형
-
object
- 필수 항목
-
key
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 태그의 키입니다. |
|
| value는 태그의 값입니다. 일부 AWS 서비스는 빈 값을 지원하지 않습니다. 태그가 많은 서비스의 리소스에 추가되므로 태그 값의 길이는 모든 서비스의 요구 사항을 충족해야 합니다. |
15.1.47. .status.platformStatus.aws.serviceEndpoints
- 설명
- serviceEndpoints 목록에는 AWS Services의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점이 포함되어 있습니다. 서비스에는 하나의 ServiceEndpoint만 있어야 합니다.
- 유형
-
array
15.1.48. .status.platformStatus.aws.serviceEndpoints[]
- 설명
- AWSServiceEndpoint는 사용자 정의 URL 구성을 저장하여 AWS Services의 기존 기본값을 재정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 AWS 서비스의 이름입니다. 모든 서비스 이름 목록은 https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html 에서 확인할 수 있으며 제공해야 하며 비워 둘 수 없습니다. |
|
| URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다. |
15.1.49. .status.platformStatus.azure
- 설명
- Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| armEndpoint는 Azure Stack과 같이 정렬되지 않은 클라우드에서 리소스 관리에 사용할 URL을 지정합니다. |
|
|
cloudName은 적절한 Azure API 엔드포인트로 Azure SDK를 구성하는 데 사용할 수 있는 Azure 클라우드 환경의 이름입니다. 비어 있는 경우 값은 |
|
| NetworkResourceGroupName은 클러스터에서 사용하는 가상 네트워크 및 서브넷과 같은 네트워크 리소스의 리소스 그룹입니다. 비어 있는 경우 값은 ResourceGroupName과 동일합니다. |
|
| resourceGroupName은 클러스터에 대해 생성된 새 Azure 리소스의 리소스 그룹입니다. |
|
| resourceTags는 클러스터에 대해 생성된 Azure 리소스에 적용할 추가 태그 목록입니다. Azure 리소스에 태그 지정에 대한 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/resources/tags 을 참조하십시오. Automation, Content Delivery Network, DNS Azure 리소스에 대한 제한으로 인해 최대 15개의 태그가 적용될 수 있습니다. OpenShift는 내부 사용을 위해 5개의 태그를 예약하여 사용자 구성에 10개의 태그를 허용합니다. |
|
| AzureResourceTag는 클러스터에 대해 생성된 Azure 리소스에 적용할 태그입니다. |
15.1.50. .status.platformStatus.azure.resourceTags
- 설명
- resourceTags는 클러스터에 대해 생성된 Azure 리소스에 적용할 추가 태그 목록입니다. Azure 리소스에 태그 지정에 대한 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/resources/tags 을 참조하십시오. Automation, Content Delivery Network, DNS Azure 리소스에 대한 제한으로 인해 최대 15개의 태그가 적용될 수 있습니다. OpenShift는 내부 사용을 위해 5개의 태그를 예약하여 사용자 구성에 10개의 태그를 허용합니다.
- 유형
-
array
15.1.51. .status.platformStatus.azure.resourceTags[]
- 설명
- AzureResourceTag는 클러스터에 대해 생성된 Azure 리소스에 적용할 태그입니다.
- 유형
-
object
- 필수 항목
-
key
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
|
key는 태그의 주요 부분입니다. 태그 키는 최대 128자를 가질 수 있으며 비워 둘 수 없습니다. key는 문자, 숫자 또는 밑줄로 끝나야 하며 영숫자와 다음과 같은 특수 문자만 포함해야 합니다. |
|
|
value는 태그의 값 부분입니다. 태그 값은 최대 256자일 수 있으며 비워 둘 수 없습니다. value에는 영숫자만 포함되어야 하며 다음 특수 문자 |
15.1.52. .status.platformStatus.baremetal
- 설명
- baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다. |
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다. |
|
| machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. |
|
|
nodeDNSIP는 노드에서 사용하는 내부 DNS의 IP 주소입니다. DNS Operator에서 관리하는 것과 달리 |
15.1.53. .status.platformStatus.baremetal.loadBalancer
- 설명
- LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 OpenShift API 및 Ingress 엔드포인트에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 BareMetal 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다. |
15.1.54. .status.platformStatus.equinixMetal
- 설명
- EquinixMetal에는 Equinix Metal 인프라 공급자에 대한 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. |
15.1.55. .status.platformStatus.external
- 설명
- external에는 일반 외부 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CloudControllerManager에는 외부 클라우드 컨트롤러 관리자(a.k.a)와 관련된 설정이 포함되어 있습니다. CCM 또는 CPI). 생략하면 새 노드가 테인트되지 않으며 클라우드 컨트롤러 관리자에서 추가 초기화가 필요하지 않습니다. |
15.1.56. .status.platformStatus.external.cloudControllerManager
- 설명
- CloudControllerManager에는 외부 클라우드 컨트롤러 관리자(a.k.a)와 관련된 설정이 포함되어 있습니다. CCM 또는 CPI). 생략하면 새 노드가 테인트되지 않으며 클라우드 컨트롤러 관리자에서 추가 초기화가 필요하지 않습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 상태에 따라 외부 Cloud Controller Manager가 클러스터 내에 설치될 것으로 예상되는지의 여부가 결정됩니다. https://kubernetes.io/docs/tasks/administer-cluster/running-cloud-controller/#running-cloud-controller-manager 유효한 값은 "외부", "없음" 및 생략됩니다. "External"로 설정하면 새 노드가 생성될 때 초기화되지 않은 상태로 테인트되므로 클라우드 컨트롤러 관리자가 초기화할 때까지 워크로드가 실행되지 않습니다. 생략하거나 "없음"으로 설정하면 새 노드가 테인트되지 않고 클라우드 컨트롤러 관리자에서 추가 초기화가 예상되지 않습니다. |
15.1.57. .status.platformStatus.gcp
- 설명
- GCP에는 Google Cloud Platform 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| resourceGroupName은 클러스터에 대해 생성된 새 GCP 리소스의 프로젝트 ID입니다. |
|
| 리전에는 클러스터에 대해 생성된 새 GCP 리소스의 리전이 있습니다. |
|
| resourceLabels는 클러스터에 대해 생성된 GCP 리소스에 적용할 추가 레이블 목록입니다. GCP 리소스에 레이블을 지정하는 방법에 대한 자세한 내용은 https://cloud.google.com/compute/docs/labeling-resources 을 참조하십시오. GCP는 리소스당 최대 64개의 라벨을 지원합니다. OpenShift는 내부 사용을 위해 32 레이블을 예약하여 사용자 구성에 32개의 레이블을 허용합니다. |
|
| GCPResourceLabel은 클러스터에 대해 생성된 GCP 리소스에 적용할 레이블입니다. |
|
| resourceTags는 클러스터에 대해 생성된 GCP 리소스에 적용할 추가 태그 목록입니다. GCP 리소스 태그 지정에 대한 자세한 내용은 https://cloud.google.com/resource-manager/docs/tags/tags-overview 을 참조하십시오. GCP는 리소스당 최대 50개의 태그를 지원합니다. |
|
| GCPResourceTag는 클러스터에 대해 생성된 GCP 리소스에 적용할 태그입니다. |
15.1.58. .status.platformStatus.gcp.resourceLabels
- 설명
- resourceLabels는 클러스터에 대해 생성된 GCP 리소스에 적용할 추가 레이블 목록입니다. GCP 리소스에 레이블을 지정하는 방법에 대한 자세한 내용은 https://cloud.google.com/compute/docs/labeling-resources 을 참조하십시오. GCP는 리소스당 최대 64개의 라벨을 지원합니다. OpenShift는 내부 사용을 위해 32 레이블을 예약하여 사용자 구성에 32개의 레이블을 허용합니다.
- 유형
-
array
15.1.59. .status.platformStatus.gcp.resourceLabels[]
- 설명
- GCPResourceLabel은 클러스터에 대해 생성된 GCP 리소스에 적용할 레이블입니다.
- 유형
-
object
- 필수 항목
-
key
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
|
key는 라벨의 핵심 부분입니다. 레이블 키는 최대 63자의 수 있으며 비워 둘 수 없습니다. 레이블 키는 소문자로 시작해야 하며 소문자, 숫자 문자 및 다음 특수 문자 |
|
|
value는 레이블의 값 부분입니다. 레이블 값은 최대 63자의 수 있으며 비워 둘 수 없습니다. value에는 소문자, 숫자 문자 및 다음 특수 문자 |
15.1.60. .status.platformStatus.gcp.resourceTags
- 설명
- resourceTags는 클러스터에 대해 생성된 GCP 리소스에 적용할 추가 태그 목록입니다. GCP 리소스 태그 지정에 대한 자세한 내용은 https://cloud.google.com/resource-manager/docs/tags/tags-overview 을 참조하십시오. GCP는 리소스당 최대 50개의 태그를 지원합니다.
- 유형
-
array
15.1.61. .status.platformStatus.gcp.resourceTags[]
- 설명
- GCPResourceTag는 클러스터에 대해 생성된 GCP 리소스에 적용할 태그입니다.
- 유형
-
object
- 필수 항목
-
key
-
parentID
-
value
-
속성 | 유형 | 설명 |
---|---|---|
|
|
key는 태그의 주요 부분입니다. 태그 키는 최대 63자의 수 있으며 비워 둘 수 없습니다. 태그 키는 영숫자 문자로 시작하고 끝나야 하며 대문자, 소문자 영숫자 및 다음 특수 문자 |
|
| ParentID는 조직 또는 프로젝트 수준에서 태그가 정의된 계층 리소스의 ID입니다. 조직 또는 프로젝트 ID를 찾으려면 https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id , https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects 페이지를 참조하십시오. OrganizationID는 10진수로 구성되어야 하며 앞에 0을 포함할 수 없습니다. ProjectID는 6~30자여야 하며 소문자, 숫자, 하이픈만 포함할 수 있으며 문자로 시작해야 하며 하이픈으로 끝낼 수 없습니다. |
|
|
value는 태그의 값 부분입니다. 태그 값은 최대 63자의 수 있으며 비워 둘 수 없습니다. 태그 값은 영숫자 문자로 시작하고 끝나야 하며 대문자, 소문자 영숫자 및 다음 특수 문자 |
15.1.62. .status.platformStatus.ibmcloud
- 설명
- IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CISInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 Cloud Internet Services 인스턴스의 CRN입니다. |
|
| DNSInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 DNS 서비스 인스턴스의 CRN입니다. |
|
| Location is where the cluster has been deployed |
|
| ProviderType은 생성된 클러스터 유형을 나타냅니다. |
|
| resourceGroupName은 클러스터에 대해 생성된 새 IBMCloud 리소스의 리소스 그룹입니다. |
|
| serviceEndpoints는 IBM Cloud 서비스의 기본 서비스 끝점을 재정의하는 사용자 정의 끝점 목록입니다. 이러한 끝점은 각 IBM Cloud Services에 도달하기 위해 클러스터 내의 구성 요소에서 사용됩니다. |
|
| IBMCloudServiceEndpoint는 IBM Cloud Services의 기존 기본값을 덮어쓰는 사용자 지정 URL의 구성을 저장합니다. |
15.1.63. .status.platformStatus.ibmcloud.serviceEndpoints
- 설명
- serviceEndpoints는 IBM Cloud 서비스의 기본 서비스 끝점을 재정의하는 사용자 정의 끝점 목록입니다. 이러한 끝점은 각 IBM Cloud Services에 도달하기 위해 클러스터 내의 구성 요소에서 사용됩니다.
- 유형
-
array
15.1.64. .status.platformStatus.ibmcloud.serviceEndpoints[]
- 설명
- IBMCloudServiceEndpoint는 IBM Cloud Services의 기존 기본값을 덮어쓰는 사용자 지정 URL의 구성을 저장합니다.
- 유형
-
object
- 필수 항목
-
name
-
url
-
속성 | 유형 | 설명 |
---|---|---|
|
|
이름은 IBM Cloud 서비스의 이름입니다. 가능한 값은 CIS, COSConfig, DNSServices, GlobalCatalog, GlobalSearch, GlobalTagging, HyperProtect, IAM, KeyProtect, ResourceController, ResourceManager 또는 VPC입니다. 예를 들어 IBM Cloud Private |
|
| URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다. |
15.1.65. .status.platformStatus.kubevirt
- 설명
- kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. |
15.1.66. .status.platformStatus.nutanix
- 설명
- Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다. |
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다. |
15.1.67. .status.platformStatus.nutanix.loadBalancer
- 설명
- LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 OpenShift API 및 Ingress 끝점에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 Nutanix 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다. |
15.1.68. .status.platformStatus.openstack
- 설명
- OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다. |
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
|
cloudName은 클라이언트 구성 파일( |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다. |
|
| machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. |
|
|
nodeDNSIP는 노드에서 사용하는 내부 DNS의 IP 주소입니다. DNS Operator에서 관리하는 것과 달리 |
15.1.69. .status.platformStatus.openstack.loadBalancer
- 설명
- LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 OpenShift API 및 Ingress 엔드포인트에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 OpenStack 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다. |
15.1.70. .status.platformStatus.ovirt
- 설명
- ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다. |
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다. |
|
| 더 이상 사용되지 않음: 4.6부터 이 필드는 더 이상 설정되거나 적용되지 않습니다. 향후 릴리스에서 제거됩니다. |
15.1.71. .status.platformStatus.ovirt.loadBalancer
- 설명
- LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 OpenShift API 및 Ingress 끝점에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 Ovirt 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다. |
15.1.72. .status.platformStatus.powervs
- 설명
- PowerVS에는 Power Systems Virtual Servers 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CISInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 Cloud Internet Services 인스턴스의 CRN입니다. |
|
| DNSInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 DNS 서비스 인스턴스의 CRN입니다. |
|
| 리전에는 클러스터에서 생성한 새 Power VS 리소스의 기본 Power VS 리전이 있습니다. |
|
| ResourceGroup은 클러스터에 대해 생성된 새 IBMCloud 리소스의 리소스 그룹 이름입니다. 여기에 지정된 리소스 그룹은 cluster-image-registry-operator에서 클러스터 레지스트리의 IBMCloud에 COS 인스턴스를 설정하는 데 사용됩니다. 리소스 그룹에 대한 자세한 내용은 여기에서 확인할 수 있습니다. https://cloud.ibm.com/docs/account?topic=account-rgs. 생략하면 이미지 레지스트리 Operator가 스토리지를 구성할 수 없으므로 이미지 레지스트리 클러스터 Operator가 사용 가능한 상태가 되지 않습니다. |
|
| serviceEndpoints는 Power VS 서비스의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점 목록입니다. |
|
| PowervsServiceEndpoint는 사용자 지정 URL의 구성을 저장하여 PowerVS 서비스의 기존 기본값을 재정의합니다. |
|
| zone에는 클러스터에서 생성한 새 Power VS 리소스의 기본 영역이 있습니다. 참고: 현재 단일 영역 OCP 클러스터만 지원됩니다. |
15.1.73. .status.platformStatus.powervs.serviceEndpoints
- 설명
- serviceEndpoints는 Power VS 서비스의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점 목록입니다.
- 유형
-
array
15.1.74. .status.platformStatus.powervs.serviceEndpoints[]
- 설명
- PowervsServiceEndpoint는 사용자 지정 URL의 구성을 저장하여 PowerVS 서비스의 기존 기본값을 재정의합니다.
- 유형
-
object
- 필수 항목
-
name
-
url
-
속성 | 유형 | 설명 |
---|---|---|
|
| 이름은 Power VS 서비스의 이름입니다. IAM 서비스 중 몇 개 - https://cloud.ibm.com/apidocs/iam-identity-token-api ResourceController - https://cloud.ibm.com/apidocs/resource-controller/resource-controller Power Cloud - https://cloud.ibm.com/apidocs/power-cloud |
|
| URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다. |
15.1.75. .status.platformStatus.vsphere
- 설명
- vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다. |
|
| apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다. |
|
| ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다. |
|
| LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다. |
|
| machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. |
|
|
nodeDNSIP는 노드에서 사용하는 내부 DNS의 IP 주소입니다. DNS Operator에서 관리하는 것과 달리 |
15.1.76. .status.platformStatus.vsphere.loadBalancer
- 설명
- LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| type은 OpenShift API 및 Ingress 엔드포인트에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 VSphere 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다. |
15.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/infrastructures
-
DELETE
: Infrastructure의 컬렉션 삭제 -
GET
: 종류의 인프라 오브젝트 나열 -
POST
: 인프라 생성
-
/apis/config.openshift.io/v1/infrastructures/{name}
-
DELETE
: 인프라 삭제 -
GET
: 지정된 인프라 읽기 -
PATCH
: 지정된 인프라를 부분적으로 업데이트 -
PUT
: 지정된 인프라를 교체
-
/apis/config.openshift.io/v1/infrastructures/{name}/status
-
GET
: 지정된 인프라의 읽기 상태 -
PATCH
: 지정된 인프라의 부분적으로 업데이트 상태 -
PUT
: 지정된 인프라의 상태
-
15.2.1. /apis/config.openshift.io/v1/infrastructures
- HTTP 방법
-
DELETE
- 설명
- 인프라 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 인프라 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 인프라 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
15.2.2. /apis/config.openshift.io/v1/infrastructures/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 인프라 이름 |
- HTTP 방법
-
DELETE
- 설명
- 인프라 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 인프라 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 인프라를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 인프라를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
15.2.3. /apis/config.openshift.io/v1/infrastructures/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 인프라 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 인프라의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 인프라의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 인프라의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
16장. Ingress [config.openshift.io/v1]
- 설명
-
Ingress에는 경로에 사용되는 기본 인그레스 도메인을 포함하여 Ingress에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
16.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
16.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| appsDomain은 명시적 호스트를 지정하지 않고 경로가 생성될 때 도메인 필드에 지정된 대신 사용할 선택적 도메인입니다. appsDomain이 비어 있지 않은 경우 이 값은 경로의 기본 호스트 값을 생성하는 데 사용됩니다. domain과 달리 appsDomain은 설치 후 수정할 수 있습니다. 이는 새 ingresscontroller가 와일드카드 인증서로 설정되었다고 가정합니다. |
|
| componentRoutes는 cluster-admin이 호스트 이름 및 제공 인증서를 구성할 수 있는 OpenShift 구성 요소에서 관리하는 선택적 경로 목록입니다. 이 목록에 있는 각 경로의 네임스페이스 및 이름은 status.componentRoutes 목록의 기존 항목과 일치해야 합니다. 구성 가능한 경로 세트를 확인하려면 .status.componentRoutes 목록의 네임스페이스 및 항목 이름을 확인합니다. 여기서 참여 Operator는 구성 가능한 경로의 상태를 작성합니다. |
|
| ComponentRouteSpec을 사용하면 경로의 호스트 이름 및 인증서를 제공할 수 있습니다. |
|
| 도메인은 경로의 호스트 이름이 비어 있을 때 경로에 대한 기본 호스트 이름을 생성하는 데 사용됩니다. 생성된 호스트 이름은 "<route-name>.<route-namespace>.<domain>" 패턴을 따릅니다. 또한 수신에 대한 기본 와일드카드 도메인 접미사로 사용됩니다. 기본 ingresscontroller 도메인은 "*.<domain>" 패턴을 따릅니다. 설정한 후에는 도메인 변경이 현재 지원되지 않습니다. |
|
| LoadBalancer에는 현재 클러스터의 기본 인프라 공급자뿐만 아니라 OpenShift에서 작업하는 데 필요한 로드 밸런서 세부 정보가 포함되어 있습니다. |
|
| requiredHSTSPolicies는 정책에 지정된 domainPattern/s 및 namespaceSelector/s와 일치하는 새로 생성 또는 업데이트된 경로에 설정해야 하는 HSTS 정책을 지정합니다. 각 requiredHSTSPolicy에는 경로 HSTS 정책 경로 주석을 검증하고 경로 승인에 영향을 미치는 domainPattern 및 maxAge가 있어야 합니다. HSTS 정책 경로 주석이 있는 경우 HSTS 정책에 대해 후보 경로를 확인합니다. "haproxy.router.openshift.io/hsts_header" E.g. haproxy.openshift.io/hsts_header: max-age=31536000;preload;includeSubDomains - 필요한HSTSPolicy domainPatern 및 선택적 namespaceSelector와 일치하는 경우 그런 다음 maxAge, preloadPolicy 및 includeSubdomainsPolicy를 허용하려면 유효해야 합니다. 그렇지 않으면 경로가 거부됩니다. - RequiredHSTSPolicies의 순서에 따라 domainPattern 및 선택적 namespaceSelector에 의해 첫 번째 일치는 경로의 승인 상태를 결정합니다. - candidate 경로가 requiredHSTSPolicy domainPattern 및 optional namespaceSelector와 일치하지 않는 경우 모든 HSTS 정책 주석을 사용할 수 있습니다. 경로가 이미 생성된 후 HSTS 정책 구성이 변경될 수 있습니다. 업데이트된 경로가 업데이트된 HSTS 정책 구성을 준수하지 않으면 이전에 승인한 경로에 대한 업데이트가 실패할 수 있습니다. 그러나 HSTS 정책 구성을 변경하면 이미 작동하지 않는 경로가 발생하지 않습니다. RequiredHSTSPolicies가 없는 경우 경로의 HSTS 정책 주석이 유효합니다. |
|
|
16.1.2. .spec.componentRoutes
- 설명
- componentRoutes는 cluster-admin이 호스트 이름 및 제공 인증서를 구성할 수 있는 OpenShift 구성 요소에서 관리하는 선택적 경로 목록입니다. 이 목록에 있는 각 경로의 네임스페이스 및 이름은 status.componentRoutes 목록의 기존 항목과 일치해야 합니다. 구성 가능한 경로 세트를 확인하려면 .status.componentRoutes 목록의 네임스페이스 및 항목 이름을 확인합니다. 여기서 참여 Operator는 구성 가능한 경로의 상태를 작성합니다.
- 유형
-
array
16.1.3. .spec.componentRoutes[]
- 설명
- ComponentRouteSpec을 사용하면 경로의 호스트 이름 및 인증서를 제공할 수 있습니다.
- 유형
-
object
- 필수 항목
-
hostname
-
name
-
네임스페이스
-
속성 | 유형 | 설명 |
---|---|---|
|
| hostname은 경로에서 사용해야 하는 호스트 이름입니다. |
|
| name은 사용자 지정할 경로의 논리 이름입니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 status.componentRoutes 목록의 해당 항목과 일치해야 합니다. |
|
| 네임스페이스는 사용자 지정할 경로의 네임스페이스입니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 status.componentRoutes 목록의 해당 항목과 일치해야 합니다. |
|
|
servingCertKeyPairSecret은 openshift-config 네임스페이스에 있는 |
16.1.4. .spec.componentRoutes[].servingCertKeyPairSecret
- 설명
-
servingCertKeyPairSecret은 openshift-config 네임스페이스에 있는
kubernetes.io/tls
유형의 보안에 대한 참조입니다. 제공 인증서/키 쌍은 일치하고 Operator가 이 이름으로 제공하려는 의도를 이행하기 위해 사용해야 합니다. 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다. - 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
16.1.5. .spec.loadBalancer
- 설명
- LoadBalancer에는 현재 클러스터의 기본 인프라 공급자뿐만 아니라 OpenShift에서 작업하는 데 필요한 로드 밸런서 세부 정보가 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 플랫폼에는 인그레스 로드 밸런서의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. |
16.1.6. .spec.loadBalancer.platform
- 설명
- 플랫폼에는 인그레스 로드 밸런서의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다. |
|
| type은 클러스터의 기본 인프라 공급자입니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" 및 "None"입니다. 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 해당 플랫폼을 지원하지 않는 경우 인식되지 않은 플랫폼을 None으로 처리해야 합니다. |
16.1.7. .spec.loadBalancer.platform.aws
- 설명
- AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
type
-
속성 | 유형 | 설명 |
---|---|---|
|
| type을 사용하면 사용자가 로드 밸런서 유형을 설정할 수 있습니다. 이 필드를 설정하면 기본 ingresscontroller가 지정된 LBType을 사용하여 생성됩니다. 이 필드를 설정하지 않으면 LBType Classic의 기본 수신 컨트롤러가 생성됩니다. 유효한 값은 * "Classic": 전송 계층(TCP/SSL) 또는 애플리케이션 계층(HTTP/HTTPS)에서 라우팅을 결정하는 Classic Load Balancer입니다. 자세한 내용은 https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#clb * "NLB": 전송 계층(TCP/SSL)에서 라우팅을 결정하는 네트워크 로드 밸런서 장치입니다. 자세한 내용은 다음을 참조하십시오. https://docs.aws.amazon.com/AmazonECS/latest/developerguide/load-balancer-types.html#nlb |
16.1.8. .spec.requiredHSTSPolicies
- 설명
- requiredHSTSPolicies는 정책에 지정된 domainPattern/s 및 namespaceSelector/s와 일치하는 새로 생성 또는 업데이트된 경로에 설정해야 하는 HSTS 정책을 지정합니다. 각 requiredHSTSPolicy에는 경로 HSTS 정책 경로 주석을 검증하고 경로 승인에 영향을 미치는 domainPattern 및 maxAge가 있어야 합니다. HSTS 정책 경로 주석이 있는 경우 HSTS 정책에 대해 후보 경로를 확인합니다. "haproxy.router.openshift.io/hsts_header" E.g. haproxy.openshift.io/hsts_header: max-age=31536000;preload;includeSubDomains - 필요한HSTSPolicy domainPatern 및 선택적 namespaceSelector와 일치하는 경우 그런 다음 maxAge, preloadPolicy 및 includeSubdomainsPolicy를 허용하려면 유효해야 합니다. 그렇지 않으면 경로가 거부됩니다. - RequiredHSTSPolicies의 순서에 따라 domainPattern 및 선택적 namespaceSelector에 의해 첫 번째 일치는 경로의 승인 상태를 결정합니다. - candidate 경로가 requiredHSTSPolicy domainPattern 및 optional namespaceSelector와 일치하지 않는 경우 모든 HSTS 정책 주석을 사용할 수 있습니다. 경로가 이미 생성된 후 HSTS 정책 구성이 변경될 수 있습니다. 업데이트된 경로가 업데이트된 HSTS 정책 구성을 준수하지 않으면 이전에 승인한 경로에 대한 업데이트가 실패할 수 있습니다. 그러나 HSTS 정책 구성을 변경하면 이미 작동하지 않는 경로가 발생하지 않습니다. RequiredHSTSPolicies가 없는 경우 경로의 HSTS 정책 주석이 유효합니다.
- 유형
-
array
16.1.9. .spec.requiredHSTSPolicies[]
- 설명
- 유형
-
object
- 필수 항목
-
domainPatterns
-
속성 | 유형 | 설명 |
---|---|---|
|
| domainPatterns는 원하는 HSTS 주석이 필요한 도메인 목록입니다. domainPatterns가 지정되고 도메인 중 하나와 일치하는 spec.host로 경로가 생성되는 경우 경로는 일치하는 RequiredHSTSPolicy에 설명된 HSTS 정책 구성 요소를 지정해야 합니다. 다음과 같이 와일드카드를 사용할 수 있습니다. .foo.com은 foo.com 아래의 모든 항목과 일치하므로 foo.com과 그 아래의 모든 항목을 포함하려면 *를 지정해야 합니다. |
|
| includeSubDomainsPolicy는 HSTS 정책이 호스트 도메인 이름의 모든 하위 도메인에 적용되어야 함을 의미합니다. 따라서 호스트 bar.foo.com의 경우 includeSubDomainsPolicy가 RequireIncludeSubDomains로 설정된 경우 - 호스트 app.bar.foo.com은 bar.foo.com의 HSTS 정책을 상속합니다 - host bar.foo.com은 bar.foo.com의 HSTS 정책을 상속합니다. foo.com은 bar.foo.com의 HSTS 정책을 상속하지 않습니다. |
|
| maxAge는 HSTS 호스트로 간주되는 호스트 중 delta 시간 범위(초)입니다. 0으로 설정하면 효과가 무효화되고 호스트는 HSTS 호스트로 제거됩니다. 0으로 설정하고 includeSubdomains가 지정되면 호스트의 모든 하위 도메인도 HSTS 호스트로 제거됩니다. maxAge는 time-to-live 값이며 이 정책이 클라이언트에서 새로 고쳐지지 않으면 HSTS 정책이 결국 해당 클라이언트에 만료됩니다. |
|
| namespaceSelector는 선택기와 일치하는 라벨이 있고 DomainPatterns 중 하나에 있는 네임스페이스에 있는 네임스페이스에만 정책이 적용되도록 라벨 선택기를 지정합니다. 기본값은 모든 것과 일치하는 빈 LabelSelector입니다. |
|
| preloadPolicy는 클라이언트에서 HSTS 헤더를 가져오기 위해 초기 로드를 수행할 필요가 없도록 호스트 preload 목록에 호스트를 포함하도록 지시합니다(이는 RFC 6797에 정의되어 있지 않으며 따라서 클라이언트 구현에 종속적임). |
16.1.10. .spec.requiredHSTSPolicies[].maxAge
- 설명
- maxAge는 HSTS 호스트로 간주되는 호스트 중 delta 시간 범위(초)입니다. 0으로 설정하면 효과가 무효화되고 호스트는 HSTS 호스트로 제거됩니다. 0으로 설정하고 includeSubdomains가 지정되면 호스트의 모든 하위 도메인도 HSTS 호스트로 제거됩니다. maxAge는 time-to-live 값이며 이 정책이 클라이언트에서 새로 고쳐지지 않으면 HSTS 정책이 결국 해당 클라이언트에 만료됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| RequiredHSTSPolicy max-age 이 값은 지정되지 않은 상태로 둘 수 있으며 이 경우 상한이 적용되지 않습니다. |
|
| RequiredHSTSPolicy max-age Setting max-age=0의 최소 허용된 값(초)에서는 호스트에서 기존 HSTS 헤더를 삭제할 수 있습니다. 이는 관리자가 오류를 신속하게 수정하는 데 필요한 도구입니다. 이 값은 지정되지 않은 상태로 둘 수 있습니다. 이 경우 더 낮은 제한이 적용되지 않습니다. |
16.1.11. .spec.requiredHSTSPolicies[].namespaceSelector
- 설명
- namespaceSelector는 선택기와 일치하는 라벨이 있고 DomainPatterns 중 하나에 있는 네임스페이스에 있는 네임스페이스에만 정책이 적용되도록 라벨 선택기를 지정합니다. 기본값은 모든 것과 일치하는 빈 LabelSelector입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다. |
|
| 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다. |
|
| matchLabels는 {key,value} 쌍으로 구성된 맵입니다. matchLabels 맵의 단일 {key,value}는 키 필드가 "key"이고, 연산자는 "In"이고, values 배열에는 "value"만 포함된 matchExpressions 요소와 동일합니다. 요구 사항은 AND로 설정됩니다. |
16.1.12. .spec.requiredHSTSPolicies[].namespaceSelector.matchExpressions
- 설명
- matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.
- 유형
-
array
16.1.13. .spec.requiredHSTSPolicies[].namespaceSelector.matchExpressions[]
- 설명
- 레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.
- 유형
-
object
- 필수 항목
-
key
-
operator
-
속성 | 유형 | 설명 |
---|---|---|
|
| key는 선택기가 적용되는 라벨 키입니다. |
|
| Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다. |
|
| 값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다. |
16.1.14. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| componentRoutes는 참여 연산자가 cluster-admin에 의해 호스트 이름 및 제공 인증서를 사용자 지정할 수 있는 경로에 대한 현재 경로 상태를 배치하는 위치입니다. |
|
| ComponentRouteStatus에는 경로의 호스트 이름 구성 및 제공 인증서를 허용하는 정보가 포함되어 있습니다. |
|
| 기본적으로 Ingress 라우터 Pod를 호스팅할 노드를 제어하기 위해 설치 시 defaultPlacement가 설정됩니다. 옵션은 control-plane 노드 또는 작업자 노드입니다. 이 필드는 해당 배포를 생성할 때 IngressController 리소스에서 Cluster Ingress Operator가 설정되지 않은 복제본 및 nodePlacement 필드를 구성하는 방법을 사전 지정하여 작동합니다. 자세한 내용은 IngressController replicas 및 nodePlacement 필드에 대한 설명서를 참조하십시오. 생략하면 기본값은 Workers입니다. |
16.1.15. .status.componentRoutes
- 설명
- componentRoutes는 참여 연산자가 cluster-admin에 의해 호스트 이름 및 제공 인증서를 사용자 지정할 수 있는 경로에 대한 현재 경로 상태를 배치하는 위치입니다.
- 유형
-
array
16.1.16. .status.componentRoutes[]
- 설명
- ComponentRouteStatus에는 경로의 호스트 이름 구성 및 제공 인증서를 허용하는 정보가 포함되어 있습니다.
- 유형
-
object
- 필수 항목
-
defaultHostname
-
name
-
네임스페이스
-
relatedObjects
-
속성 | 유형 | 설명 |
---|---|---|
|
| 조건은 componentRoutes 항목의 상태를 전달하는 데 사용됩니다. 지원되는 상태에는 Available, Degraded 및 Progressing이 포함됩니다. 사용 가능한 경우 경로에서 제공하는 콘텐츠에 사용자가 액세스할 수 있습니다. 여기에는 cluster-admin에서 지정한 사용자 지정 경로가 구성된 동안 기본값이 계속 콘텐츠를 제공할 수 있는 경우가 포함됩니다. Degraded가 true인 경우 componentRoutes 항목을 처리하려고 하는 데 문제가 발생했습니다. currentHostnames 필드는 적용되거나 적용되지 않을 수 있습니다. Progressing이 true인 경우 구성 요소가 componentRoutes 항목과 관련된 몇 가지 작업을 수행 중임을 의미합니다. |
|
|
condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] |
|
| consumingUsers는 servingCertKeyPairSecret 보안에 대한 읽기 권한이 필요한 ServiceAccounts 슬라이스입니다. |
|
| currentHostnames는 경로에서 사용하는 현재 이름 목록입니다. 일반적으로 이 목록은 단일 호스트 이름으로 구성되어야 하지만 경로에서 여러 호스트 이름을 지원하는 경우 Operator는 이 목록에 여러 항목을 작성할 수 있습니다. |
|
| defaultHostName은 사용자 지정 전에 이 경로의 호스트 이름입니다. |
|
| name은 사용자 지정할 경로의 논리 이름입니다. 경로 리소스의 실제 이름일 필요는 없지만 이름을 변경할 수 없습니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 spec.componentRoutes 목록의 해당 항목과 일치해야 합니다. |
|
| 네임스페이스는 사용자 지정할 경로의 네임스페이스입니다. 실제 네임스페이스여야 합니다. 실제 네임스페이스를 사용하면 두 구성 요소가 충돌하지 않으며 동일한 구성 요소를 여러 번 설치할 수 있습니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 spec.componentRoutes 목록의 해당 항목과 일치해야 합니다. |
|
| relatedObjects는 spec.componentRoutes가 적용되는 방법을 디버깅하거나 검사할 때 유용한 리소스 목록입니다. |
|
| ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다. |
16.1.17. .status.componentRoutes[].conditions
- 설명
- 조건은 componentRoutes 항목의 상태를 전달하는 데 사용됩니다. 지원되는 상태에는 Available, Degraded 및 Progressing이 포함됩니다. 사용 가능한 경우 경로에서 제공하는 콘텐츠에 사용자가 액세스할 수 있습니다. 여기에는 cluster-admin에서 지정한 사용자 지정 경로가 구성된 동안 기본값이 계속 콘텐츠를 제공할 수 있는 경우가 포함됩니다. Degraded가 true인 경우 componentRoutes 항목을 처리하려고 하는 데 문제가 발생했습니다. currentHostnames 필드는 적용되거나 적용되지 않을 수 있습니다. Progressing이 true인 경우 구성 요소가 componentRoutes 항목과 관련된 몇 가지 작업을 수행 중임을 의미합니다.
- 유형
-
array
16.1.18. .status.componentRoutes[].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)입니다. |
16.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/ingresses
-
DELETE
: Ingress의 컬렉션 삭제 -
GET
: 종류의 Ingress 오브젝트 나열 -
POST
: Ingress 생성
-
/apis/config.openshift.io/v1/ingresses/{name}
-
DELETE
: Ingress 삭제 -
GET
: 지정된 Ingress 읽기 -
PATCH
: 지정된 Ingress를 부분적으로 업데이트 -
PUT
: 지정된 Ingress를 교체
-
/apis/config.openshift.io/v1/ingresses/{name}/status
-
GET
: 지정된 Ingress의 읽기 상태 -
PATCH
: 지정된 Ingress의 부분 업데이트 상태 -
PUT
: 지정된 Ingress의 상태
-
16.2.1. /apis/config.openshift.io/v1/ingresses
- HTTP 방법
-
DELETE
- 설명
- Ingress 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- Ingress 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- Ingress 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
16.2.2. /apis/config.openshift.io/v1/ingresses/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| Ingress의 이름 |
- HTTP 방법
-
DELETE
- 설명
- Ingress 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 Ingress 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Ingress를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Ingress 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
16.2.3. /apis/config.openshift.io/v1/ingresses/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| Ingress의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 Ingress의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 Ingress의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 Ingress의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
17장. Network [config.openshift.io/v1]
- 설명
-
네트워크에는 네트워크에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
cluster
입니다. 서비스/Pod IP의 IP 주소 풀, 네트워크 플러그인 등 원하는 네트워크 구성을 구성하는 데 사용됩니다. 이 리소스를 구성할 때 적용되는 사항에 대한 설명은 network.spec을 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
17.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능한 값이 있습니다. 일반적으로 이 내용은 직접 읽지 않습니다. 대신 현재 배포된 구성을 나타내는 NetworkStatus를 사용해야 합니다. 현재 대부분의 spec 필드는 설치 후 변경할 수 없습니다. 각각에 대한 자세한 내용은 개별 항목을 참조하십시오. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
17.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능한 값이 있습니다. 일반적으로 이 내용은 직접 읽지 않습니다. 대신 현재 배포된 구성을 나타내는 NetworkStatus를 사용해야 합니다. 현재 대부분의 spec 필드는 설치 후 변경할 수 없습니다. 각각에 대한 자세한 내용은 개별 항목을 참조하십시오.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod IP에 사용할 IP 주소 풀입니다. 설치 후 이 필드는 변경할 수 없습니다. |
|
| ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다. |
|
| ExternalIP는 Service.ExternalIP에 영향을 주는 컨트롤러에 대한 구성을 정의합니다. nil인 경우 ExternalIP를 설정할 수 없습니다. |
|
| NetworkDiagnostics는 네트워크 진단 구성을 정의합니다. network.operator.openshift.io에서 spec.disableNetworkDiagnostics보다 우선합니다. networkDiagnostics를 지정하지 않거나 비어 있고 network.operator.openshift.io의 spec.disableNetworkDiagnostics 플래그가 true로 설정된 경우 네트워크 진단 기능이 비활성화됩니다. |
|
| networkType은 배포할 플러그인입니다(예: OVNKubernetes). 이는 cluster-network-operator가 이해할 수 있는 값과 일치해야 하며 그렇지 않으면 네트워킹이 설치되지 않습니다. 현재 지원되는 값은 - OVNKubernetes 이 필드는 설치 후 변경할 수 없습니다. |
|
| 서비스를 위한 IP 주소 풀입니다. 현재는 단일 항목만 지원합니다. 설치 후 이 필드는 변경할 수 없습니다. |
|
| NodePort 유형의 서비스에 허용되는 포트 범위입니다. 지정하지 않으면 기본값 30000-32767이 사용됩니다. NodePort를 지정하지 않은 이러한 서비스는 이 범위에서 자동으로 할당됩니다. 이 매개변수는 클러스터를 설치한 후 업데이트할 수 있습니다. |
17.1.2. .spec.clusterNetwork
- 설명
- Pod IP에 사용할 IP 주소 풀입니다. 설치 후 이 필드는 변경할 수 없습니다.
- 유형
-
array
17.1.3. .spec.clusterNetwork[]
- 설명
- ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod IP의 전체 블록입니다. |
|
| 각 노드에 할당할 블록의 크기(접두사)입니다. 이 필드를 플러그인에서 사용하지 않으면 설정되지 않은 상태로 둘 수 있습니다. |
17.1.4. .spec.externalIP
- 설명
- ExternalIP는 Service.ExternalIP에 영향을 주는 컨트롤러에 대한 구성을 정의합니다. nil인 경우 ExternalIP를 설정할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| autoAssignCIDRs는 Service.ExternalIP를 자동으로 할당할 CIDR 목록입니다. 서비스가 LoadBalancer 유형의 경우 할당됩니다. 일반적으로 이는 베어 메탈 클러스터에만 유용합니다. Openshift 3.x에서는 이를 "IngressIPs"라고 잘못 칭했습니다. 자동으로 할당된 외부 IP는 ExternalIPPolicy 규칙의 영향을 받지 않습니다. 현재는 하나의 항목만 제공될 수 있습니다. |
|
| policy는 ExternalIP 필드에 적용되는 제한 세트입니다. nil 또는 empty인 경우 ExternalIP를 설정할 수 없습니다. |
17.1.5. .spec.externalIP.policy
- 설명
- policy는 ExternalIP 필드에 적용되는 제한 세트입니다. nil 또는 empty인 경우 ExternalIP를 설정할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| allowedCIDRs는 허용된 CIDR 목록입니다. |
|
| rejectedCIDRs는 허용되지 않은 CIDR 목록입니다. 이는 allowedCIDR보다 우선합니다. |
17.1.6. .spec.networkDiagnostics
- 설명
- NetworkDiagnostics는 네트워크 진단 구성을 정의합니다. network.operator.openshift.io에서 spec.disableNetworkDiagnostics보다 우선합니다. networkDiagnostics를 지정하지 않거나 비어 있고 network.operator.openshift.io의 spec.disableNetworkDiagnostics 플래그가 true로 설정된 경우 네트워크 진단 기능이 비활성화됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 모드는 네트워크 진단 모드를 생략하면 사용자에게 의견이 없으며 플랫폼이 적절한 기본값을 선택할 수 있음을 의미합니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 all입니다. |
|
| sourcePlacement는 네트워크 진단 소스 배포의 스케줄링을 제어합니다. 자세한 내용은 NetworkDiagnosticsSourcePlacement를 참조하십시오. |
|
| targetPlacement는 네트워크 진단 대상 데몬 세트의 스케줄링을 제어합니다. See NetworkDiagnosticsTargetPlacement for more details about default values. |
17.1.7. .spec.networkDiagnostics.sourcePlacement
- 설명
- sourcePlacement는 네트워크 진단 소스 배포의 스케줄링을 제어합니다. 자세한 내용은 NetworkDiagnosticsSourcePlacement를 참조하십시오.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
nodeSelector는 네트워크 진단 구성 요소에 적용되는 노드 선택기입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 |
|
| 허용 오차는 네트워크 진단 구성 요소에 적용되는 허용 오차 목록입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 빈 목록입니다. |
|
| 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다. |
17.1.8. .spec.networkDiagnostics.sourcePlacement.tolerations
- 설명
- 허용 오차는 네트워크 진단 구성 요소에 적용되는 허용 오차 목록입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 빈 목록입니다.
- 유형
-
array
17.1.9. .spec.networkDiagnostics.sourcePlacement.tolerations[]
- 설명
- 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다. |
|
| 키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다. |
|
| Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다. |
|
| tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다. |
|
| 값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다. |
17.1.10. .spec.networkDiagnostics.targetPlacement
- 설명
- targetPlacement는 네트워크 진단 대상 데몬 세트의 스케줄링을 제어합니다. See NetworkDiagnosticsTargetPlacement for more details about default values.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
|
nodeSelector는 네트워크 진단 구성 요소에 적용되는 노드 선택기입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 |
|
|
허용 오차는 네트워크 진단 구성 요소에 적용되는 허용 오차 목록입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 |
|
| 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다. |
17.1.11. .spec.networkDiagnostics.targetPlacement.tolerations
- 설명
-
허용 오차는 네트워크 진단 구성 요소에 적용되는 허용 오차 목록입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은
operator: "Exists"
입니다. 즉, 모든 테인트가 허용됩니다. - 유형
-
array
17.1.12. .spec.networkDiagnostics.targetPlacement.tolerations[]
- 설명
- 이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다. |
|
| 키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다. |
|
| Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다. |
|
| tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다. |
|
| 값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다. |
17.1.13. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod IP에 사용할 IP 주소 풀입니다. |
|
| ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다. |
|
| ClusterNetworkMTU는 Pod 간 네트워킹을 위한 MTU입니다. |
|
| 조건은 network.config 현재 상태를 관찰하는 것을 나타냅니다. 알려진 .status.conditions.type은 "NetworkDiagnosticsAvailable"입니다. |
|
|
condition에는 이 API 리소스의 현재 상태에 대한 세부 정보가 포함됩니다. --- 이 구조는 필드 경로 .status.conditions에서 배열로 직접 사용하기 위한 것입니다. 예를 들어 FooStatus struct{ // foo의 현재 상태의 관찰을 나타냅니다. // knownn .status.conditions.type are: "Available", "Progressing", and "Degraded" // +patchStrategy=merge // +listType=map // +listKey=type // +listKey=type [] |
|
| 마이그레이션에는 클러스터 네트워크 마이그레이션 구성이 포함되어 있습니다. |
|
| networkType은 배포된 플러그인(예: OVNKubernetes)입니다. |
|
| 서비스를 위한 IP 주소 풀입니다. 현재는 단일 항목만 지원합니다. |
17.1.14. .status.clusterNetwork
- 설명
- Pod IP에 사용할 IP 주소 풀입니다.
- 유형
-
array
17.1.15. .status.clusterNetwork[]
- 설명
- ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| Pod IP의 전체 블록입니다. |
|
| 각 노드에 할당할 블록의 크기(접두사)입니다. 이 필드를 플러그인에서 사용하지 않으면 설정되지 않은 상태로 둘 수 있습니다. |
17.1.16. .status.conditions
- 설명
- 조건은 network.config 현재 상태를 관찰하는 것을 나타냅니다. 알려진 .status.conditions.type은 "NetworkDiagnosticsAvailable"입니다.
- 유형
-
array
17.1.17. .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)입니다. |
17.1.18. .status.migration
- 설명
- 마이그레이션에는 클러스터 네트워크 마이그레이션 구성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| MTU는 배포 중인 MTU 구성입니다. |
|
| networkType은 배포 중인 대상 플러그인입니다. DEPRECATED: 네트워크 유형 마이그레이션은 더 이상 지원되지 않으므로 이 마이그레이션은 항상 설정되지 않아야 합니다. |
17.1.19. .status.migration.mtu
- 설명
- MTU는 배포 중인 MTU 구성입니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 머신에는 머신의 uplink에 대한 MTU 마이그레이션 구성이 포함되어 있습니다. |
|
| 네트워크에는 기본 네트워크의 MTU 마이그레이션 구성이 포함되어 있습니다. |
17.1.20. .status.migration.mtu.machine
- 설명
- 머신에는 머신의 uplink에 대한 MTU 마이그레이션 구성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 에서 마이그레이션할 MTU입니다. |
|
| 마이그레이션할 MTU입니다. |
17.1.21. .status.migration.mtu.network
- 설명
- 네트워크에는 기본 네트워크의 MTU 마이그레이션 구성이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 에서 마이그레이션할 MTU입니다. |
|
| 마이그레이션할 MTU입니다. |
17.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/networks
-
DELETE
: Network 컬렉션 삭제 -
GET
: 종류의 객체 목록 네트워크 -
POST
: 네트워크를 생성
-
/apis/config.openshift.io/v1/networks/{name}
-
DELETE
: 네트워크 삭제 -
GET
: 지정된 네트워크 읽기 -
PATCH
: 지정된 네트워크를 부분적으로 업데이트 -
PUT
: 지정된 네트워크를 교체
-
17.2.1. /apis/config.openshift.io/v1/networks
- HTTP 방법
-
DELETE
- 설명
- 네트워크 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 네트워크 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 네트워크 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
17.2.2. /apis/config.openshift.io/v1/networks/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 네트워크 이름 |
- HTTP 방법
-
DELETE
- 설명
- 네트워크 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 네트워크 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 네트워크를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 네트워크를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
18장. Node [config.openshift.io/v1]
- 설명
- 노드에는 노드별 기능에 대한 클러스터 전체 정보가 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
18.1. 사양
속성 | 유형 | 설명 |
---|---|---|
|
| APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 관찰된 값이 포함되어 있습니다. |
18.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CgroupMode에서 노드의 cgroups 버전을 결정합니다. |
|
| WorkerLatencyProfile은 kubelet이 클러스터의 상태 및 해당 응답을 업데이트하는 속도를 저하시킵니다. |
18.1.2. .status
- 설명
- status에는 관찰된 값이 포함되어 있습니다.
- 유형
-
object
18.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/nodes
-
DELETE
: 노드 컬렉션 삭제 -
GET
: 종류 노드 목록 -
POST
: 노드 생성
-
/apis/config.openshift.io/v1/nodes/{name}
-
DELETE
: 노드 삭제 -
GET
: 지정된 노드 읽기 -
PATCH
: 지정된 노드를 부분적으로 업데이트 -
PUT
: 지정된 노드 교체
-
/apis/config.openshift.io/v1/nodes/{name}/status
-
GET
: 지정된 노드의 읽기 상태 -
PATCH
: 지정된 노드의 부분적으로 업데이트 -
PUT
: 지정된 노드의 상태
-
18.2.1. /apis/config.openshift.io/v1/nodes
- HTTP 방법
-
DELETE
- 설명
- 노드 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류 노드 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 노드 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
18.2.2. /apis/config.openshift.io/v1/nodes/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 노드 이름 |
- HTTP 방법
-
DELETE
- 설명
- 노드 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 노드 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 노드를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 노드 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
18.2.3. /apis/config.openshift.io/v1/nodes/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 노드 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 노드의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 노드의 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 노드의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
19장. OAuth [config.openshift.io/v1]
- 설명
-
OAuth에 대한 클러스터 전체 정보가 있습니다. 표준 이름은
cluster
입니다. 통합 OAuth 서버를 구성하는 데 사용됩니다. 이 구성은 최상위 인증 구성의 유형이 IntegratedOAuth로 설정된 경우에만 적용됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
19.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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
19.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| identityProviders는 사용자가 자신을 식별할 수 있는 정렬된 방법 목록입니다. 이 목록이 비어 있으면 사용자에 대한 ID가 프로비저닝되지 않습니다. |
|
| IdentityProvider는 인증 정보를 사용하여 인증할 수 있는 ID를 제공합니다. |
|
| 템플릿을 사용하면 로그인 페이지와 같은 페이지를 사용자 지정할 수 있습니다. |
|
| tokenConfig에는 권한 부여 및 액세스 토큰 옵션이 포함되어 있습니다. |
19.1.2. .spec.identityProviders
- 설명
- identityProviders는 사용자가 자신을 식별할 수 있는 정렬된 방법 목록입니다. 이 목록이 비어 있으면 사용자에 대한 ID가 프로비저닝되지 않습니다.
- 유형
-
array
19.1.3. .spec.identityProviders[]
- 설명
- IdentityProvider는 인증 정보를 사용하여 인증할 수 있는 ID를 제공합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| basicauth에는 BasicAuth IdP에 대한 구성 옵션이 포함되어 있습니다. |
|
| GitHub에서 GitHub 자격 증명을 사용하여 사용자 인증 가능 |
|
| GitLab에서 GitLab 인증 정보를 사용하여 사용자 인증 가능 |
|
| Google에서 Google 인증 정보를 사용하여 사용자 인증 가능 |
|
| htpasswd를 사용하면 HTPasswd 파일을 사용하여 사용자 인증을 통해 인증 정보를 검증할 수 있습니다. |
|
| Keystone에서 keystone 암호 자격 증명을 사용하여 사용자 인증 가능 |
|
| LDAP에서 LDAP 인증 정보를 사용하여 사용자 인증 가능 |
|
| mappingMethod는 이 공급자의 ID가 사용자에게 매핑되는 방식을 결정합니다. 기본값은 "claim"입니다. |
|
| name은 이 공급자가 반환하는 ID를 지정하는 데 사용됩니다. - 다른 ID 공급자가 반환한 ID를 고유하고 공유하지 않아야 합니다. - 유효한 경로 세그먼트여야 합니다. name cannot be a valid path segment: name cannot equal "." or ".." or contain "/" or "%" or ":" Ref: https://godoc.org/github.com/openshift/origin/pkg/user/apis/user/validation#ValidateIdentityProviderName |
|
| OpenID는 OpenID 인증 정보를 사용하여 사용자 인증 가능 |
|
| requestHeader를 사용하면 요청 헤더 자격 증명을 사용한 사용자 인증 가능 |
|
| type은 이 항목의 ID 공급자 유형을 식별합니다. |
19.1.4. .spec.identityProviders[].basicAuth
- 설명
- basicauth에는 BasicAuth IdP에 대한 구성 옵션이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| URL은 연결할 원격 URL입니다. |
19.1.5. .spec.identityProviders[].basicAuth.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.6. .spec.identityProviders[].basicAuth.tlsClientCert
- 설명
- tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.7. .spec.identityProviders[].basicAuth.tlsClientKey
- 설명
- tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.8. .spec.identityProviders[].github
- 설명
- GitHub에서 GitHub 자격 증명을 사용하여 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이는 hostname이 비어 있지 않은 값으로 설정된 경우에만 구성할 수 있습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| clientID는 oauth 클라이언트 ID입니다. |
|
| clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| hostname은 GitHub Enterprise의 호스팅 인스턴스와 함께 사용할 선택적 도메인(예: "mycompany.com")입니다. /setup/settings#hostname에 구성된 GitHub Enterprise 설정 값과 일치해야 합니다. |
|
| 조직에서 선택적으로 로그인할 수 있는 조직을 제한합니다. |
|
| 팀은 선택적으로 로그인할 수 있는 팀을 제한합니다. 형식은 <org>/<team>입니다. |
19.1.9. .spec.identityProviders[].github.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이는 hostname이 비어 있지 않은 값으로 설정된 경우에만 구성할 수 있습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.10. .spec.identityProviders[].github.clientSecret
- 설명
- clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.11. .spec.identityProviders[].gitlab
- 설명
- GitLab에서 GitLab 인증 정보를 사용하여 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| clientID는 oauth 클라이언트 ID입니다. |
|
| clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| URL은 oauth 서버 기본 URL입니다. |
19.1.12. .spec.identityProviders[].gitlab.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.13. .spec.identityProviders[].gitlab.clientSecret
- 설명
- clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.14. .spec.identityProviders[].google
- 설명
- Google에서 Google 인증 정보를 사용하여 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| clientID는 oauth 클라이언트 ID입니다. |
|
| clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| hostedDomain은 로그인을 제한하는 선택적 Google 앱 도메인(예: "mycompany.com")입니다. |
19.1.15. .spec.identityProviders[].google.clientSecret
- 설명
- clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.16. .spec.identityProviders[].htpasswd
- 설명
- htpasswd를 사용하면 HTPasswd 파일을 사용하여 사용자 인증을 통해 인증 정보를 검증할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| fileData는 htpasswd 파일로 사용할 데이터를 포함하는 이름별 시크릿에 대한 필수 참조입니다. "htpasswd" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 htpasswd 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
19.1.17. .spec.identityProviders[].htpasswd.fileData
- 설명
- fileData는 htpasswd 파일로 사용할 데이터를 포함하는 이름별 시크릿에 대한 필수 참조입니다. "htpasswd" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 htpasswd 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.18. .spec.identityProviders[].keystone
- 설명
- Keystone에서 keystone 암호 자격 증명을 사용하여 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| keystone v3에는 domainname이 필요합니다. |
|
| tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| URL은 연결할 원격 URL입니다. |
19.1.19. .spec.identityProviders[].keystone.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.20. .spec.identityProviders[].keystone.tlsClientCert
- 설명
- tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.21. .spec.identityProviders[].keystone.tlsClientKey
- 설명
- tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.22. .spec.identityProviders[].ldap
- 설명
- LDAP에서 LDAP 인증 정보를 사용하여 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 속성은 LDAP 속성을 ID에 매핑 |
|
| bindDN은 검색 단계에서 바인딩할 선택적 DN입니다. |
|
| bindPassword는 검색 단계에서 바인딩할 암호가 포함된 이름별 보안에 대한 선택적 참조입니다. "bindPassword" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
|
비보안( |
|
| URL은 사용할 LDAP 검색 매개변수를 지정하는 RFC 2255 URL입니다. URL 구문은 ldap://host:port/basedn?attribute?scope?filter입니다. |
19.1.23. .spec.identityProviders[].ldap.attributes
- 설명
- 속성은 LDAP 속성을 ID에 매핑
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| email은 값을 이메일 주소로 사용해야 하는 속성 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID에 대한 이메일이 설정되어 있지 않습니다. |
|
| ID는 값을 사용자 ID로 사용해야 하는 속성 목록입니다. 필수 항목입니다. 비어 있지 않은 첫 번째 속성이 사용됩니다. 하나 이상의 속성이 필요합니다. 나열된 어떤 속성에도 값이 없는 경우 인증이 실패합니다. LDAP 표준 ID 속성은 "dn"입니다. |
|
| name은 표시 이름으로 값을 사용해야 하는 속성 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID LDAP 표준 표시 이름 속성에 대해 표시 이름이 "cn"으로 설정되어 있지 않습니다. |
|
| PreferredUsername은 기본 사용자 이름으로 값을 사용해야 하는 속성 목록입니다. LDAP 표준 로그인 속성은 "uid"입니다. |
19.1.24. .spec.identityProviders[].ldap.bindPassword
- 설명
- bindPassword는 검색 단계에서 바인딩할 암호가 포함된 이름별 보안에 대한 선택적 참조입니다. "bindPassword" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.25. .spec.identityProviders[].ldap.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.26. .spec.identityProviders[].openID
- 설명
- OpenID는 OpenID 인증 정보를 사용하여 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| 클레임 매핑 |
|
| clientID는 oauth 클라이언트 ID입니다. |
|
| clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| extraAuthorizeParameters는 권한 부여 요청에 추가할 사용자 지정 매개변수입니다. |
|
| extraScopes는 표준 "openid" 범위 외에 요청할 모든 범위입니다. |
|
| issuer는 OpenID 공급자가 발급자 식별자로 어설션하는 URL입니다. 쿼리 또는 조각 구성 요소 없이 https 체계를 사용해야 합니다. |
19.1.27. .spec.identityProviders[].openID.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.28. .spec.identityProviders[].openID.claims
- 설명
- 클레임 매핑
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| email은 해당 값을 이메일 주소로 사용해야 하는 클레임 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID에 대한 이메일이 설정되어 있지 않습니다. |
|
| 그룹은 OIDC 공급자의 그룹을 사용자의 OpenShift와 동기화하는 데 사용해야 하는 클레임 값 목록입니다. 여러 클레임이 지정되는 경우 비어 있지 않은 값이 있는 첫 번째 클레임이 사용됩니다. |
|
| name은 표시 이름으로 값을 사용해야 하는 클레임 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID에 대한 표시 이름이 설정되어 있지 않습니다. |
|
| PreferredUsername은 기본 사용자 이름으로 값을 사용해야 하는 클레임 목록입니다. 지정되지 않은 경우 기본 사용자 이름은 하위 클레임의 값에서 결정됩니다. |
19.1.29. .spec.identityProviders[].openID.clientSecret
- 설명
- clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.30. .spec.identityProviders[].requestHeader
- 설명
- requestHeader를 사용하면 요청 헤더 자격 증명을 사용한 사용자 인증 가능
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별로 구성 맵에 대한 필수 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. 특히, 헤더 스푸핑을 방지하기 위해 들어오는 요청을 확인할 수 있습니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. |
|
| challengeURL은 WWW-Authenticate 챌린지가 여기에서 리디렉션될 것으로 예상되는 OAuth 클라이언트의 인증되지 않은 요청으로 인증되지 않은 요청을 리디렉션하는 URL입니다. ${url}은 현재 URL로 교체되고 https://www.example.com/sso-login?then=${url} ${query}가 챌린지가 true로 설정된 경우 현재 쿼리 문자열 https://www.example.com/auth-proxy/oauth/authorize?${query} 로 교체됩니다. |
|
| clientCommonNames는 일치하는 항목이 필요한 일반 이름의 선택적 목록입니다. 비어 있는 경우 clientCA 번들에 대해 검증된 모든 클라이언트 인증서가 권한 있는 것으로 간주됩니다. |
|
| emailHeaders는 이메일 주소를 확인할 헤더 세트입니다. |
|
| 헤더는 ID 정보를 확인할 헤더 세트입니다. |
|
| loginURL은 대화형 로그인이 예상되는 OAuth 클라이언트의 인증되지 않은 /승인 요청을 리디렉션하는 URL입니다. 여기서 ${url}은 현재 URL로 교체되고, 로그인이 true로 설정된 경우 쿼리 매개변수 https://www.example.com/sso-login?then=${url} ${ query} 에서 안전하도록 이스케이프됩니다. |
|
| nameHeaders는 표시 이름을 확인할 헤더 세트입니다. |
|
| preferredUsernameHeaders는 기본 사용자 이름을 확인할 헤더 세트입니다. |
19.1.31. .spec.identityProviders[].requestHeader.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별로 구성 맵에 대한 필수 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. 특히, 헤더 스푸핑을 방지하기 위해 들어오는 요청을 확인할 수 있습니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
19.1.32. .spec.templates
- 설명
- 템플릿을 사용하면 로그인 페이지와 같은 페이지를 사용자 지정할 수 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 오류는 인증 또는 권한 부여 흐름 중에 오류 페이지를 렌더링하는 데 사용할 go 템플릿을 지정하는 보안의 이름입니다. "errors.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 오류 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 오류 페이지가 사용됩니다. 지정하지 않으면 기본 오류 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| login은 로그인 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "login.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 로그인 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 로그인 페이지가 사용됩니다. 지정되지 않은 경우 기본 로그인 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
|
| providerSelection은 공급자 선택 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "providers.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정되고 시크릿 또는 예상 키가 없는 경우 기본 공급자 선택 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 공급자 선택 페이지가 사용됩니다. 지정되지 않은 경우 기본 공급자 선택 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다. |
19.1.33. .spec.templates.error
- 설명
- 오류는 인증 또는 권한 부여 흐름 중에 오류 페이지를 렌더링하는 데 사용할 go 템플릿을 지정하는 보안의 이름입니다. "errors.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 오류 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 오류 페이지가 사용됩니다. 지정하지 않으면 기본 오류 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.34. .spec.templates.login
- 설명
- login은 로그인 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "login.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 로그인 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 로그인 페이지가 사용됩니다. 지정되지 않은 경우 기본 로그인 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.35. .spec.templates.providerSelection
- 설명
- providerSelection은 공급자 선택 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "providers.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정되고 시크릿 또는 예상 키가 없는 경우 기본 공급자 선택 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 공급자 선택 페이지가 사용됩니다. 지정되지 않은 경우 기본 공급자 선택 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
19.1.36. .spec.tokenConfig
- 설명
- tokenConfig에는 권한 부여 및 액세스 토큰 옵션이 포함되어 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| accessTokenInactivityTimeout은 클라이언트에서 부여하는 토큰에 대한 토큰 비활성 타임아웃을 정의합니다. 값은 토큰의 연속 사용 간에 발생할 수 있는 최대 시간을 나타냅니다. 이 시간 창에서 사용되지 않으면 토큰이 유효하지 않습니다. 사용자는 토큰이 시간 초과되면 액세스 권한을 얻기 위해 새 토큰을 취득해야 합니다. "5m", "1.5h" 또는 "2h45m"과 같은 유효한 시간 문자열을 사용합니다. 기간 동안 허용되는 최소 값은 300s(5분)입니다. 시간 초과가 클라이언트별로 구성된 경우 해당 값이 우선합니다. 시간 초과 값을 지정하지 않고 클라이언트가 값을 재정의하지 않으면 수명이 될 때까지 토큰이 유효합니다. 경고: 이 값을 변경하여 기존 토큰의 시간 초과는 영향을 받지 않습니다(낮음) |
|
| accessTokenInactivityTimeoutSeconds - DEPRECATED: 이 필드를 설정해도 적용되지 않습니다. |
|
| accessTokenMaxAgeSeconds는 액세스 토큰의 최대 사용 기간을 정의합니다. |
19.1.37. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
19.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/oauths
-
DELETE
: OAuth의 컬렉션 삭제 -
GET
: 종류의 OAuth 오브젝트 나열 -
POST
: OAuth 생성
-
/apis/config.openshift.io/v1/oauths/{name}
-
DELETE
: OAuth 삭제 -
GET
: 지정된 OAuth 읽기 -
PATCH
: 지정된 OAuth를 부분적으로 업데이트 -
PUT
: 지정된 OAuth를 교체
-
/apis/config.openshift.io/v1/oauths/{name}/status
-
GET
: 지정된 OAuth의 읽기 상태 -
PATCH
: 지정된 OAuth의 부분 업데이트 상태 -
PUT
: 지정된 OAuth의 상태 교체
-
19.2.1. /apis/config.openshift.io/v1/oauths
- HTTP 방법
-
DELETE
- 설명
- OAuth 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- OAuth 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- OAuth 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
19.2.2. /apis/config.openshift.io/v1/oauths/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| OAuth 이름 |
- HTTP 방법
-
DELETE
- 설명
- OAuth 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 OAuth 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 OAuth를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 OAuth를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
19.2.3. /apis/config.openshift.io/v1/oauths/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| OAuth 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 OAuth의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 OAuth의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 OAuth의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
20장. OperatorHub [config.openshift.io/v1]
- 설명
- OperatorHub는 operatorhubs API의 스키마입니다. 클러스터의 OperatorHub의 기본 허브 소스의 상태를 enabled에서 disabled로 변경하고 그 반대의 경우도 마찬가지입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
20.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 | |
|
| OperatorHubSpec은 원하는 OperatorHub 상태를 정의합니다. |
|
| OperatorHubStatus는 OperatorHub의 관찰 상태를 정의합니다. 기본 허브 소스의 현재 상태는 항상 여기에 반영됩니다. |
20.1.1. .spec
- 설명
- OperatorHubSpec은 원하는 OperatorHub 상태를 정의합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| disableAllDefaultSources를 사용하면 기본 허브 소스를 모두 비활성화할 수 있습니다. true인 경우 소스의 특정 항목을 사용하여 기본 소스를 활성화할 수 있습니다. false인 경우 소스의 특정 항목을 사용하여 기본 소스를 비활성화하거나 활성화할 수 있습니다. |
|
| 소스는 기본 허브 소스 목록과 해당 구성입니다. 목록이 비어 있으면 disableAllDefaultSources가 true인 경우를 제외하고 클러스터에서 기본 허브 소스가 활성화되어 있음을 나타냅니다. disableAllDefaultSources가 true이고 소스가 비어 있지 않은 경우 소스에 있는 구성이 우선합니다. 기본 허브 소스 목록과 해당 현재 상태는 항상 status 블록에 반영됩니다. |
|
| HubSource는 허브 소스 및 해당 구성을 지정하는 데 사용됩니다. |
20.1.2. .spec.sources
- 설명
- 소스는 기본 허브 소스 목록과 해당 구성입니다. 목록이 비어 있으면 disableAllDefaultSources가 true인 경우를 제외하고 클러스터에서 기본 허브 소스가 활성화되어 있음을 나타냅니다. disableAllDefaultSources가 true이고 소스가 비어 있지 않은 경우 소스에 있는 구성이 우선합니다. 기본 허브 소스 목록과 해당 현재 상태는 항상 status 블록에 반영됩니다.
- 유형
-
array
20.1.3. .spec.sources[]
- 설명
- HubSource는 허브 소스 및 해당 구성을 지정하는 데 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 비활성화는 클러스터에서 기본 허브 소스를 비활성화하는 데 사용됩니다. |
|
| name은 기본 허브 소스 중 하나의 이름입니다. |
20.1.4. .status
- 설명
- OperatorHubStatus는 OperatorHub의 관찰 상태를 정의합니다. 기본 허브 소스의 현재 상태는 항상 여기에 반영됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 소스는 각 허브 소스에 대한 구성 적용 결과를 캡슐화합니다. |
|
| HubSourceStatus는 기본 소스에 구성을 적용하는 현재 상태를 반영하는 데 사용됩니다. |
20.1.5. .status.sources
- 설명
- 소스는 각 허브 소스에 대한 구성 적용 결과를 캡슐화합니다.
- 유형
-
array
20.1.6. .status.sources[]
- 설명
- HubSourceStatus는 기본 소스에 구성을 적용하는 현재 상태를 반영하는 데 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 비활성화는 클러스터에서 기본 허브 소스를 비활성화하는 데 사용됩니다. |
|
| 메시지에서 실패에 대한 자세한 정보를 제공합니다. |
|
| name은 기본 허브 소스 중 하나의 이름입니다. |
|
| 상태는 구성 적용의 성공 또는 실패를 나타냅니다. |
20.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/operatorhubs
-
DELETE
: OperatorHub의 컬렉션 삭제 -
GET
: 종류의 OperatorHub 개체 나열 -
POST
: OperatorHub 생성
-
/apis/config.openshift.io/v1/operatorhubs/{name}
-
DELETE
: OperatorHub 삭제 -
GET
: 지정된 OperatorHub 읽기 -
PATCH
: 지정된 OperatorHub를 부분적으로 업데이트 -
PUT
: 지정된 OperatorHub를 교체
-
/apis/config.openshift.io/v1/operatorhubs/{name}/status
-
GET
: 지정된 OperatorHub의 읽기 상태 -
PATCH
: 지정된 OperatorHub의 부분 업데이트 상태 -
PUT
: 지정된 OperatorHub의 상태 교체
-
20.2.1. /apis/config.openshift.io/v1/operatorhubs
- HTTP 방법
-
DELETE
- 설명
- OperatorHub 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류의 OperatorHub 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- OperatorHub 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
20.2.2. /apis/config.openshift.io/v1/operatorhubs/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| OperatorHub의 이름 |
- HTTP 방법
-
DELETE
- 설명
- OperatorHub 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 OperatorHub 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 OperatorHub를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 OperatorHub를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
20.2.3. /apis/config.openshift.io/v1/operatorhubs/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| OperatorHub의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 OperatorHub의 상태 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 OperatorHub의 부분 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 OperatorHub의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
21장. Project [config.openshift.io/v1]
- 설명
-
프로젝트에는 프로젝트에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
21.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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
21.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| projectRequestMessage는 projectrequest api 끝점을 통해 프로젝트를 요청할 수 없는 경우 사용자에게 제공되는 문자열입니다. |
|
| projectRequestTemplate은 projectrequest에 대한 응답으로 프로젝트를 생성하는 데 사용할 템플릿입니다. 'openshift-config' 네임스페이스에서 템플릿을 가리켜야 합니다. 이는 선택 사항입니다. 지정하지 않으면 기본 템플릿이 사용됩니다. |
21.1.2. .spec.projectRequestTemplate
- 설명
- projectRequestTemplate은 projectrequest에 대한 응답으로 프로젝트를 생성하는 데 사용할 템플릿입니다. 'openshift-config' 네임스페이스에서 템플릿을 가리켜야 합니다. 이는 선택 사항입니다. 지정하지 않으면 기본 템플릿이 사용됩니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 프로젝트 요청 템플릿의 metadata.name입니다. |
21.1.3. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
21.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/projects
-
DELETE
: 프로젝트의 컬렉션 삭제 -
GET
: 종류의 프로젝트 오브젝트 나열 -
POST
: 프로젝트를 생성
-
/apis/config.openshift.io/v1/projects/{name}
-
DELETE
: 프로젝트 삭제 -
GET
: 지정된 프로젝트 읽기 -
PATCH
: 지정된 프로젝트를 부분적으로 업데이트 -
PUT
: 지정된 프로젝트를 교체
-
/apis/config.openshift.io/v1/projects/{name}/status
-
GET
: 지정된 프로젝트의 읽기 상태 -
PATCH
: 지정된 프로젝트의 부분 업데이트 상태 -
PUT
: 지정된 프로젝트의 상태
-
21.2.1. /apis/config.openshift.io/v1/projects
- HTTP 방법
-
DELETE
- 설명
- 프로젝트의 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- kind Project의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 프로젝트 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
21.2.2. /apis/config.openshift.io/v1/projects/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 프로젝트 이름 |
- HTTP 방법
-
DELETE
- 설명
- 프로젝트 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 프로젝트 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 프로젝트를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 프로젝트를 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
21.2.3. /apis/config.openshift.io/v1/projects/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 프로젝트 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 프로젝트의 상태 보기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 프로젝트의 부분 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 프로젝트의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
22장. ProjectHelmChartRepository [helm.openshift.io/v1beta1]
- 설명
- ProjectHelmChartRepository는 프록시된 Helm 차트 리포지터리 호환성 수준 2에 대한 네임스페이스 전체 구성을 보유하고 있습니다. 최소 9개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
- 유형
-
object
- 필수 항목
-
spec
-
22.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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| 네임스페이스 내에서 리포지토리의 상태를 확인합니다. |
22.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 차트 리포지터리 연결에 필요한 구성 |
|
| 사람이 읽을 수 있는 선택적 리포지토리 설명인 UI에서 용도를 표시하는 데 사용할 수 있습니다. |
|
| true로 설정하면 네임스페이스에서 리포지토리 사용을 비활성화합니다. |
|
| 사람이 읽을 수 있는 선택적 리포지토리 이름, UI에서 용도를 표시하는 데 사용할 수 있습니다. |
22.1.2. .spec.connectionConfig
- 설명
- 차트 리포지터리 연결에 필요한 구성
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| basicAuthConfig는 서버에 연결할 때 존재하는 기본 인증 인증 정보가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "username" 키는 사용자 이름을 찾는 데 사용됩니다. "password" 키는 암호를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다. |
|
| CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다. |
|
| tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다. |
|
| 차트 리포지터리 URL |
22.1.3. .spec.connectionConfig.basicAuthConfig
- 설명
- basicAuthConfig는 서버에 연결할 때 존재하는 기본 인증 인증 정보가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "username" 키는 사용자 이름을 찾는 데 사용됩니다. "password" 키는 암호를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
22.1.4. .spec.connectionConfig.ca
- 설명
- CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
22.1.5. .spec.connectionConfig.tlsClientConfig
- 설명
- tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 보안의 metadata.name입니다. |
22.1.6. .status
- 설명
- 네임스페이스 내에서 리포지토리의 상태를 확인합니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| 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 [] |
22.1.7. .status.conditions
- 설명
- conditions는 조건 및 상태 목록입니다.
- 유형
-
array
22.1.8. .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)입니다. |
22.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/helm.openshift.io/v1beta1/projecthelmchartrepositories
-
GET
: ProjectHelmChartRepository 유형의 오브젝트 나열
-
/apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories
-
DELETE
: ProjectHelmChartRepository의 컬렉션 삭제 -
GET
: ProjectHelmChartRepository 유형의 오브젝트 나열 -
POST
: ProjectHelmChartRepository 생성
-
/apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories/{name}
-
DELETE
: delete a ProjectHelmChartRepository -
GET
: 지정된 ProjectHelmChartRepository 읽기 -
PATCH
: 지정된 ProjectHelmChartRepository를 부분적으로 업데이트 -
PUT
: 지정된 ProjectHelmChartRepository를 교체합니다.
-
/APIs/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories/{name}/status
-
GET
: 지정된 ProjectHelmChartRepository의 읽기 상태 -
PATCH
: 지정된 ProjectHelmChartRepository의 부분 업데이트 상태 -
PUT
: 지정된 ProjectHelmChartRepository의 상태
-
22.2.1. /apis/helm.openshift.io/v1beta1/projecthelmchartrepositories
- HTTP 방법
-
GET
- 설명
- ProjectHelmChartRepository 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
22.2.2. /apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories
- HTTP 방법
-
DELETE
- 설명
- ProjectHelmChartRepository 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- ProjectHelmChartRepository 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- ProjectHelmChartRepository 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
202 - 승인됨 | |
401 - 무단 | 빈 |
22.2.3. /apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| ProjectHelmChartRepository의 이름 |
- HTTP 방법
-
DELETE
- 설명
- delete a ProjectHelmChartRepository
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 ProjectHelmChartRepository 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ProjectHelmChartRepository를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ProjectHelmChartRepository를 교체합니다.
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
22.2.4. /apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| ProjectHelmChartRepository의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 ProjectHelmChartRepository의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 ProjectHelmChartRepository의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 ProjectHelmChartRepository의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK | |
201 - 생성됨 | |
401 - 무단 | 빈 |
23장. Proxy [config.openshift.io/v1]
- 설명
-
proxy에는 클러스터의 기본 프록시를 구성하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은
클러스터
호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
23.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 | |
|
| spec에는 프록시 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
23.1.1. .spec
- 설명
- spec에는 프록시 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| httpsProxy는 HTTPS 요청의 프록시 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 및/또는 IP 목록입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다. |
|
| readinessEndpoints는 프록시 준비 상태를 확인하는 데 사용되는 끝점 목록입니다. |
|
| trustedCA는 CA 인증서 번들이 포함된 ConfigMap에 대한 참조입니다. trustedCA 필드는 프록시 검증기에서만 사용해야 합니다. 검증자는 필수 키 "ca-bundle.crt"에서 인증서 번들을 읽고 시스템 기본 신뢰 번들과 병합한 후 "openshift-config-managed" 네임스페이스의 "trusted-ca-bundle"이라는 ConfigMap에 병합된 신뢰 번들을 작성합니다. 프록시 연결을 수행할 것으로 예상되는 클라이언트는 프록시에 대한 모든 HTTPS 요청에 trusted-ca-bundle을 사용해야 하며, 프록시 이외의 HTTPS 요청에도 trusted-ca-bundle을 사용할 수 있습니다. trustedCA에서 참조하는 ConfigMap의 네임스페이스는 "openshift-config"입니다. 다음은 ConfigMap (in yaml): apiVersion: v1 kind: ConfigMap metadata: name: user-ca-bundle namespace: openshift-config data: ca-bundle.crt: | -----BEGIN CERTIFICATE---- Custom CA 인증서 번들입니다. -----END CERTIFICATE------END CERTIFICATE------------ |
23.1.2. .spec.trustedCA
- 설명
- trustedCA는 CA 인증서 번들이 포함된 ConfigMap에 대한 참조입니다. trustedCA 필드는 프록시 검증기에서만 사용해야 합니다. 검증자는 필수 키 "ca-bundle.crt"에서 인증서 번들을 읽고 시스템 기본 신뢰 번들과 병합한 후 "openshift-config-managed" 네임스페이스의 "trusted-ca-bundle"이라는 ConfigMap에 병합된 신뢰 번들을 작성합니다. 프록시 연결을 수행할 것으로 예상되는 클라이언트는 프록시에 대한 모든 HTTPS 요청에 trusted-ca-bundle을 사용해야 하며, 프록시 이외의 HTTPS 요청에도 trusted-ca-bundle을 사용할 수 있습니다. trustedCA에서 참조하는 ConfigMap의 네임스페이스는 "openshift-config"입니다. 다음은 ConfigMap (in yaml): apiVersion: v1 kind: ConfigMap metadata: name: user-ca-bundle namespace: openshift-bundle.crt: ca-bundle.crt: \| -----BEGIN CERTIFICATE---- Custom CA 인증서 번들입니다. -----END CERTIFICATE-------END CERTIFICATE---------------------
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
23.1.3. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. |
|
| httpsProxy는 HTTPS 요청의 프록시 URL입니다. |
|
| noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 목록입니다. |
23.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/proxies
-
DELETE
: 프록시 컬렉션 삭제 -
GET
: 종류의 프록시 오브젝트 나열 -
POST
: 프록시 생성
-
/apis/config.openshift.io/v1/proxies/{name}
-
DELETE
: 프록시 삭제 -
GET
: 지정된 프록시 읽기 -
PATCH
: 지정된 프록시를 부분적으로 업데이트 -
PUT
: 지정된 프록시를 교체
-
/apis/config.openshift.io/v1/proxies/{name}/status
-
GET
: 지정된 프록시의 읽기 상태 -
PATCH
: 지정된 프록시의 부분 업데이트 상태 -
PUT
: 지정된 프록시의 상태
-
23.2.1. /apis/config.openshift.io/v1/proxies
- HTTP 방법
-
DELETE
- 설명
- 프록시 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 프록시 유형의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 프록시 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
23.2.2. /apis/config.openshift.io/v1/proxies/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 프록시의 이름 |
- HTTP 방법
-
DELETE
- 설명
- 프록시 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 프록시 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 프록시를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 프록시 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
23.2.3. /apis/config.openshift.io/v1/proxies/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 프록시의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 프록시의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 프록시의 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 프록시의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
24장. Scheduler [config.openshift.io/v1]
- 설명
-
스케줄러는 Kubernetes 스케줄러를 실행하고 배치 결정에 영향을 주기 위해 클러스터 전체 구성 정보를 보유합니다. 이 구성의 표준 이름은
cluster
입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다. - 유형
-
object
- 필수 항목
-
spec
-
24.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 | |
|
| spec에는 구성에 대한 사용자 설정 가능 값이 있습니다. |
|
| status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다. |
24.1.1. .spec
- 설명
- spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
- 유형
-
object
속성 | 유형 | 설명 |
---|---|---|
|
| defaultNodeSelector는 클러스터 수준 기본 노드 선택기를 설정하여 Pod 배치를 특정 노드로 제한하는 데 도움이 됩니다. 이는 모든 네임스페이스에서 생성된 Pod에 적용되며 Pod에 이미 설정된 기존 nodeSelector와의 교집합을 생성하여 Pod의 선택기가 추가로 제한됩니다. 예를 들어 defaultNodeSelector: "type=user-node,region=east"는 Pod 사양의 nodeSelector 필드를 모든 네임스페이스에서 생성된 모든 Pod로 "type=user-node,region=east"로 설정합니다. 이 필드가 설정되어 있어도 프로젝트 수준 노드 선택기가 있는 네임스페이스에는 영향을 미치지 않습니다. 그러면 주석 섹션이 네임스페이스에 추가됩니다. 예를 들어 node-selector='type=user-node,region=east'를 사용하여 새 네임스페이스가 생성되는 경우 주석 openshift.io/node-selector: type=user-node,region=east가 프로젝트에 추가됩니다. 프로젝트에 openshift.io/node-selector 주석이 설정된 경우 defaultNodeSelector 필드에 대해 설정하는 값에 우선하여 값이 사용됩니다. 예를 들어 openshift.io/node-selector: "type=user-node,region=west"는 defaultNodeSelector에 설정된 "type=user-node,region=east"의 기본값이 적용되지 않음을 의미합니다. |
|
| mastersSchedulable을 사용하면 마스터 노드를 예약할 수 있습니다. 이 플래그가 켜지면 클러스터의 모든 마스터 노드가 예약 가능 상태가 되어 워크로드 Pod를 실행할 수 있습니다. 이 필드의 기본값은 false입니다. 즉, 마스터 노드를 예약할 수 없습니다. 중요 사항: 워크로드 Pod가 마스터 노드에서 실행되기 시작하면 클러스터 크리티컬 컨트롤 플레인 구성 요소에 영향을 미치지 않도록 주의해야 합니다. 실사를 수행한 후 이 필드를 켭니다. |
|
| DEPRECATED: 스케줄러 정책 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 정책은 사용자가 지정한 서술자 및 우선순위가 있는 스케줄러 정책이 포함된 ConfigMap에 대한 참조입니다. 이 ConfigMap을 사용할 수 없는 경우 스케줄러는 기본적으로 DefaultAlgorithmProvider를 사용합니다. 이 configmap의 네임스페이스는 openshift-config입니다. |
|
| 프로필은 새 Pod에 대한 스케줄링 결정을 구성하기 위해 설정해야 하는 예약 프로필을 설정합니다. 유효한 값은 "LowNodeUtilization", "HighNodeUtilization", "NoScoring" 기본값을 "LowNodeUtilization"입니다. |
24.1.2. .spec.policy
- 설명
- DEPRECATED: 스케줄러 정책 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 정책은 사용자가 지정한 서술자 및 우선순위가 있는 스케줄러 정책이 포함된 ConfigMap에 대한 참조입니다. 이 ConfigMap을 사용할 수 없는 경우 스케줄러는 기본적으로 DefaultAlgorithmProvider를 사용합니다. 이 configmap의 네임스페이스는 openshift-config입니다.
- 유형
-
object
- 필수 항목
-
name
-
속성 | 유형 | 설명 |
---|---|---|
|
| name은 참조된 구성 맵의 metadata.name입니다. |
24.1.3. .status
- 설명
- status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
- 유형
-
object
24.2. API 끝점
다음 API 끝점을 사용할 수 있습니다.
/apis/config.openshift.io/v1/schedulers
-
DELETE
: 스케줄러 컬렉션 삭제 -
GET
: 종류 스케줄러의 오브젝트 나열 -
POST
: 스케줄러 생성
-
/apis/config.openshift.io/v1/schedulers/{name}
-
DELETE
: 스케줄러 삭제 -
GET
: 지정된 스케줄러 읽기 -
PATCH
: 지정된 스케줄러를 부분적으로 업데이트 -
PUT
: 지정된 스케줄러를 교체
-
/apis/config.openshift.io/v1/schedulers/{name}/status
-
GET
: 지정된 스케줄러의 읽기 상태 -
PATCH
: 지정된 스케줄러의 부분 업데이트 상태 -
PUT
: 지정된 스케줄러의 상태
-
24.2.1. /apis/config.openshift.io/v1/schedulers
- HTTP 방법
-
DELETE
- 설명
- 스케줄러 컬렉션 삭제
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 종류 스케줄러의 오브젝트 나열
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
POST
- 설명
- 스케줄러 생성
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
24.2.2. /apis/config.openshift.io/v1/schedulers/{name}
매개변수 | 유형 | 설명 |
---|---|---|
|
| 스케줄러의 이름 |
- HTTP 방법
-
DELETE
- 설명
- 스케줄러 삭제
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
202 - 승인됨 |
|
401 - 무단 | 빈 |
- HTTP 방법
-
GET
- 설명
- 지정된 스케줄러 읽기
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 스케줄러를 부분적으로 업데이트
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 스케줄러 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
201 - 생성됨 |
|
401 - 무단 | 빈 |
24.2.3. /apis/config.openshift.io/v1/schedulers/{name}/status
매개변수 | 유형 | 설명 |
---|---|---|
|
| 스케줄러의 이름 |
- HTTP 방법
-
GET
- 설명
- 지정된 스케줄러의 읽기 상태
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PATCH
- 설명
- 지정된 스케줄러의 부분적으로 업데이트 상태
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
HTTP 코드 | 리포지토리 본문 |
---|---|
200 - OK |
|
401 - 무단 | 빈 |
- HTTP 방법
-
PUT
- 설명
- 지정된 스케줄러의 상태 교체
매개변수 | 유형 | 설명 |
---|---|---|
|
| 존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다. |
|
| FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다. |
매개변수 | 유형 | 설명 |
---|---|---|
|
|
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.