구성 API


OpenShift Container Platform 4.17

구성 API에 대한 참조 가이드

Red Hat OpenShift Documentation Team

초록

이 문서에서는 OpenShift Container Platform 구성 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

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

2.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

additionalCORSAllowedOrigins

배열(문자열)

additionalCORSAllowedOrigins는 API 서버가 CORS 헤더를 사용하여 액세스할 수 있는 호스트를 설명하는 추가 사용자 정의 정규식을 나열합니다. JavaScript 애플리케이션에서 API 및 통합 OAuth 서버에 액세스하려면 이 작업이 필요할 수 있습니다. 값은 Golang 정규식 언어에 해당하는 정규식입니다.

audit

object

audit은 클러스터의 모든 OpenShift 제공 API 서버에 적용할 감사 구성에 대한 설정을 지정합니다.

clientCA

object

ClientCA는 Operator 관리 서명자 외에도 들어오는 클라이언트 인증서로 인식될 서명자의 인증서 번들이 포함된 ConfigMap을 참조합니다. 비어 있는 경우 운영자 관리 서명자만 유효합니다. 일반적으로 자체 PKI가 있는 경우에만 클라이언트 인증서를 준수해야 합니다. ConfigMap은 openshift-config 네임스페이스에 있어야 하며 - ConfigMap.Data["ca-bundle.crt"] - CA 번들의 필수 필드를 포함해야 합니다.

Encryption

object

암호화를 사용하면 데이터 저장소 계층에서 리소스의 암호화를 구성할 수 있습니다.

servingCerts

object

servingCert는 보안 트래픽을 제공하기 위한 TLS 인증서 정보입니다. 지정하지 않으면 Operator 관리 인증서가 보안 트래픽을 제공하는 데 사용됩니다.

tlsSecurityProfile

object

tlsSecurityProfile은 외부에 노출된 서버의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값(릴리스 간에 변경될 수 있음)이 선택됩니다. Old, Intermediate 및 Custom 프로파일만 지원되며 사용 가능한 최대 minTLSVersion은 VersionTLS12입니다.

2.1.2. .spec.audit

설명
audit은 클러스터의 모든 OpenShift 제공 API 서버에 적용할 감사 구성에 대한 설정을 지정합니다.
유형
object
속성유형설명

customRules

array

customRules는 그룹당 프로필을 지정합니다. 이러한 프로필이 적용되는 경우 최상위 프로필 필드보다 우선합니다. 이러한 평가는 위에서 아래로 평가되며 일치하는 첫 번째 항목이 적용됩니다.

customRules[]

object

AuditCustomRule은 최상위 프로필보다 우선하는 감사 프로필에 대한 사용자 정의 규칙을 설명합니다.

profile

string

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. 경고: 문제를 해결할 때 유용할 수 있는 데이터를 로깅하지 않는 한 None 프로필을 사용하여 감사 로깅을 비활성화하지 않는 것이 좋습니다. 감사 로깅을 비활성화하고 지원 상황이 발생하는 경우 적절하게 해결하려면 감사 로깅을 활성화하고 문제를 재현해야 할 수 있습니다. 설정되지 않은 경우 'Default' 프로필이 기본값으로 사용됩니다.

2.1.3. .spec.audit.customRules

설명
customRules는 그룹당 프로필을 지정합니다. 이러한 프로필이 적용되는 경우 최상위 프로필 필드보다 우선합니다. 이러한 평가는 위에서 아래로 평가되며 일치하는 첫 번째 항목이 적용됩니다.
유형
array

2.1.4. .spec.audit.customRules[]

설명
AuditCustomRule은 최상위 프로필보다 우선하는 감사 프로필에 대한 사용자 정의 규칙을 설명합니다.
유형
object
필수 항목
  • group
  • profile
속성유형설명

group

string

group은 이 프로필을 적용하려면 요청 사용자가 멤버여야 하는 그룹의 이름입니다.

profile

string

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

string

name은 참조된 구성 맵의 metadata.name입니다.

2.1.6. .spec.encryption

설명
암호화를 사용하면 데이터 저장소 계층에서 리소스의 암호화를 구성할 수 있습니다.
유형
object
속성유형설명

type

string

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

array

namedCertificates는 특정 호스트 이름에 보안 트래픽을 제공하기 위한 TLS 인증서 정보가 포함된 시크릿을 참조합니다. 이름이 지정된 인증서가 제공되지 않거나 이름이 지정된 인증서가 클라이언트에서 이해한 대로 서버 이름과 일치하지 않으면 defaultServingCertificate가 사용됩니다.

namedCertificates[]

object

APIServerNamedServingCert는 클라이언트에서 이해할 수 있는 서버 DNS 이름을 인증서에 매핑합니다.

2.1.8. .spec.servingCerts.namedCertificates

설명
namedCertificates는 특정 호스트 이름에 보안 트래픽을 제공하기 위한 TLS 인증서 정보가 포함된 시크릿을 참조합니다. 이름이 지정된 인증서가 제공되지 않거나 이름이 지정된 인증서가 클라이언트에서 이해한 대로 서버 이름과 일치하지 않으면 defaultServingCertificate가 사용됩니다.
유형
array

2.1.9. .spec.servingCerts.namedCertificates[]

설명
APIServerNamedServingCert는 클라이언트에서 이해할 수 있는 서버 DNS 이름을 인증서에 매핑합니다.
유형
object
속성유형설명

이름

배열(문자열)

이름은 이 인증서를 사용하여 보안 트래픽을 제공해야 하는 명시적 DNS 이름(허용 와일드카드)의 선택적 목록입니다. 이름을 제공하지 않으면 암시적 이름이 인증서에서 추출됩니다. 정확한 이름은 와일드카드 이름을 통해 추적됩니다. 여기에 정의된 명시적 이름은 추출된 암시적 이름보다 충돌합니다.

servingCertificate

object

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

string

name은 참조된 보안의 metadata.name입니다.

2.1.11. .spec.tlsSecurityProfile

설명
tlsSecurityProfile은 외부에 노출된 서버의 TLS 연결 설정을 지정합니다. 설정되지 않은 경우 기본값(릴리스 간에 변경될 수 있음)이 선택됩니다. Old, Intermediate 및 Custom 프로파일만 지원되며 사용 가능한 최대 minTLSVersion은 VersionTLS12입니다.
유형
object
속성유형설명

Custom

``

Custom은 사용자 정의 TLS 보안 프로필입니다. 잘못된 구성으로 사용자 지정 프로필을 사용하는 것은 치명적일 수 있습니다. 사용자 정의 프로파일의 예는 다음과 같습니다: - ECDHE-ECDSA-CHACHA20-POLY1305 - ECDHE-RSA-CHACHA20-POLY1305 - ECDHE-RSA-AES128-GCM-SHA256 - ECDHE-ECDSA-AES128-GCM-SHA256 minTLSVersion: VersionTLS11

intermediate

``

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

``

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

``

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

string

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의 컬렉션 삭제
표 2.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 APIServer의 오브젝트 나열
표 2.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

APIServerList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

apiserver 스키마

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

200 - OK

apiserver 스키마

201 - 생성됨

apiserver 스키마

202 - 승인됨

apiserver 스키마

401 - 무단

2.2.2. /apis/config.openshift.io/v1/apiservers/{name}

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

name

string

APIServer의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

apiserver 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

apiserver 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

apiserver 스키마

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

200 - OK

apiserver 스키마

201 - 생성됨

apiserver 스키마

401 - 무단

2.2.3. /apis/config.openshift.io/v1/apiservers/{name}/status

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

name

string

APIServer의 이름

HTTP 방법
GET
설명
지정된 APIServer의 읽기 상태
표 2.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

apiserver 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 APIServer의 부분적으로 업데이트 상태
표 2.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

apiserver 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 APIServer의 상태 교체
표 2.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

apiserver 스키마

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

200 - OK

apiserver 스키마

201 - 생성됨

apiserver 스키마

401 - 무단

3장. 인증 [config.openshift.io/v1]

설명
인증은 인증을 위한 클러스터 전체 설정(예: OAuth 및 Webhook 토큰 인증기)을 지정합니다. 인스턴스의 표준 이름은 cluster 입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

3.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

3.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

oauthMetadata

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

string

serviceAccountIssuer는 바인딩된 서비스 계정 토큰 발행자의 식별자입니다. 기본값은 https://kubernetes.default.svc WARNING: 이 필드 업데이트로 인해 이전 발행자 값으로 바인딩된 모든 토큰이 즉시 무효화되지 않습니다. 대신 이전 서비스 계정 발행자가 발행한 토큰은 플랫폼에서 선택한 기간(현재 24h로 설정) 동안 계속 신뢰할 수 있습니다. 이 기간은 시간에 따라 변경될 수 있습니다. 이를 통해 내부 구성 요소가 서비스 중단 없이 새 서비스 계정 발행자를 사용할 수 있습니다.

type

string

type은 사용 중인 클러스터의 사용자 관리 인증 모드를 식별합니다. 특히 로그인 시도에 응답하는 구성 요소를 관리합니다. 기본값은 IntegratedOAuth입니다.

webhookTokenAuthenticator

object

webhookTokenAuthenticator는 원격 토큰 검토자를 구성합니다. 이러한 원격 인증 Webhook는 tokenreviews.authentication.k8s.io REST API를 통해 전달자 토큰을 확인하는 데 사용할 수 있습니다. 이는 외부 인증 서비스에서 프로비저닝한 전달자 토큰을 준수하는 데 필요합니다. "Type"이 "None"으로 설정된 경우에만 설정할 수 있습니다.

webhookTokenAuthenticators

array

webhookTokenAuthenticators는 DEPRECATED이며 설정해도 적용되지 않습니다.

webhookTokenAuthenticators[]

object

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

string

name은 참조된 구성 맵의 metadata.name입니다.

3.1.3. .spec.webhookTokenAuthenticator

설명
webhookTokenAuthenticator는 원격 토큰 검토자를 구성합니다. 이러한 원격 인증 Webhook는 tokenreviews.authentication.k8s.io REST API를 통해 전달자 토큰을 확인하는 데 사용할 수 있습니다. 이는 외부 인증 서비스에서 프로비저닝한 전달자 토큰을 준수하는 데 필요합니다. "Type"이 "None"으로 설정된 경우에만 설정할 수 있습니다.
유형
object
필수 항목
  • kubeConfig
속성유형설명

kubeConfig

object

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

string

name은 참조된 보안의 metadata.name입니다.

3.1.5. .spec.webhookTokenAuthenticators

설명
webhookTokenAuthenticators는 DEPRECATED이며 설정해도 적용되지 않습니다.
유형
array

3.1.6. .spec.webhookTokenAuthenticators[]

설명
deprecatedWebhookTokenAuthenticator에는 원격 토큰 인증기에 필요한 구성 옵션이 있습니다. 이는 WebhookTokenAuthenticator와 동일하지만 KubeConfig 필드에 대한 '필수' 검증이 누락되어 있습니다.
유형
object
속성유형설명

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

string

name은 참조된 보안의 metadata.name입니다.

3.1.8. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

integratedOAuthMetadata

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

string

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
설명
인증 컬렉션 삭제
표 3.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
인증 유형 오브젝트 나열
표 3.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

AuthenticationList 스키마

401 - 무단

HTTP 방법
POST
설명
인증 생성
표 3.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

인증 스키마

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

200 - OK

인증 스키마

201 - 생성됨

인증 스키마

202 - 승인됨

인증 스키마

401 - 무단

3.2.2. /apis/config.openshift.io/v1/authentications/{name}

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

name

string

인증의 이름

HTTP 방법
DELETE
설명
인증 삭제
표 3.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

인증 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

인증 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 인증 교체
표 3.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

인증 스키마

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

200 - OK

인증 스키마

201 - 생성됨

인증 스키마

401 - 무단

3.2.3. /apis/config.openshift.io/v1/authentications/{name}/status

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

name

string

인증의 이름

HTTP 방법
GET
설명
지정된 인증의 읽기 상태
표 3.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

인증 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

인증 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 인증의 상태 교체
표 3.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

인증 스키마

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

200 - OK

인증 스키마

201 - 생성됨

인증 스키마

401 - 무단

4장. 빌드 [config.openshift.io/v1]

설명
build는 전체 클러스터에 대한 OpenShift 빌드 동작을 구성합니다. 여기에는 BuildConfig 오브젝트에서 재정의할 수 있는 기본 설정이 포함되며 모든 빌드에 적용되는 덮어쓰기가 포함됩니다. 표준 이름은 "클러스터" 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴) 용 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

4.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 빌드 컨트롤러 구성에 대한 사용자 설정 가능 값이 있습니다.

4.1.1. .spec

설명
spec에는 빌드 컨트롤러 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

additionalTrustedCA

object

additionalTrustedCA는 빌드 중에 이미지 푸시 및 가져오기에 대해 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. DEPRECATED: 이미지 가져오기 및 푸시를 위한 추가 CA는 대신 image.config.openshift.io/cluster에 설정해야 합니다.

buildDefaults

object

BuildDefaults는 빌드의 기본 정보를 제어합니다.

buildOverrides

object

BuildOverrides는 빌드에 대한 덮어쓰기 설정 제어

4.1.2. .spec.additionalTrustedCA

설명
additionalTrustedCA는 빌드 중에 이미지 푸시 및 가져오기에 대해 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. DEPRECATED: 이미지 가져오기 및 푸시를 위한 추가 CA는 대신 image.config.openshift.io/cluster에 설정해야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

4.1.3. .spec.buildDefaults

설명
BuildDefaults는 빌드의 기본 정보를 제어합니다.
유형
object
속성유형설명

defaultProxy

object

DefaultProxy에는 이미지 풀/push 및 소스 다운로드를 포함하여 모든 빌드 작업에 대한 기본 프록시 설정이 포함되어 있습니다. 빌드 구성의 전략에 HTTP_PROXY,HTTPS_PROXYNO_PROXY 환경 변수를 설정하여 값을 덮어쓸 수 있습니다.

env

array

env는 지정된 변수가 빌드에 없는 경우 빌드에 적용되는 기본 환경 변수 세트입니다.

env[]

object

EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.

gitProxy

object

GitProxy에는 git 작업에 대한 프록시 설정만 포함되어 있습니다. 설정하면 git clone과 같은 모든 git 명령의 모든 프록시 설정을 덮어씁니다. 여기에 설정되지 않은 값은 DefaultProxy에서 상속됩니다.

imageLabels

array

imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자는 Build/BuildConfig에 동일한 이름으로 라벨을 제공하여 기본 레이블을 덮어쓸 수 있습니다.

imageLabels[]

object

 

resources

object

resources는 빌드를 실행하기 위한 리소스 요구 사항을 정의합니다.

4.1.4. .spec.buildDefaults.defaultProxy

설명
DefaultProxy에는 이미지 풀/push 및 소스 다운로드를 포함하여 모든 빌드 작업에 대한 기본 프록시 설정이 포함되어 있습니다. 빌드 구성의 전략에 HTTP_PROXY,HTTPS_PROXYNO_PROXY 환경 변수를 설정하여 값을 덮어쓸 수 있습니다.
유형
object
속성유형설명

httpProxy

string

httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

httpsProxy

string

httpsProxy는 HTTPS 요청의 프록시 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

noProxy

string

noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 및/또는 IP 목록입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

readinessEndpoints

배열(문자열)

readinessEndpoints는 프록시 준비 상태를 확인하는 데 사용되는 끝점 목록입니다.

trustedCA

object

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

string

name은 참조된 구성 맵의 metadata.name입니다.

4.1.6. .spec.buildDefaults.env

설명
env는 지정된 변수가 빌드에 없는 경우 빌드에 적용되는 기본 환경 변수 세트입니다.
유형
array

4.1.7. .spec.buildDefaults.env[]

설명
EnvVar는 컨테이너에 있는 환경 변수를 나타냅니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

환경 변수의 이름입니다. C_IDENTIFIER여야 합니다.

value

string

변수 참조 $(VAR_NAME)는 컨테이너에서 이전에 정의한 환경 변수와 서비스 환경 변수를 사용하여 확장됩니다. 변수를 확인할 수 없는 경우 입력 문자열의 참조는 변경되지 않습니다. double은 $(VAR_NAME) 구문을 이스케이프할 수 있는 단일 $로 감소합니다. 즉, "(VAR_NAME)"은 문자열 리터럴 "$(VAR_NAME)"을 생성합니다. 이스케이프된 참조는 변수가 존재하는지 여부에 관계없이 확장되지 않습니다. 기본값은 ""입니다.

valueFrom

object

환경 변수의 값의 소스입니다. 값이 비어 있지 않은 경우 사용할 수 없습니다.

4.1.8. .spec.buildDefaults.env[].valueFrom

설명
환경 변수의 값의 소스입니다. 값이 비어 있지 않은 경우 사용할 수 없습니다.
유형
object
속성유형설명

configMapKeyRef

object

ConfigMap의 키를 선택합니다.

fieldRef

object

Pod의 필드를 선택합니다. 은 metadata.name, metadata.namespace, metadata.labels['<KEY>'], metadata.annotations['<KEY>'], spec.nodeName, spec.serviceAccountName, status.hostIP, status.podIP, status.podIPs를 선택합니다.

resourceFieldRef

object

컨테이너의 리소스 선택: 리소스 제한 및 요청(limits.cpu, limits.memory, limits.ephemeral-storage, requests.cpu, requests.memory, requests.ephemeral-storage)만 현재 지원됩니다.

secretKeyRef

object

Pod의 네임스페이스에서 시크릿 키 선택

4.1.9. .spec.buildDefaults.env[].valueFrom.configMapKeyRef

설명
ConfigMap의 키를 선택합니다.
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 키입니다.

name

string

추천자의 이름입니다. 이 필드는 효과적으로 필요하지만 이전 버전과의 호환성으로 인해 비어 있을 수 있습니다. 여기에 빈 값이 있는 이 유형의 인스턴스는 거의 잘못된 것입니다. 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 kubebuilder:default 입니다.

optional

boolean

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
속성유형설명

apiVersion

string

FieldPath가 작성된 스키마의 버전은 기본값은 "v1"입니다.

fieldPath

string

지정된 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
속성유형설명

containerName

string

컨테이너 이름: 볼륨에 필요합니다. env vars의 경우 선택 사항

divisor

integer-or-string

노출된 리소스의 출력 형식을 지정합니다. 기본값은 "1"입니다.

resource

string

필수: 선택할 리소스

4.1.12. .spec.buildDefaults.env[].valueFrom.secretKeyRef

설명
Pod의 네임스페이스에서 시크릿 키 선택
유형
object
필수 항목
  • key
속성유형설명

key

string

선택할 시크릿의 키입니다. 유효한 시크릿 키여야 합니다.

name

string

추천자의 이름입니다. 이 필드는 효과적으로 필요하지만 이전 버전과의 호환성으로 인해 비어 있을 수 있습니다. 여기에 빈 값이 있는 이 유형의 인스턴스는 거의 잘못된 것입니다. 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 kubebuilder:default 입니다.

optional

boolean

시크릿 또는 해당 키를 정의해야 하는지 여부를 지정합니다.

4.1.13. .spec.buildDefaults.gitProxy

설명
GitProxy에는 git 작업에 대한 프록시 설정만 포함되어 있습니다. 설정하면 git clone과 같은 모든 git 명령의 모든 프록시 설정을 덮어씁니다. 여기에 설정되지 않은 값은 DefaultProxy에서 상속됩니다.
유형
object
속성유형설명

httpProxy

string

httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

httpsProxy

string

httpsProxy는 HTTPS 요청의 프록시 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

noProxy

string

noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 및/또는 IP 목록입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

readinessEndpoints

배열(문자열)

readinessEndpoints는 프록시 준비 상태를 확인하는 데 사용되는 끝점 목록입니다.

trustedCA

object

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

string

name은 참조된 구성 맵의 metadata.name입니다.

4.1.15. .spec.buildDefaults.imageLabels

설명
imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자는 Build/BuildConfig에 동일한 이름으로 라벨을 제공하여 기본 레이블을 덮어쓸 수 있습니다.
유형
array

4.1.16. .spec.buildDefaults.imageLabels[]

설명
유형
object
속성유형설명

name

string

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

value

string

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

4.1.17. .spec.buildDefaults.resources

설명
resources는 빌드를 실행하기 위한 리소스 요구 사항을 정의합니다.
유형
object
속성유형설명

클레임

array

클레임은 이 컨테이너에서 사용하는 spec.resourceClaims에 정의된 리소스의 이름을 나열합니다. 이 필드는 alpha 필드이며 DynamicResourceAllocation 기능 게이트를 활성화해야 합니다. 이 필드는 변경할 수 없습니다. 컨테이너에 대해서만 설정할 수 있습니다.

claims[]

object

ResourceClaim은 PodSpec.ResourceClaims에서 하나의 항목을 참조합니다.

limits

integer-or-string

제한은 허용되는 최대 컴퓨팅 리소스 양을 나타냅니다. 자세한 내용은 https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

requests

integer-or-string

요청은 필요한 최소 컴퓨팅 리소스 양을 설명합니다. 컨테이너에 대한 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

string

name은 이 필드가 사용되는 Pod의 pod.spec.resourceClaims에서 하나의 항목 이름과 일치해야 합니다. 컨테이너 내에서 해당 리소스를 사용할 수 있도록 합니다.

4.1.20. .spec.buildOverrides

설명
BuildOverrides는 빌드에 대한 덮어쓰기 설정 제어
유형
object
속성유형설명

forcePull

boolean

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

array

imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자가 이 목록에 있는 것과 동일한 이름으로 Build/BuildConfig에 레이블을 제공한 경우 사용자의 레이블을 덮어씁니다.

imageLabels[]

object

 

nodeSelector

오브젝트(문자열)

nodeSelector는 빌드 Pod가 노드에 적합하도록 true여야 하는 선택기입니다.

허용 오차

array

허용 오차는 빌드 Pod에 설정된 기존 허용 오차를 재정의하는 허용 목록입니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.

4.1.21. .spec.buildOverrides.imageLabels

설명
imageLabels는 결과 이미지에 적용되는 Docker 레이블 목록입니다. 사용자가 이 목록에 있는 것과 동일한 이름으로 Build/BuildConfig에 레이블을 제공한 경우 사용자의 레이블을 덮어씁니다.
유형
array

4.1.22. .spec.buildOverrides.imageLabels[]

설명
유형
object
속성유형설명

name

string

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

value

string

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

4.1.23. .spec.buildOverrides.tolerations

설명
허용 오차는 빌드 Pod에 설정된 기존 허용 오차를 재정의하는 허용 목록입니다.
유형
array

4.1.24. .spec.buildOverrides.tolerations[]

설명
이 허용 오차는 일치하는 연산자 <operator>를 사용하여 트리플 <key,value,effect>와 일치하는 테인트를 허용하도록 연결됩니다.
유형
object
속성유형설명

effect

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 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
설명
빌드 컬렉션 삭제
표 4.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
빌드 유형의 오브젝트 나열
표 4.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

BuildList 스키마

401 - 무단

HTTP 방법
POST
설명
빌드 생성
표 4.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

빌드 스키마

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

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

202 - 승인됨

빌드 스키마

401 - 무단

4.2.2. /apis/config.openshift.io/v1/builds/{name}

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

name

string

빌드의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

빌드 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

빌드 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 빌드로 교체
표 4.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

빌드 스키마

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

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

401 - 무단

4.2.3. /apis/config.openshift.io/v1/builds/{name}/status

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

name

string

빌드의 이름

HTTP 방법
GET
설명
지정된 빌드의 상태 확인
표 4.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

빌드 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 빌드의 부분적으로 업데이트 상태
표 4.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

빌드 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 빌드의 상태 교체
표 4.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

빌드 스키마

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

200 - OK

빌드 스키마

201 - 생성됨

빌드 스키마

401 - 무단

5장. ClusterOperator [config.openshift.io/v1]

설명
ClusterOperator는 Operator의 현재 상태를 가지고 있는 Custom Resource 오브젝트입니다. Operator는 이 오브젝트를 사용하여 클러스터의 나머지 부분에 상태를 전달합니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

5.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 모든 Operator에 적용할 수 있는 구성이 있습니다.

status

object

상태에는 Operator 상태에 대한 정보가 포함되어 있습니다. Kubernetes 에코시스템의 상태 정보와 일치합니다.

5.1.1. .spec

설명
spec에는 모든 Operator에 적용할 수 있는 구성이 있습니다.
유형
object

5.1.2. .status

설명
상태에는 Operator 상태에 대한 정보가 포함되어 있습니다. Kubernetes 에코시스템의 상태 정보와 일치합니다.
유형
object
속성유형설명

conditions

array

조건은 Operator의 관리 및 모니터링된 구성 요소의 상태를 설명합니다.

conditions[]

object

ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다.

확장

``

확장에는 이 status 오브젝트를 소유한 Operator와 관련된 추가 상태 정보가 포함되어 있습니다.

relatedObjects

array

relatedObjects는 이 연산자와 관련된 개체 목록입니다. 일반적인 용도는 1입니다. operator 2. operator 네임스페이스 3. 피연산자 네임스페이스를 구동하는 자세한 리소스

relatedObjects[]

object

ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.

버전

array

버전은 operator 및 피연산자 버전 튜플의 슬라이스입니다. 여러 피연산자를 관리하는 연산자는 배열에 여러 피연산자 항목이 있습니다.Operators which manage multiple operands will have multiple operand entries in the array. 사용 가능한 Operator는 "operator"라는 이름으로 Operator 자체의 버전을 보고해야 합니다. Operator는 새 버전을 모든 피연산자에 롤아웃하면 새 "operator" 버전을 보고합니다.

versions[]

object

 

5.1.3. .status.conditions

설명
조건은 Operator의 관리 및 모니터링된 구성 요소의 상태를 설명합니다.
유형
array

5.1.4. .status.conditions[]

설명
ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다.
유형
object
필수 항목
  • lastTransitionTime
  • status
  • type
속성유형설명

lastTransitionTime

string

lastTransitionTime은 현재 상태 속성에 대한 마지막 업데이트 시간입니다.

message

string

message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다.

reason

string

이유는 조건의 현재 상태에 대한 CamelCase 이유입니다.

status

string

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

type

string

type은 이 조건에서 보고한 측면을 지정합니다.

5.1.5. .status.relatedObjects

설명
relatedObjects는 이 연산자와 관련된 개체 목록입니다. 일반적인 용도는 1입니다. operator 2. operator 네임스페이스 3. 피연산자 네임스페이스를 구동하는 자세한 리소스
유형
array

5.1.6. .status.relatedObjects[]

설명
ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • group
  • name
  • resource
속성유형설명

group

string

추천자 그룹입니다.

name

string

추천자의 이름입니다.

네임스페이스

string

참조의 네임스페이스입니다.

resource

string

참조 항목의 리소스입니다.

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

string

name은 이 버전이 있는 특정 피연산자의 이름입니다. 일반적으로 Operator가 아닌 컨테이너 이미지와 일치합니다.

version

string

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의 컬렉션 삭제
표 5.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ClusterOperator 유형의 오브젝트 나열
표 5.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterOperatorList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ClusterOperator 스키마

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

200 - OK

ClusterOperator 스키마

201 - 생성됨

ClusterOperator 스키마

202 - 승인됨

ClusterOperator 스키마

401 - 무단

5.2.2. /apis/config.openshift.io/v1/clusteroperators/{name}

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

name

string

ClusterOperator의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

ClusterOperator 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ClusterOperator 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ClusterOperator 스키마

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

200 - OK

ClusterOperator 스키마

201 - 생성됨

ClusterOperator 스키마

401 - 무단

5.2.3. /apis/config.openshift.io/v1/clusteroperators/{name}/status

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

name

string

ClusterOperator의 이름

HTTP 방법
GET
설명
지정된 ClusterOperator의 읽기 상태
표 5.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterOperator 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ClusterOperator의 부분적으로 업데이트 상태
표 5.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ClusterOperator 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterOperator의 상태 교체
표 5.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ClusterOperator 스키마

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

200 - OK

ClusterOperator 스키마

201 - 생성됨

ClusterOperator 스키마

401 - 무단

6장. ClusterVersion [config.openshift.io/v1]

설명
ClusterVersion은 ClusterVersionOperator의 구성입니다. 여기에서 자동 업데이트와 관련된 매개변수를 설정할 수 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

6.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec은 클러스터 버전의 원하는 상태입니다. Operator는 원하는 버전이 클러스터에 적용되도록 작동합니다.

status

object

상태에는 사용 가능한 업데이트 및 진행 중인 업데이트에 대한 정보가 포함되어 있습니다.

6.1.1. .spec

설명
spec은 클러스터 버전의 원하는 상태입니다. Operator는 원하는 버전이 클러스터에 적용되도록 작동합니다.
유형
object
필수 항목
  • clusterID
속성유형설명

capabilities

object

기능은 선택적 핵심 클러스터 구성 요소의 설치를 구성합니다. 여기에 null 값은 빈 개체와 동일합니다. 기본 의미 체계에 대한 하위 속성을 참조하십시오.

channel

string

채널은 기본이 아닌 업데이트 세트가 이 클러스터에 적용되도록 명시적으로 요청하는 식별자입니다. 기본 채널에는 프로덕션 클러스터에 적합한 안정적인 업데이트가 포함됩니다.

clusterID

string

ClusterID는 이 클러스터를 고유하게 식별합니다. 이는 RFC4122 UUID 값(16진수 값의 xxxx xxxx-xxxx-xxxxxxxx)이어야 합니다. 이 필드는 필수 항목입니다.

desiredUpdate

object

desiredUpdate는 클러스터 버전의 원하는 값을 나타내는 선택적 필드입니다. 이 값을 설정하면 업그레이드가 트리거됩니다(현재 버전이 원하는 버전과 일치하지 않는 경우). 권장 업데이트 값 세트는 상태에 사용 가능한 업데이트의 일부로 나열되며 해당 범위를 벗어나는 값을 설정하면 업그레이드가 실패할 수 있습니다. 필드 중 일부는 여기에 설명된 제한 및 의미와 관련이 있습니다. 1. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정됩니다. API 검증 오류. 2. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 이 작업을 수행하지 않아야 합니다. 버전은 자동으로 무시되고 이미지가 사용됩니다. 3. 이미지가 지정되고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 4. 이미지가 지정되고 버전이 지정되지 않으며, 아키텍처가 지정되지 않았습니다. 이미지가 사용됩니다. 5. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정됩니다. 버전 및 원하는 아키텍처는 이미지를 선택하는 데 사용됩니다. 6. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 버전 및 현재 아키텍처는 이미지를 선택하는 데 사용됩니다. 7. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 8. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정되지 않습니다. API 검증 오류. 업그레이드에 실패하면 Operator가 중지되고 실패한 구성 요소에 대한 상태를 보고합니다. 원하는 업데이트 값을 이전 버전으로 다시 설정하면 롤백이 수행됩니다. 모든 롤백이 성공하는 것은 아닙니다.

덮어쓰기

array

덮어쓰기는 클러스터 버전 Operator에서 관리하는 구성 요소에 대한 덮어쓰기 목록입니다. 구성 요소를 비관리적으로 표시하면 Operator가 개체를 만들거나 업데이트할 수 없습니다.

overrides[]

object

ComponentOverride를 사용하면 구성 요소에 대한 클러스터 버전 Operator의 동작을 덮어쓸 수 있습니다.

upstream

string

업스트림을 사용하여 기본 업데이트 서버를 지정할 수 있습니다. 기본적으로 클러스터 및 지역에 적절한 업데이트 서버를 사용합니다.

6.1.2. .spec.capabilities

설명
기능은 선택적 핵심 클러스터 구성 요소의 설치를 구성합니다. 여기에 null 값은 빈 개체와 동일합니다. 기본 의미 체계에 대한 하위 속성을 참조하십시오.
유형
object
속성유형설명

additionalEnabledCapabilities

배열(문자열)

additionalEnabledCapabilities는 baselineCapabilitySet에 정의된 기준 이상으로 관리되는 기능 세트를 확장합니다. 기본값은 빈 세트입니다.

baselineCapabilitySet

string

baselineCapabilitySet은 활성화할 선택적 기능 세트를 선택합니다. 이 기능은 additionalEnabledCapabilities를 통해 확장할 수 있습니다. 설정되지 않은 경우 클러스터는 기본값을 선택하고 시간이 지남에 따라 기본값이 변경될 수 있습니다. 현재 기본값은 v current입니다.

6.1.3. .spec.desiredUpdate

설명
desiredUpdate는 클러스터 버전의 원하는 값을 나타내는 선택적 필드입니다. 이 값을 설정하면 업그레이드가 트리거됩니다(현재 버전이 원하는 버전과 일치하지 않는 경우). 권장 업데이트 값 세트는 상태에 사용 가능한 업데이트의 일부로 나열되며 해당 범위를 벗어나는 값을 설정하면 업그레이드가 실패할 수 있습니다. 필드 중 일부는 여기에 설명된 제한 및 의미와 관련이 있습니다. 1. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정됩니다. API 검증 오류. 2. 이미지가 지정되고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 이 작업을 수행하지 않아야 합니다. 버전은 자동으로 무시되고 이미지가 사용됩니다. 3. 이미지가 지정되고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 4. 이미지가 지정되고 버전이 지정되지 않으며, 아키텍처가 지정되지 않았습니다. 이미지가 사용됩니다. 5. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정됩니다. 버전 및 원하는 아키텍처는 이미지를 선택하는 데 사용됩니다. 6. 이미지를 지정하지 않고 버전이 지정되고, 아키텍처가 지정되지 않습니다. 버전 및 현재 아키텍처는 이미지를 선택하는 데 사용됩니다. 7. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정됩니다. API 검증 오류. 8. 이미지를 지정하지 않고 버전이 지정되지 않으며 아키텍처가 지정되지 않습니다. API 검증 오류. 업그레이드에 실패하면 Operator가 중지되고 실패한 구성 요소에 대한 상태를 보고합니다. 원하는 업데이트 값을 이전 버전으로 다시 설정하면 롤백이 수행됩니다. 모든 롤백이 성공하는 것은 아닙니다.
유형
object
속성유형설명

아키텍처

string

아키텍처는 클러스터 아키텍처의 원하는 값을 나타내는 선택적 필드입니다. 이 컨텍스트 클러스터 아키텍처에서는 단일 아키텍처 또는 다중 아키텍처를 의미합니다. 아키텍처는 Multi로만 설정할 수 있으므로 단일에서 다중 아키텍처로만 업데이트할 수 있습니다. 아키텍처가 설정된 경우 이미지를 설정할 수 없으며 버전을 설정해야 합니다. 유효한 값은 'Multi'이며 비어 있습니다.

force

boolean

강제를 사용하면 관리자가 확인 실패 또는 업그레이드 가능한 검사가 있는 이미지로 업데이트할 수 있습니다. 제공된 이미지가 클러스터에 대한 전체 관리 액세스 권한으로 실행되므로 이 옵션은 제공된 이미지의 진위 여부를 대역에서 확인할 때만 사용해야 합니다. 알 수 없거나 잠재적으로 악의적인 소스에서 제공되는 이미지에 이 플래그를 사용하지 마십시오.

image

string

이미지는 업데이트가 포함된 컨테이너 이미지 위치입니다. 원하는 버전이 availableUpdates 또는 history에 없는 경우 이미지를 사용해야 합니다. image가 설정되면 버전이 무시됩니다. image가 설정되면 버전이 비어 있어야 합니다. 이미지가 설정되면 아키텍처를 지정할 수 없습니다.

version

string

버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 아키텍처가 지정된 경우 image가 지정되고 필요한 경우 버전이 무시됩니다.

6.1.4. .spec.overrides

설명
덮어쓰기는 클러스터 버전 Operator에서 관리하는 구성 요소에 대한 덮어쓰기 목록입니다. 구성 요소를 비관리적으로 표시하면 Operator가 개체를 만들거나 업데이트할 수 없습니다.
유형
array

6.1.5. .spec.overrides[]

설명
ComponentOverride를 사용하면 구성 요소에 대한 클러스터 버전 Operator의 동작을 덮어쓸 수 있습니다.
유형
object
필수 항목
  • group
  • kind
  • name
  • 네임스페이스
  • Unmanaged
속성유형설명

group

string

group은 kind가 속한 API 그룹을 식별합니다.

kind

string

kind는 재정의할 오브젝트를 들여쓰기합니다.

name

string

구성 요소의 이름입니다.

네임스페이스

string

네임스페이스는 구성 요소의 네임스페이스입니다. 리소스가 클러스터 범위인 경우 네임스페이스가 비어 있어야 합니다.

Unmanaged

boolean

클러스터 버전 Operator가 이 클러스터의 리소스 관리를 중단해야 하는지 여부를 비관리 제어합니다. 기본값: false

6.1.6. .status

설명
상태에는 사용 가능한 업데이트 및 진행 중인 업데이트에 대한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • desired
  • observedGeneration
  • versionHash
속성유형설명

availableUpdates

``

availableUpdates에는 이 클러스터에 권장되는 업데이트가 포함되어 있습니다. conditionalUpdates에 표시되지만 availableUpdates에는 이 클러스터가 알려진 문제에 노출될 수 있습니다. 권장 업데이트가 없거나 업데이트 서비스를 사용할 수 없거나 잘못된 채널이 지정된 경우 이 목록이 비어 있을 수 있습니다.

capabilities

object

기능은 선택 사항인 핵심 클러스터 구성 요소의 상태를 설명합니다.

conditionalUpdates

array

conditionalUpdates에는 특정 필수 조건을 충족하는 경우 이 클러스터에 권장되는 업데이트 목록이 포함되어 있습니다. 이 클러스터에 권장되는 업데이트 세트에 관심이 있는 소비자는 availableUpdates를 사용해야 합니다. 권장 업데이트가 없거나 업데이트 서비스를 사용할 수 없거나 비어 있거나 잘못된 채널이 지정된 경우 이 목록이 비어 있을 수 있습니다.

conditionalUpdates[]

object

ConditionalUpdate는 현재 클러스터가 조정되어 있지만 현재 클러스터에 권장되지 않는 일부 클러스터에 권장되는 업데이트를 나타냅니다.

conditions

array

conditions는 클러스터 버전에 대한 정보를 제공합니다. desiredUpdate에 도달한 경우 "Available" 조건이 true로 설정됩니다. 업데이트가 적용되는 경우 "Progressing" 조건이 true로 설정됩니다. 현재 업데이트가 임시 또는 영구 오류로 차단되면 "Degraded" 조건이 true로 설정됩니다. 조건은 metadata.generation이 status.generation과 같은 경우 현재 desiredUpdate에만 유효합니다.

conditions[]

object

ClusterOperatorStatusCondition은 Operator의 관리 및 모니터링된 구성 요소의 상태를 나타냅니다.

desired

object

원하는 버전은 클러스터가 조정되는 버전입니다. 클러스터가 아직 완전히 초기화되지 않은 경우 사용 가능한 정보로 설정됩니다. 이 정보는 이미지 또는 태그일 수 있습니다.

내역

array

기록에는 클러스터에 적용된 최신 버전 목록이 포함되어 있습니다. 이 값은 클러스터를 시작하는 동안 비어 있을 수 있으며 새 업데이트가 적용되면 업데이트됩니다. 최신 업데이트는 목록의 첫 번째이며 업데이트 빈도에 따라 정렬됩니다. 롤아웃이 완료되면 기록의 업데이트 상태가 Completed로 표시됩니다 - 업데이트가 실패한 경우 또는 절반으로 적용된 상태가 Partial이 됩니다. 제한된 양의 업데이트 기록만 유지됩니다.

history[]

object

UpdateHistory는 클러스터의 시도된 단일 업데이트입니다.

observedGeneration

integer

observedGeneration은 동기화되는 사양 버전을 보고합니다. 이 값이 metadata.generation과 같지 않으면 원하는 및 조건 필드가 이전 버전을 나타낼 수 있습니다.

versionHash

string

versionHash는 클러스터가 업데이트될 콘텐츠의 지문입니다. Operator는 불필요한 작업을 피하기 위해 사용되며 내부 용도로만 사용됩니다.

6.1.7. .status.capabilities

설명
기능은 선택 사항인 핵심 클러스터 구성 요소의 상태를 설명합니다.
유형
object
속성유형설명

enabledCapabilities

배열(문자열)

enabled 기능은 현재 관리되는 모든 기능을 나열합니다.

knownCapabilities

배열(문자열)

알려진 기능은 현재 클러스터에 알려진 모든 기능을 나열합니다.

6.1.8. .status.conditionalUpdates

설명
conditionalUpdates에는 특정 필수 조건을 충족하는 경우 이 클러스터에 권장되는 업데이트 목록이 포함되어 있습니다. 이 클러스터에 권장되는 업데이트 세트에 관심이 있는 소비자는 availableUpdates를 사용해야 합니다. 권장 업데이트가 없거나 업데이트 서비스를 사용할 수 없거나 비어 있거나 잘못된 채널이 지정된 경우 이 목록이 비어 있을 수 있습니다.
유형
array

6.1.9. .status.conditionalUpdates[]

설명
ConditionalUpdate는 현재 클러스터가 조정되어 있지만 현재 클러스터에 권장되지 않는 일부 클러스터에 권장되는 업데이트를 나타냅니다.
유형
object
필수 항목
  • 릴리스
  • 위험
속성유형설명

conditions

array

conditions는 조건부 업데이트의 현재 상태를 관찰하는 것을 나타냅니다. 알려진 유형은 현재 클러스터에 업데이트를 권장하는지 여부에 대한 권장 사항입니다.

conditions[]

object

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

릴리스는 업데이트의 대상입니다.

위험

array

위험은 대상 릴리스 업데이트와 관련된 문제의 범위를 나타냅니다. cluster-version Operator는 모든 항목을 평가하고 하나 이상의 항목이 있고 모든 항목이 업데이트를 권장하는 경우에만 업데이트를 권장합니다.

risks[]

object

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

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

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

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.

6.1.12. .status.conditionalUpdates[].release

설명
릴리스는 업데이트의 대상입니다.
유형
object
속성유형설명

채널

배열(문자열)

채널은 릴리스가 현재 속한 Cincinnati 채널의 집합입니다.

image

string

image는 업데이트가 포함된 컨테이너 이미지 위치입니다. 이 필드가 spec의 일부이면 version이 지정되고 availableUpdates 필드에 일치하는 버전이 포함된 경우 이미지는 선택 사항입니다.

url

string

URL에는 이 릴리스에 대한 정보가 포함되어 있습니다. 이 URL은 릴리스의 'url' 메타데이터 속성 또는 업데이트 API에서 반환된 메타데이터에 의해 설정되며 사용자 인터페이스에 링크로 표시되어야 합니다. 테스트 또는 야간 릴리스에 대해 URL 필드를 설정하지 않을 수 있습니다.

version

string

버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 이 필드가 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

array

matchingRules는 어떤 클러스터가 위험과 일치하지 않는지 결정하는 조건 조각입니다. 슬라이스는 우선순위를 줄임으로써 정렬됩니다. cluster-version Operator는 슬라이스를 순서대로 실행하고 첫 번째 평가를 수행한 후 중지합니다. 조건이 성공적으로 평가되지 않으면 업데이트가 권장되지 않습니다.

matchingRules[]

object

ClusterCondition은 입력된 클러스터 조건의 결합입니다. 'type' 속성은 관련 유형별 속성을 결정합니다. 클러스터에서 평가되면 조건이 일치하거나 일치하지 않거나 평가되지 않을 수 있습니다.

message

string

message는Rules가 클러스터 상태와 일치하는 경우 업데이트 위험에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다.

name

string

Rules가 클러스터 상태와 일치하는 경우 name은 조건부 업데이트를 권장하지 않는 CamelCase 이유입니다.

url

string

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

object

PromQL은 PromQL을 기반으로 하는 클러스터 조건을 나타냅니다.

type

string

type은 cluster-condition 유형을 나타냅니다. 이는 추가 속성의 멤버 및 의미 체계를 정의합니다.

6.1.17. .status.conditionalUpdates[].risks[].matchingRules[].promql

설명
PromQL은 PromQL을 기반으로 하는 클러스터 조건을 나타냅니다.
유형
object
필수 항목
  • promql
속성유형설명

promql

string

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

string

lastTransitionTime은 현재 상태 속성에 대한 마지막 업데이트 시간입니다.

message

string

message는 현재 상태에 대한 추가 정보를 제공합니다. 이는 인간만 사용할 수 있습니다. 새 줄로 렌더링되어야 하는 줄 Feed 문자(U+000A)가 포함될 수 있습니다.

reason

string

이유는 조건의 현재 상태에 대한 CamelCase 이유입니다.

status

string

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

type

string

type은 이 조건에서 보고한 측면을 지정합니다.

6.1.20. .status.desired

설명
원하는 버전은 클러스터가 조정되는 버전입니다. 클러스터가 아직 완전히 초기화되지 않은 경우 사용 가능한 정보로 설정됩니다. 이 정보는 이미지 또는 태그일 수 있습니다.
유형
object
속성유형설명

채널

배열(문자열)

채널은 릴리스가 현재 속한 Cincinnati 채널의 집합입니다.

image

string

image는 업데이트가 포함된 컨테이너 이미지 위치입니다. 이 필드가 spec의 일부이면 version이 지정되고 availableUpdates 필드에 일치하는 버전이 포함된 경우 이미지는 선택 사항입니다.

url

string

URL에는 이 릴리스에 대한 정보가 포함되어 있습니다. 이 URL은 릴리스의 'url' 메타데이터 속성 또는 업데이트 API에서 반환된 메타데이터에 의해 설정되며 사용자 인터페이스에 링크로 표시되어야 합니다. 테스트 또는 야간 릴리스에 대해 URL 필드를 설정하지 않을 수 있습니다.

version

string

버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 이 필드가 spec의 일부인 경우 이미지가 지정된 경우 버전이 선택 사항입니다.

6.1.21. .status.history

설명
기록에는 클러스터에 적용된 최신 버전 목록이 포함되어 있습니다. 이 값은 클러스터를 시작하는 동안 비어 있을 수 있으며 새 업데이트가 적용되면 업데이트됩니다. 최신 업데이트는 목록의 첫 번째이며 업데이트 빈도에 따라 정렬됩니다. 롤아웃이 완료되면 기록의 업데이트 상태가 Completed로 표시됩니다 - 업데이트가 실패한 경우 또는 절반으로 적용된 상태가 Partial이 됩니다. 제한된 양의 업데이트 기록만 유지됩니다.
유형
array

6.1.22. .status.history[]

설명
UpdateHistory는 클러스터의 시도된 단일 업데이트입니다.
유형
object
필수 항목
  • image
  • startedTime
  • 상태
  • 검증됨
속성유형설명

acceptedRisks

string

acceptedRisks는 업데이트를 시작하기 위해 허용되는 위험을 기록합니다. 예를 들어 Upgradeable=False 또는 desiredUpdate.force를 통해 재정의된 서명이 누락되거나 권장 업데이트 대상 세트의 availableUpdates 세트에 없는 업데이트가 시작될 수 있습니다.

completionTime

``

completionTime이 설정되면 업데이트가 완전히 적용된 것입니다. 현재 적용 중인 업데이트에는 null 완료 시간이 있습니다. 완료 시간은 현재 업데이트가 아닌 항목에 대해 항상 설정됩니다(일반적으로 다음 업데이트의 시작 시점까지).

image

string

image는 업데이트가 포함된 컨테이너 이미지 위치입니다. 이 값은 항상 채워집니다.

startedTime

string

startedTime은 업데이트가 시작된 시간입니다.

상태

string

상태는 업데이트가 완전히 적용되었는지 여부를 반영합니다. Partial 상태는 업데이트가 완전히 적용되지 않았음을 나타내며 Completed 상태는 업데이트가 한 번 이상 롤아웃되었음을 나타냅니다(업데이트의 모든 부분이 성공적으로 적용됨).

검증됨

boolean

verified는 설치 전에 제공된 업데이트가 올바르게 확인되었는지 여부를 나타냅니다. false인 경우 클러스터를 신뢰할 수 없습니다. 확인은 업데이트 대상이 수락될 때 클러스터 상태에 따라 달라지는 업그레이드 가능한 검사에는 적용되지 않습니다.

version

string

버전은 업데이트 버전을 식별하는 의미 체계 버전입니다. 요청된 이미지가 버전을 정의하지 않거나 이미지를 검색하는 동안 오류가 발생하면 이 값이 비어 있을 수 있습니다.

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의 컬렉션 삭제
표 6.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ClusterVersion 유형의 오브젝트 나열
표 6.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterVersionList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ClusterVersion 스키마

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

200 - OK

ClusterVersion 스키마

201 - 생성됨

ClusterVersion 스키마

202 - 승인됨

ClusterVersion 스키마

401 - 무단

6.2.2. /apis/config.openshift.io/v1/clusterversions/{name}

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

name

string

ClusterVersion의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

ClusterVersion 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ClusterVersion 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterVersion으로 교체
표 6.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ClusterVersion 스키마

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

200 - OK

ClusterVersion 스키마

201 - 생성됨

ClusterVersion 스키마

401 - 무단

6.2.3. /apis/config.openshift.io/v1/clusterversions/{name}/status

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

name

string

ClusterVersion의 이름

HTTP 방법
GET
설명
지정된 ClusterVersion의 읽기 상태
표 6.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ClusterVersion 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ClusterVersion의 부분적으로 업데이트 상태
표 6.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ClusterVersion 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ClusterVersion의 상태 교체
표 6.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ClusterVersion 스키마

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

200 - OK

ClusterVersion 스키마

201 - 생성됨

ClusterVersion 스키마

401 - 무단

7장. 콘솔 [config.openshift.io/v1]

설명
콘솔에는 로그 아웃 URL을 포함하여 웹 콘솔에 대한 클러스터 전체 구성이 있으며 콘솔의 공용 URL을 보고합니다. 표준 이름은 cluster 입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

7.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

7.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

인증

object

ConsoleAuthentication은 콘솔 인증을 위한 선택적 구성 목록을 정의합니다.

7.1.2. .spec.authentication

설명
ConsoleAuthentication은 콘솔 인증을 위한 선택적 구성 목록을 정의합니다.
유형
object
속성유형설명

logoutRedirect

string

웹 브라우저를 콘솔에서 로그아웃한 후 로 리디렉션하는 선택적 절대 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
속성유형설명

consoleURL

string

콘솔의 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
설명
콘솔 컬렉션 삭제
표 7.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
콘솔 오브젝트 나열
표 7.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConsoleList 스키마

401 - 무단

HTTP 방법
POST
설명
콘솔 생성
표 7.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

콘솔 스키마

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

200 - OK

콘솔 스키마

201 - 생성됨

콘솔 스키마

202 - 승인됨

콘솔 스키마

401 - 무단

7.2.2. /apis/config.openshift.io/v1/consoles/{name}

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

name

string

콘솔 이름

HTTP 방법
DELETE
설명
콘솔 삭제
표 7.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

콘솔 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

콘솔 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 콘솔 교체
표 7.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

콘솔 스키마

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

200 - OK

콘솔 스키마

201 - 생성됨

콘솔 스키마

401 - 무단

7.2.3. /apis/config.openshift.io/v1/consoles/{name}/status

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

name

string

콘솔 이름

HTTP 방법
GET
설명
지정된 콘솔의 읽기 상태
표 7.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

콘솔 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

콘솔 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 콘솔의 상태 교체
표 7.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

콘솔 스키마

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

200 - OK

콘솔 스키마

201 - 생성됨

콘솔 스키마

401 - 무단

8장. DNS [config.openshift.io/v1]

설명
DNS에는 DNS에 대한 클러스터 전체 정보가 있습니다. 표준 이름은 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

8.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

8.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

baseDomain

string

baseDomain은 클러스터의 기본 도메인입니다. 모든 관리형 DNS 레코드는 이 기본 도메인의 하위 도메인이 됩니다. 예를 들어 기본 도메인 openshift.example.com 에서 cluster-api.openshift.example.com 에 대한 API 서버 DNS 레코드를 생성할 수 있습니다. 설정한 후에는 이 필드를 변경할 수 없습니다.

platform

object

플랫폼에는 DNS의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.

privateZone

object

privateZone은 클러스터에서만 사용할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 개인 레코드를 생성할 수 없습니다. 설정한 후에는 이 필드를 변경할 수 없습니다.

publicZone

object

publicZone은 공개적으로 인터넷에 액세스할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 공용 레코드를 생성하지 않아야 합니다. 설정한 후에는 이 필드를 변경할 수 없습니다.

8.1.2. .spec.platform

설명
플랫폼에는 DNS의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.
유형
object
필수 항목
  • type
속성유형설명

AWS

object

AWS에는 Amazon Web Services 클라우드 공급자와 관련된 DNS 구성이 포함되어 있습니다.

type

string

type은 클러스터의 기본 인프라 공급자입니다. 허용되는 값: "", "AWS". 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 가장 안전한 기본값을 사용하여 인식되지 않은 플랫폼을 처리해야 합니다.

8.1.3. .spec.platform.aws

설명
AWS에는 Amazon Web Services 클라우드 공급자와 관련된 DNS 구성이 포함되어 있습니다.
유형
object
속성유형설명

privateZoneIAMRole

string

PrivateZoneIAMRole에는 클러스터 DNS 구성에 지정된 클러스터의 프라이빗 호스팅 영역에서 작업을 수행할 때 가정해야 하는 IAM 역할의 ARN이 포함되어 있습니다. 비어 있는 경우 역할을 가정하지 않아야 합니다.

8.1.4. .spec.privateZone

설명
privateZone은 클러스터에서만 사용할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 개인 레코드를 생성할 수 없습니다. 설정한 후에는 이 필드를 변경할 수 없습니다.
유형
object
속성유형설명

id

string

ID는 DNS 호스팅 영역을 찾는 데 사용할 수 있는 식별자입니다. AWS 영역에서 ID 를 id로 사용하여 가져올 수 있습니다. Azure 영역의 ID는 [2]에서 ID 를 사용하여 가져올 수 있습니다 [2], GCP 영역의 ID 는 [3]에서 사전 결정된 이름으로 ID를 사용하여 가져올 수 있습니다. [1]: https://docs.aws.amazon.com/cli/latest/reference/route53/get-hosted-zone.html#options [2]: https://docs.microsoft.com/en-us/cli/azure/network/dns/zone?view=azure-cli-latest#az-network-dns-zone-show: https://cloud.google.com/dns/docs/reference/v1/managedZones/get

tags

오브젝트(문자열)

태그는 DNS 호스팅 영역을 쿼리하는 데 사용할 수 있습니다. AWS의 resourcegroupstaggingapi [1]은 태그 필터로 태그 를 사용하여 영역을 가져오는 데 사용할 수 있습니다 [1]: https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html#options

8.1.5. .spec.publicZone

설명
publicZone은 공개적으로 인터넷에 액세스할 수 있는 모든 DNS 레코드가 있는 위치입니다. 이 필드가 nil이면 공용 레코드를 생성하지 않아야 합니다. 설정한 후에는 이 필드를 변경할 수 없습니다.
유형
object
속성유형설명

id

string

ID는 DNS 호스팅 영역을 찾는 데 사용할 수 있는 식별자입니다. AWS 영역에서 ID 를 id로 사용하여 가져올 수 있습니다. Azure 영역의 ID는 [2]에서 ID 를 사용하여 가져올 수 있습니다 [2], GCP 영역의 ID 는 [3]에서 사전 결정된 이름으로 ID를 사용하여 가져올 수 있습니다. [1]: https://docs.aws.amazon.com/cli/latest/reference/route53/get-hosted-zone.html#options [2]: https://docs.microsoft.com/en-us/cli/azure/network/dns/zone?view=azure-cli-latest#az-network-dns-zone-show: https://cloud.google.com/dns/docs/reference/v1/managedZones/get

tags

오브젝트(문자열)

태그는 DNS 호스팅 영역을 쿼리하는 데 사용할 수 있습니다. AWS의 resourcegroupstaggingapi [1]은 태그 필터로 태그 를 사용하여 영역을 가져오는 데 사용할 수 있습니다 [1]: https://docs.aws.amazon.com/cli/latest/reference/resourcegroupstaggingapi/get-resources.html#options

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 컬렉션 삭제
표 8.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 DNS의 오브젝트 나열
표 8.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DNSList 스키마

401 - 무단

HTTP 방법
POST
설명
DNS 만들기
표 8.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

DNS 스키마

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

200 - OK

DNS 스키마

201 - 생성됨

DNS 스키마

202 - 승인됨

DNS 스키마

401 - 무단

8.2.2. /apis/config.openshift.io/v1/dnses/{name}

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

name

string

DNS 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

DNS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

DNS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

DNS 스키마

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

200 - OK

DNS 스키마

201 - 생성됨

DNS 스키마

401 - 무단

8.2.3. /apis/config.openshift.io/v1/dnses/{name}/status

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

name

string

DNS 이름

HTTP 방법
GET
설명
지정된 DNS의 읽기 상태
표 8.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

DNS 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

DNS 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 DNS의 상태 교체
표 8.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

DNS 스키마

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

200 - OK

DNS 스키마

201 - 생성됨

DNS 스키마

401 - 무단

9장. FeatureGate [config.openshift.io/v1]

설명
기능에는 기능 게이트에 대한 클러스터 전체 정보가 있습니다. 표준 이름은 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

9.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

9.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

customNoUpgrade

``

CustomNoUpgrade를 사용하면 모든 기능을 활성화 또는 비활성화할 수 있습니다. 이 기능을 켜는 것은 지원되지 않음, cannot SUPDONE, 그리고 PREVENTS UPGRADES입니다. 해당 특성으로 인해 이 설정을 검증할 수 없습니다. 오타가 있거나 실수로 잘못된 조합을 적용하는 경우 클러스터에서 복구할 수 없는 방식으로 실패할 수 있습니다. featureSet은 "CustomNoUpgrade"와 같아야 합니다.

featureSet

string

featureSet은 클러스터의 기능 목록을 변경합니다. 기본값은 비어 있습니다. 이 설정을 신중하게 조정합니다. 기능을 켜거나 끄면 클러스터에서 되돌릴 수 없으므로 취소할 수 없습니다.

9.1.2. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

conditions

array

조건은 현재 상태의 관찰을 나타냅니다. 알려진 .status.conditions.type은 "DeterminationDegraded"입니다.

conditions[]

object

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" // 기타 필드 }

FeatureGates

array

FeatureGates에는 payloadVersion에서 키를 지정하는 enabled 및 disabled featureGates 목록이 포함되어 있습니다. CVO 및 cluster-config-operator 이외의 Operator는 .status.featureGates를 읽고, 관리 중인 버전을 찾고, 활성화/비활성화된 기능 게이트를 찾고, 피연산자와 Operator를 일치시켜야 합니다. 특정 버전에 대해 활성화된/비활성화된 값은 다양한 .spec.featureSet 값이 선택되면 클러스터 수명 동안 변경될 수 있습니다. Operator는 프로세스를 다시 시작하여 이러한 변경 사항을 선택하도록 선택할 수 있지만 이전에 활성화/비활성화된 목록은 이 API의 범위를 벗어나며 개별 Operator의 책임이 있습니다. ClusterVersion.status에서 .version이 있는 featureGates만 이 목록에 표시됩니다.

featureGates[]

object

 

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

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

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

type

string

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
속성유형설명

비활성화됨

array

disabled는 이름이 지정된 버전에 대해 클러스터에서 비활성화된 모든 기능 게이트 목록입니다.

disabled[]

object

 

enabled

array

enabled는 이름이 지정된 버전에 대해 클러스터에서 활성화된 모든 기능 게이트 목록입니다.

enabled[]

object

 

version

string

Version은 ClusterVersion 및 ClusterOperator.Status.Versions 필드에서 제공하는 버전과 일치합니다.

9.1.7. .status.featureGates[].disabled

설명
disabled는 이름이 지정된 버전에 대해 클러스터에서 비활성화된 모든 기능 게이트 목록입니다.
유형
array

9.1.8. .status.featureGates[].disabled[]

설명
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 FeatureGate의 이름입니다.

9.1.9. .status.featureGates[].enabled

설명
enabled는 이름이 지정된 버전에 대해 클러스터에서 활성화된 모든 기능 게이트 목록입니다.
유형
array

9.1.10. .status.featureGates[].enabled[]

설명
유형
object
필수 항목
  • name
속성유형설명

name

string

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 컬렉션 삭제
표 9.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
FeatureGate 유형의 오브젝트 나열
표 9.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FeatureGateList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

FeatureGate 스키마

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

200 - OK

FeatureGate 스키마

201 - 생성됨

FeatureGate 스키마

202 - 승인됨

FeatureGate 스키마

401 - 무단

9.2.2. /apis/config.openshift.io/v1/featuregates/{name}

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

name

string

FeatureGate의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

FeatureGate 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

FeatureGate 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

FeatureGate 스키마

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

200 - OK

FeatureGate 스키마

201 - 생성됨

FeatureGate 스키마

401 - 무단

9.2.3. /apis/config.openshift.io/v1/featuregates/{name}/status

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

name

string

FeatureGate의 이름

HTTP 방법
GET
설명
지정된 FeatureGate의 읽기 상태
표 9.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

FeatureGate 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 FeatureGate의 부분적으로 업데이트 상태
표 9.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

FeatureGate 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 FeatureGate의 상태 교체
표 9.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

FeatureGate 스키마

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

200 - OK

FeatureGate 스키마

201 - 생성됨

FeatureGate 스키마

401 - 무단

10장. HelmChartRepository [helm.openshift.io/v1beta1]

설명
HelmChartRepository는 프록시된 Helm 차트 리포지터리 호환성 수준 2에 대한 클러스터 전체 구성을 보유하고 있습니다. 2단계: 최소 9개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

10.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

클러스터 내에서 리포지토리의 상태를 확인합니다.

10.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

connectionConfig

object

차트 리포지터리 연결에 필요한 구성

description

string

사람이 읽을 수 있는 선택적 리포지토리 설명인 UI에서 용도를 표시하는 데 사용할 수 있습니다.

비활성화됨

boolean

true로 설정하면 클러스터/네임스에서 리포지토리 사용량을 비활성화합니다.

name

string

사람이 읽을 수 있는 선택적 리포지토리 이름, UI에서 용도를 표시하는 데 사용할 수 있습니다.

10.1.2. .spec.connectionConfig

설명
차트 리포지터리 연결에 필요한 구성
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

tlsClientConfig

object

tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

url

string

차트 리포지터리 URL

10.1.3. .spec.connectionConfig.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

10.1.4. .spec.connectionConfig.tlsClientConfig

설명
tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

10.1.5. .status

설명
클러스터 내에서 리포지토리의 상태를 확인합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

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" // 기타 필드 }

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

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

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

type

string

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 삭제
표 10.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
HelmChartRepository 유형의 오브젝트 나열
표 10.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

HelmChartRepositoryList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

HelmChartRepository 스키마

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

200 - OK

HelmChartRepository 스키마

201 - 생성됨

HelmChartRepository 스키마

202 - 승인됨

HelmChartRepository 스키마

401 - 무단

10.2.2. /apis/helm.openshift.io/v1beta1/helmchartrepositories/{name}

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

name

string

HelmChartRepository 이름

HTTP 방법
DELETE
설명
delete a HelmChartRepository
표 10.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

HelmChartRepository 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

HelmChartRepository 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

HelmChartRepository 스키마

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

200 - OK

HelmChartRepository 스키마

201 - 생성됨

HelmChartRepository 스키마

401 - 무단

10.2.3. /apis/helm.openshift.io/v1beta1/helmchartrepositories/{name}/status

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

name

string

HelmChartRepository 이름

HTTP 방법
GET
설명
지정된 HelmChartRepository의 상태 읽기
표 10.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

HelmChartRepository 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 HelmChartRepository의 부분적으로 업데이트 상태
표 10.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

HelmChartRepository 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 HelmChartRepository의 상태 교체
표 10.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

HelmChartRepository 스키마

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

200 - OK

HelmChartRepository 스키마

201 - 생성됨

HelmChartRepository 스키마

401 - 무단

11장. Image [config.openshift.io/v1]

설명
이미지는 이미지 스트림 가져오기 및 외부 레지스트리의 런타임 구성과 관련된 정책을 관리합니다. 클러스터 관리자는 OpenShift가 이미지를 가져올 수 있는 레지스트리, 외부 레지스트리의 추가 CA 신뢰 번들, 레지스트리 호스트 이름을 차단하거나 허용하는 정책을 구성할 수 있습니다. OpenShift의 이미지 레지스트리를 공개에 노출할 때 클러스터 관리자가 외부 호스트 이름을 지정할 수도 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

11.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

11.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

additionalTrustedCA

object

additionalTrustedCA는 이미지 스트림 가져오기, Pod 이미지 가져오기, 빌드 이미지 가져오기 및 imageregistry pullthrough 중에 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

allowedRegistriesForImport

array

allowedRegistriesForImport는 일반 사용자가 이미지를 가져올 수 있는 컨테이너 이미지 레지스트리를 제한합니다. 이 목록을 유효한 Docker 이미지를 포함하고 애플리케이션을 가져올 수 있도록 신뢰하는 레지스트리로 설정합니다. API를 통해 이미지 또는 ImageStreamMapping을 생성할 수 있는 권한이 있는 사용자는 이 정책의 영향을 받지 않습니다. 일반적으로 관리자 또는 시스템 통합에만 이러한 권한이 있습니다.

allowedRegistriesForImport[]

object

RegistryLocation에는 레지스트리 도메인 이름으로 지정된 레지스트리 위치가 포함되어 있습니다. 도메인 이름에는 '*' 또는 '?'와 같은 와일드카드가 포함될 수 있습니다.

externalRegistryHostnames

배열(문자열)

externalRegistryHostnames는 기본 외부 이미지 레지스트리의 호스트 이름을 제공합니다. 외부 호스트 이름은 이미지 레지스트리가 외부에 노출되는 경우에만 설정되어야 합니다. 첫 번째 값은 ImageStreams의 'publicDockerImageRepository' 필드에서 사용됩니다. 값은 "hostname[:port]" 형식이어야 합니다.

registrySources

object

registrySources에는 builds+pods의 이미지에 액세스하는 경우 컨테이너 런타임에서 개별 레지스트리를 처리하는 방법을 결정하는 구성이 포함되어 있습니다(예: 비보안 액세스를 허용할지 여부). 내부 클러스터 레지스트리에 대한 구성은 포함되어 있지 않습니다.

11.1.2. .spec.additionalTrustedCA

설명
additionalTrustedCA는 이미지 스트림 가져오기, Pod 이미지 가져오기, 빌드 이미지 가져오기 및 imageregistry pullthrough 중에 신뢰해야 하는 추가 CA가 포함된 ConfigMap에 대한 참조입니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

11.1.3. .spec.allowedRegistriesForImport

설명
allowedRegistriesForImport는 일반 사용자가 이미지를 가져올 수 있는 컨테이너 이미지 레지스트리를 제한합니다. 이 목록을 유효한 Docker 이미지를 포함하고 애플리케이션을 가져올 수 있도록 신뢰하는 레지스트리로 설정합니다. API를 통해 이미지 또는 ImageStreamMapping을 생성할 수 있는 권한이 있는 사용자는 이 정책의 영향을 받지 않습니다. 일반적으로 관리자 또는 시스템 통합에만 이러한 권한이 있습니다.
유형
array

11.1.4. .spec.allowedRegistriesForImport[]

설명
RegistryLocation에는 레지스트리 도메인 이름으로 지정된 레지스트리 위치가 포함되어 있습니다. 도메인 이름에는 '*' 또는 '?'와 같은 와일드카드가 포함될 수 있습니다.
유형
object
속성유형설명

domainName

string

domainname은 레지스트리의 도메인 이름을 지정합니다. 레지스트리가 비표준(80 또는 443) 포트를 사용하는 경우 도메인 이름에도 포트가 포함되어야 합니다.

insecure

boolean

insecure는 레지스트리가 보안(https)인지 아니면 비보안(http)인지(지정되지 않은 경우) 레지스트리가 안전한 것으로 간주되는지 여부를 나타냅니다.

11.1.5. .spec.registrySources

설명
registrySources에는 builds+pods의 이미지에 액세스하는 경우 컨테이너 런타임에서 개별 레지스트리를 처리하는 방법을 결정하는 구성이 포함되어 있습니다(예: 비보안 액세스를 허용할지 여부). 내부 클러스터 레지스트리에 대한 구성은 포함되어 있지 않습니다.
유형
object
속성유형설명

allowedRegistries

배열(문자열)

allowedRegistries는 이미지 가져오기 및 푸시 작업에 허용되는 유일한 레지스트리입니다. 다른 모든 레지스트리는 거부됩니다. BlockedRegistries 또는 AllowedRegistries 중 하나만 설정할 수 있습니다.

blockedRegistries

배열(문자열)

blockedRegistries는 이미지 가져오기 및 푸시 작업에 사용할 수 없습니다. 다른 모든 레지스트리는 허용됩니다. BlockedRegistries 또는 AllowedRegistries 중 하나만 설정할 수 있습니다.

containerRuntimeSearchRegistries

배열(문자열)

containerRuntimeSearchRegistries는 가져오기 사양에 정규화된 도메인이 없는 이미지를 가져올 때 검색할 레지스트리입니다. 목록에 제공된 순서대로 레지스트리가 검색됩니다. 참고: 이 검색 목록은 컨테이너 런타임, 즉 CRI-O에서만 작동합니다. 빌드 또는 이미지 스트림 가져오기에서는 작동하지 않습니다.

insecureRegistries

배열(문자열)

insecureRegistries는 유효한 TLS 인증서가 없거나 HTTP 연결만 지원하는 레지스트리입니다.

11.1.6. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

externalRegistryHostnames

배열(문자열)

externalRegistryHostnames는 기본 외부 이미지 레지스트리의 호스트 이름을 제공합니다. 외부 호스트 이름은 이미지 레지스트리가 외부에 노출되는 경우에만 설정되어야 합니다. 첫 번째 값은 ImageStreams의 'publicDockerImageRepository' 필드에서 사용됩니다. 값은 "hostname[:port]" 형식이어야 합니다.

internalRegistryHostname

string

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
설명
이미지 컬렉션 삭제
표 11.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류의 이미지 오브젝트 나열
표 11.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageList 스키마

401 - 무단

HTTP 방법
POST
설명
이미지 생성
표 11.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

이미지 스키마

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

200 - OK

이미지 스키마

201 - 생성됨

이미지 스키마

202 - 승인됨

이미지 스키마

401 - 무단

11.2.2. /apis/config.openshift.io/v1/images/{name}

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

name

string

이미지 이름

HTTP 방법
DELETE
설명
이미지 삭제
표 11.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

이미지 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

이미지 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 이미지 교체
표 11.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

이미지 스키마

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

200 - OK

이미지 스키마

201 - 생성됨

이미지 스키마

401 - 무단

11.2.3. /apis/config.openshift.io/v1/images/{name}/status

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

name

string

이미지 이름

HTTP 방법
GET
설명
지정된 이미지의 읽기 상태
표 11.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

이미지 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 이미지의 부분적으로 업데이트 상태
표 11.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

이미지 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 이미지의 상태 교체
표 11.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

이미지 스키마

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

200 - OK

이미지 스키마

201 - 생성됨

이미지 스키마

401 - 무단

12장. ImageDigestMirrorSet [config.openshift.io/v1]

설명
ImageDigestMirrorSet은 다이제스트 가져오기 사양을 사용하여 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

12.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

상태에는 리소스의 관찰된 상태가 포함됩니다.

12.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

imageDigestMirrors

array

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) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다. 특정 미러 순서를 사용하려는 사용자는 예상 순서를 사용하여 하나의 미러 목록으로 구성해야 합니다.

imageDigestMirrors[]

object

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

string

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

소스

string

소스는 사용자가 참조하는 리포지토리(예: 이미지 가져오기 사양)와 일치합니다. 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의 컬렉션 삭제
표 12.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ImageDigestMirrorSet 유형의 오브젝트 나열
표 12.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageDigestMirrorSetList schema

401 - 무단

HTTP 방법
POST
설명
ImageDigestMirrorSet 만들기
표 12.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ImageDigestMirrorSet schema

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

200 - OK

ImageDigestMirrorSet schema

201 - 생성됨

ImageDigestMirrorSet schema

202 - 승인됨

ImageDigestMirrorSet schema

401 - 무단

12.2.2. /apis/config.openshift.io/v1/imagedigestmirrorsets/{name}

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

name

string

ImageDigestMirrorSet의 이름

HTTP 방법
DELETE
설명
delete an ImageDigestMirrorSet
표 12.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

ImageDigestMirrorSet schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ImageDigestMirrorSet schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageDigestMirrorSet을 교체합니다.
표 12.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ImageDigestMirrorSet schema

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

200 - OK

ImageDigestMirrorSet schema

201 - 생성됨

ImageDigestMirrorSet schema

401 - 무단

12.2.3. /apis/config.openshift.io/v1/imagedigestmirrorsets/{name}/status

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

name

string

ImageDigestMirrorSet의 이름

HTTP 방법
GET
설명
지정된 ImageDigestMirrorSet의 읽기 상태
표 12.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageDigestMirrorSet schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImageDigestMirrorSet의 부분적으로 업데이트 상태
표 12.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ImageDigestMirrorSet schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageDigestMirrorSet의 상태 교체
표 12.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ImageDigestMirrorSet schema

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

200 - OK

ImageDigestMirrorSet schema

201 - 생성됨

ImageDigestMirrorSet schema

401 - 무단

13장. ImageContentPolicy [config.openshift.io/v1]

설명
ImageContentPolicy에는 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

13.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

13.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

repositoryDigestMirrors

array

repositoryDigestMirrors를 사용하면 Pod의 이미지 다이제스트에서 참조하는 이미지를 다른 미러링된 저장소 위치에서 가져올 수 있습니다. Pod에 제공된 이미지 가져오기 사양은 RepositoryDigestMirrors에 설명된 소스 위치와 비교되며, 이미지는 지정된 저장소 대신 목록의 미러에서 다운될 수 있으므로 관리자가 잠재적으로 더 빠른 미러를 선택할 수 있습니다. 태그를 통해 미러에서 이미지를 가져오려면 "allowMirrorByTags"를 설정해야 합니다. 각 "소스" 리포지토리는 개별적으로 처리됩니다. 다른 "소스" 리포지토리의 구성은 상호 작용하지 않습니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 동일한 "소스" 저장소에 대해 여러 정책이 정의되면 정의된 미러 세트가 함께 병합되어 가능한 경우 미러의 상대 순서를 유지합니다. 예를 들어 정책 A에 미러 a, b, c 및 정책 B에 미러 c, d, e 가 있는 경우 미러는 a, b, c, d, e 순서로 사용됩니다. 미러 항목 순서가 충돌하는 경우(예: a, b vs). b) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다.

repositoryDigestMirrors[]

object

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

boolean

allowMirrorByTags true인 경우 미러를 사용하여 태그에서 참조하는 이미지를 가져올 수 있습니다. 기본값은 false이며 미러는 다이제스트에서 참조하는 이미지를 가져올 때만 작동합니다. 태그로 이미지를 가져오면 가져오는 끝점에 따라 잠재적으로 다른 이미지를 생성할 수 있습니다. 미러에 대한 digest-pulls를 강제 적용하면 이러한 문제가 발생하지 않습니다.

미러

배열(문자열)

미러는 동일한 이미지를 포함할 수도 있는 0개 이상의 리포지토리입니다. "mirrors"를 지정하지 않으면 pull 사양의 지정된 리포지토리에서 이미지를 계속 가져옵니다. 미러가 구성되지 않습니다. 이 목록의 미러 순서는 사용자의 원하는 우선 순위로 처리되지만 소스는 기본적으로 모든 미러보다 낮은 우선 순위로 간주됩니다. 다른 repositoryDigestMirrors 오브젝트를 포함한 기타 클러스터 구성은 다른 repositoryDigestMirrors 오브젝트에 영향을 미칠 수 있고, 정확한 순서 지정에 영향을 미치거나, 일부 미러는 병렬로 연락을 취할 수 있으므로 주문 보장 대신 기본 설정으로 간주해야 합니다.

소스

string

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 컬렉션 삭제
표 13.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ImageContentPolicy 유형의 오브젝트 나열
표 13.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageContentPolicyList schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ImageContentPolicy schema

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

200 - OK

ImageContentPolicy schema

201 - 생성됨

ImageContentPolicy schema

202 - 승인됨

ImageContentPolicy schema

401 - 무단

13.2.2. /apis/config.openshift.io/v1/imagecontentpolicies/{name}

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

name

string

ImageContentPolicy 이름

HTTP 방법
DELETE
설명
delete an ImageContentPolicy
표 13.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

ImageContentPolicy schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ImageContentPolicy schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ImageContentPolicy schema

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

200 - OK

ImageContentPolicy schema

201 - 생성됨

ImageContentPolicy schema

401 - 무단

13.2.3. /apis/config.openshift.io/v1/imagecontentpolicies/{name}/status

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

name

string

ImageContentPolicy 이름

HTTP 방법
GET
설명
지정된 ImageContentPolicy의 읽기 상태
표 13.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageContentPolicy schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImageContentPolicy의 부분적으로 업데이트 상태
표 13.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ImageContentPolicy schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageContentPolicy의 상태 교체
표 13.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ImageContentPolicy schema

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

200 - OK

ImageContentPolicy schema

201 - 생성됨

ImageContentPolicy schema

401 - 무단

14장. ImageTagMirrorSet [config.openshift.io/v1]

설명
ImageTagMirrorSet은 태그 풀 사양을 사용하여 에서 레지스트리 미러 규칙을 처리하는 방법에 대한 클러스터 전체 정보를 보유합니다. 여러 정책이 정의되면 동작 결과가 각 필드에 정의됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

14.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

상태에는 리소스의 관찰된 상태가 포함됩니다.

14.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

imageTagMirrors

array

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) 구성이 거부되지 않지만 결과 순서가 지정되지 않습니다. 미러의 결정적 순서를 사용하려는 사용자는 예상 순서를 사용하여 하나의 미러 목록으로 구성해야 합니다.

imageTagMirrors[]

object

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

string

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

소스

string

소스는 사용자가 참조하는 리포지토리(예: 이미지 가져오기 사양)와 일치합니다. 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의 컬렉션 삭제
표 14.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ImageTagMirrorSet 유형의 오브젝트 나열
표 14.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageTagMirrorSetList schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ImageTagMirrorSet schema

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

200 - OK

ImageTagMirrorSet schema

201 - 생성됨

ImageTagMirrorSet schema

202 - 승인됨

ImageTagMirrorSet schema

401 - 무단

14.2.2. /apis/config.openshift.io/v1/imagetagmirrorsets/{name}

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

name

string

ImageTagMirrorSet의 이름

HTTP 방법
DELETE
설명
delete an ImageTagMirrorSet
표 14.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

ImageTagMirrorSet schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ImageTagMirrorSet schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageTagMirrorSet을 교체합니다.
표 14.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ImageTagMirrorSet schema

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

200 - OK

ImageTagMirrorSet schema

201 - 생성됨

ImageTagMirrorSet schema

401 - 무단

14.2.3. /apis/config.openshift.io/v1/imagetagmirrorsets/{name}/status

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

name

string

ImageTagMirrorSet의 이름

HTTP 방법
GET
설명
지정된 ImageTagMirrorSet의 읽기 상태
표 14.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ImageTagMirrorSet schema

401 - 무단

HTTP 방법
PATCH
설명
지정된 ImageTagMirrorSet의 부분적으로 업데이트 상태
표 14.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ImageTagMirrorSet schema

401 - 무단

HTTP 방법
PUT
설명
지정된 ImageTagMirrorSet의 상태 교체
표 14.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ImageTagMirrorSet schema

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

200 - OK

ImageTagMirrorSet schema

201 - 생성됨

ImageTagMirrorSet schema

401 - 무단

15장. 인프라 [config.openshift.io/v1]

설명
인프라에 대한 클러스터 전체 정보가 있습니다. 표준 이름은 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

15.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

15.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

cloudConfig

object

cloudConfig는 클라우드 공급자 구성 파일이 포함된 ConfigMap에 대한 참조입니다. 이 구성 파일은 기본 제공 클라우드 공급자 통합 또는 외부 클라우드 컨트롤러 관리자를 사용할 때 Kubernetes 클라우드 공급자 통합을 구성하는 데 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. cloudConfig는 kube_cloud_config 컨트롤러에서만 사용해야 합니다. 컨트롤러는 다양한 플랫폼의 사양에서 사용자 구성을 사용하고 이 필드에 사용자가 제공한 ConfigMap과 결합하여 stitched kube 클라우드 구성을 생성합니다. 컨트롤러는 kube 클라우드 구성이 cloud.conf 키에 저장된 openshift-config-managed 네임스페이스에 ConfigMap kube-cloud-config 를 생성합니다. 모든 클라이언트는 생성된 ConfigMap만 사용해야 합니다.

platformSpec

object

platformSpec은 기본 인프라 공급자와 관련된 원하는 정보를 보유합니다.

15.1.2. .spec.cloudConfig

설명
cloudConfig는 클라우드 공급자 구성 파일이 포함된 ConfigMap에 대한 참조입니다. 이 구성 파일은 기본 제공 클라우드 공급자 통합 또는 외부 클라우드 컨트롤러 관리자를 사용할 때 Kubernetes 클라우드 공급자 통합을 구성하는 데 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다. cloudConfig는 kube_cloud_config 컨트롤러에서만 사용해야 합니다. 컨트롤러는 다양한 플랫폼의 사양에서 사용자 구성을 사용하고 이 필드에 사용자가 제공한 ConfigMap과 결합하여 stitched kube 클라우드 구성을 생성합니다. 컨트롤러는 kube 클라우드 구성이 cloud.conf 키에 저장된 openshift-config-managed 네임스페이스에 ConfigMap kube-cloud-config 를 생성합니다. 모든 클라이언트는 생성된 ConfigMap만 사용해야 합니다.
유형
object
속성유형설명

key

string

key를 사용하면 configmap 내의 특정 키/값을 가리킬 수 있습니다. 이는 논리 파일 참조에 유용합니다.

name

string

 

15.1.3. .spec.platformSpec

설명
platformSpec은 기본 인프라 공급자와 관련된 원하는 정보를 보유합니다.
유형
object
속성유형설명

alibabaCloud

object

alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.

AWS

object

AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.

azure

object

Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다.

baremetal

object

baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다.

equinixMetal

object

EquinixMetal에는 Equinix Metal 인프라 공급자에 대한 설정이 포함되어 있습니다.

external

object

ExternalPlatformType은 일반 인프라 공급자를 나타냅니다. 플랫폼별 구성 요소는 별도로 보완해야 합니다.

gcp

object

GCP에는 Google Cloud Platform 인프라 공급자와 관련된 설정이 포함되어 있습니다.

ibmcloud

object

IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.

kubevirt

object

kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.

nutanix

object

Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다.

OpenStack

object

OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다.

ovirt

object

ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.

powervs

object

PowerVS에는 IBM Power Systems Virtual Servers 인프라 공급자와 관련된 설정이 포함되어 있습니다.

type

string

type은 클러스터의 기본 인프라 공급자입니다. 이 값은 서비스 로드 밸런서, 동적 볼륨 프로비저닝, 머신 생성 및 삭제와 같은 인프라 자동화가 활성화되는지 여부를 제어합니다. None인 경우 인프라 자동화가 활성화되지 않습니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" 및 "None"입니다. 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 해당 플랫폼을 지원하지 않는 경우 인식되지 않은 플랫폼을 None으로 처리해야 합니다.

vSphere

object

vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다.

15.1.4. .spec.platformSpec.alibabaCloud

설명
alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object

15.1.5. .spec.platformSpec.aws

설명
AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

serviceEndpoints

array

serviceEndpoints 목록에는 AWS Services의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점이 포함되어 있습니다. 서비스에는 하나의 ServiceEndpoint만 있어야 합니다.

serviceEndpoints[]

object

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
속성유형설명

name

string

이름은 AWS 서비스의 이름입니다. 모든 서비스 이름 목록은 https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html 에서 확인할 수 있으며 제공해야 하며 비워 둘 수 없습니다.

url

string

URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다.

15.1.8. .spec.platformSpec.azure

설명
Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object

15.1.9. .spec.platformSpec.baremetal

설명
baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.apiServerInternalIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.ingressIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다.

machineNetworks

배열(문자열)

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

string

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

array

failureDomains는 Nutanix 플랫폼에 대한 실패 도메인 정보를 구성합니다. 설정하면 여기에 정의된 장애 도메인을 사용하여 클러스터의 내결함성을 개선하기 위해 prism 요소 클러스터에 머신을 분배할 수 있습니다.

failureDomains[]

object

NutanixFailureDomain은 Nutanix 플랫폼에 대한 실패 도메인 정보를 구성합니다.

prismCentral

object

prismCentral에는 Nutanix Prism Central에 액세스할 수 있는 엔드포인트 주소와 포트가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오.

prismElements

array

prism Cryostats에는 Nutanix Prism Central의 Nutanix Prism Cryostat (클러스터)에 액세스하기 위해 하나 이상의 엔드 포인트 주소와 포트 데이터가 있습니다. 현재 OpenShift 클러스터에 사용되는 모든 Nutanix 리소스(VM, 서브넷, 볼륨 등)가 있는 OpenShift 클러스터에 대해 하나의 Prism Element(클러스터)만 지원합니다. 앞으로는 Prism Central의 여러 Prism Cryostat(클러스터)에 걸쳐 Nutanix 리소스(VM 등)를 지원할 수 있습니다.

prismElements[]

object

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
속성유형설명

cluster

object

클러스터는 머신의 VM을 생성할 클러스터(프리즈m Central의 관리 하에서 Presm Element)를 식별하는 것입니다. 클러스터 식별자(uuid 또는 name)는 Prism Central 콘솔에서 또는 prism_central API를 사용하여 가져올 수 있습니다.

name

string

name은 실패 도메인의 고유한 이름을 정의합니다. 이름은 필수이며 최대 64자여야 합니다. 소문자 영숫자 및 하이픈(-)만 구성되어야 합니다. 영숫자 문자로 시작하고 끝나야 합니다. 이 값은 임의의 값이며 플랫폼 내에서 장애 도메인을 식별하는 데 사용됩니다.

subnets

array

서브넷에는 머신의 VM에 연결할 클러스터의 네트워크 서브넷의 식별자 목록(하나 이상)이 있습니다. 서브넷 식별자(uuid 또는 name)는 Prism Central 콘솔에서 또는 prism_central API를 사용하여 가져올 수 있습니다.

subnets[]

object

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
속성유형설명

name

string

이름은 PC의 리소스 이름입니다. 유형이 Name인 경우 비워 둘 수 없습니다.

type

string

type은 이 리소스에 사용할 식별자 유형입니다.

uuid

string

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
속성유형설명

name

string

이름은 PC의 리소스 이름입니다. 유형이 Name인 경우 비워 둘 수 없습니다.

type

string

type은 이 리소스에 사용할 식별자 유형입니다.

uuid

string

UUID는 PC에 있는 리소스의 UUID입니다. 유형이 UUID인 경우 비워 둘 수 없습니다.

15.1.21. .spec.platformSpec.nutanix.prismCentral

설명
prismCentral에는 Nutanix Prism Central에 액세스할 수 있는 엔드포인트 주소와 포트가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오.
유형
object
필수 항목
  • address
  • port
속성유형설명

address

string

address는 Nutanix Prism Central 또는 Element (cluster)의 엔드포인트 주소(DNS 이름 또는 IP 주소)입니다.

port

integer

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

object

endpoint에는 Prism Element (cluster)의 엔드포인트 주소 및 포트 데이터가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오.

name

string

name은 Prism Element (cluster)의 이름입니다. 이 값은 다른 리소스(예: 머신, PVC 등)에 구성된 클러스터 필드에 해당합니다.

15.1.24. .spec.platformSpec.nutanix.prismElements[].endpoint

설명
endpoint에는 Prism Element (cluster)의 엔드포인트 주소 및 포트 데이터가 있습니다. 클러스터 전체 프록시가 설치되면 기본적으로 이 끝점은 프록시를 통해 액세스할 수 있습니다. 이 끝점과 통신할 필요가 없는 경우 프록시 spec.noProxy 목록에 끝점을 추가하십시오.
유형
object
필수 항목
  • address
  • port
속성유형설명

address

string

address는 Nutanix Prism Central 또는 Element (cluster)의 엔드포인트 주소(DNS 이름 또는 IP 주소)입니다.

port

integer

port는 Nutanix Prism Central 또는 Element (cluster)에 액세스하는 포트 번호입니다.

15.1.25. .spec.platformSpec.openstack

설명
OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.apiServerInternalIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.ingressIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다.

machineNetworks

배열(문자열)

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

array

serviceEndpoints는 Power VS 서비스의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점 목록입니다.

serviceEndpoints[]

object

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
속성유형설명

name

string

이름은 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

string

URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다.

15.1.30. .spec.platformSpec.vsphere

설명
vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.apiServerInternalIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다.

failureDomains

array

failureDomains에는 지역, 영역 및 vCenter 토폴로지의 정의가 포함되어 있습니다. 실패 도메인(지역 및 영역)을 생략하면 사용되지 않습니다.

failureDomains[]

object

VSpherePlatformFailureDomainSpec에는 리전 및 영역 장애 도메인과 해당 실패 도메인의 vCenter 토폴로지가 있습니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 IPv4 제품군의 IP 주소와 IPv6에서 하나씩 두 개의 IP 주소가 포함되어 있습니다. 단일 스택 클러스터에서 단일 IP 주소가 예상됩니다. 생략하면 status.ingressIPs의 값이 사용됩니다. 설정한 후에는 목록을 완전히 제거할 수 없지만 두 번째 항목은 제거할 수 있습니다.

machineNetworks

배열(문자열)

machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다. 각 네트워크는 CIDR 형식으로 제공되며 IPv4 또는 IPv6(예: "10.0.0.0/8" 또는 "fd00::/8")이어야 합니다.

nodeNetworking

object

nodeNetworking에는 노드의 네트워킹을 할당하기 위한 내부 및 외부 네트워크 제약 조건의 정의가 포함되어 있습니다. 이 필드를 생략하면 네트워킹은 기본적으로 단일 주소만 지원하고 발견된 첫 번째 주소를 반환하는 기존 주소 선택 동작으로 설정됩니다.

vCenters

array

vCenter에는 vCenter와 통신할 서비스의 연결 세부 정보가 있습니다. 현재 단일 vCenter만 지원됩니다. ---

vcenters[]

object

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

string

name은 실패 도메인의 임의의 고유 이름을 정의합니다.

region

string

region은 vCenter 데이터 센터에 연결할 리전 태그의 이름을 정의합니다. vCenter의 태그 카테고리 이름은 openshift-region이어야 합니다.

server

string

server는 정규화된 도메인 이름 또는 vCenter 서버의 IP 주소입니다. ---

토폴로지

object

토폴로지는 vSphere 구성을 사용하여 지정된 실패 도메인을 설명합니다.

영역

string

zone은 vCenter 클러스터에 연결할 영역 태그의 이름을 정의합니다. vCenter의 태그 카테고리는 이름이 openshift-zone이어야 합니다.

15.1.33. .spec.platformSpec.vsphere.failureDomains[].topology

설명
토폴로지는 vSphere 구성을 사용하여 지정된 실패 도메인을 설명합니다.
유형
object
필수 항목
  • computeCluster
  • 데이터 센터
  • 데이터 저장소
  • 네트워크
속성유형설명

computeCluster

string

computeCluster 가상 머신이 있을 vCenter 클러스터의 절대 경로입니다. 절대 경로는 /<datacenter>/host/<cluster> 형식입니다. 경로의 최대 길이는 2048자입니다.

데이터 센터

string

데이터센터는 가상 머신이 있을 vCenter 데이터 센터의 이름입니다. 데이터 센터 이름의 최대 길이는 80자입니다.

데이터 저장소

string

Datastore는 가상 머신이 있는 데이터 저장소의 절대 경로입니다. 절대 경로는 /<datacenter>/datastore/<datastore> 최대 경로 길이는 2048자입니다.

folder

string

폴더는 가상 머신이 있는 폴더의 절대 경로입니다. 절대 경로는 /<datacenter>/vm/<folder> 형식입니다. 경로의 최대 길이는 2048자입니다.

네트워크

배열(문자열)

네트워크는 이 실패 도메인 내의 포트 그룹 네트워크 이름 목록입니다. 현재는 RHCOS 가상 머신당 단일 인터페이스만 지원합니다. 사용 가능한 네트워크(포트 그룹)는 govc ls 'network/*' 를 사용하여 나열할 수 있습니다. 단일 인터페이스는 /<datacenter>/network/<portgroup> 형식의 절대 경로여야 합니다.

resourcePool

string

ResourcePool은 가상 머신이 생성될 리소스 풀의 절대 경로입니다. 절대 경로는 /<datacenter>/host/<cluster>/Resources/<resourcepool> 형식입니다. 경로의 최대 길이는 2048자입니다.

템플릿

string

템플릿은 이 장애 도메인에서 새 시스템을 생성할 때 복제할 가상 머신 또는 템플릿의 전체 인벤토리 경로입니다. 경로의 최대 길이는 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

object

external은 외부에서 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다.

internal

object

internal은 클러스터 내에서만 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다.

15.1.35. .spec.platformSpec.vsphere.nodeNetworking.external

설명
external은 외부에서 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다.
유형
object
속성유형설명

excludeNetworkSubnetCidr

배열(문자열)

status.addresses 필드에 사용할 VirtualMachine의 VM에서 IP 주소를 선택할 때 서브넷 범위의 excludeNetworkSubnetCidr IP 주소가 제외됩니다. ---

network

string

status.addresses 필드를 검색할 때 사용할 Network VirtualMachine의 VM 네트워크 이름입니다. internal.networkSubnetCIDR 및 external.networkSubnetCIDR가 설정되지 않은 경우 이 네트워크에 연결된 vNIC에는 단일 IP 주소만 있어야 합니다. 사용 가능한 네트워크(포트 그룹)는 govc ls 'network/*'를 사용하여 나열할 수 있습니다.

networkSubnetCidr

배열(문자열)

각 status.addresses 필드에 사용할 필드의 CIDR에 포함된 VirtualMachine의 네트워크 인터페이스의 NetworkSubnetCidr IP 주소입니다. ---

15.1.36. .spec.platformSpec.vsphere.nodeNetworking.internal

설명
internal은 클러스터 내에서만 라우팅할 수 있는 노드의 네트워크 구성을 나타냅니다.
유형
object
속성유형설명

excludeNetworkSubnetCidr

배열(문자열)

status.addresses 필드에 사용할 VirtualMachine의 VM에서 IP 주소를 선택할 때 서브넷 범위의 excludeNetworkSubnetCidr IP 주소가 제외됩니다. ---

network

string

status.addresses 필드를 검색할 때 사용할 Network VirtualMachine의 VM 네트워크 이름입니다. internal.networkSubnetCIDR 및 external.networkSubnetCIDR가 설정되지 않은 경우 이 네트워크에 연결된 vNIC에는 단일 IP 주소만 있어야 합니다. 사용 가능한 네트워크(포트 그룹)는 govc ls 'network/*'를 사용하여 나열할 수 있습니다.

networkSubnetCidr

배열(문자열)

각 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

integer

port는 vCenter 엔드포인트와 통신하는 데 사용할 TCP 포트입니다. 생략하면 사용자에게 의견이 없으며 시간이 지남에 따라 변경될 수 있는 적절한 기본값을 선택하는 것이 플랫폼에 달려 있습니다.

server

string

server는 정규화된 도메인 이름 또는 vCenter 서버의 IP 주소입니다. ---

15.1.39. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

apiServerInternalURI

string

apiServerInternalURL은 스키마 'https', 주소 및 선택적으로 포트(기본값: 443)가 있는 유효한 URI입니다. Kubernetes 네트워킹이 아닌 인프라 공급자를 사용하여 kubelets와 같은 구성 요소에서 apiServerInternalURL을 사용할 수 있습니다.

apiServerURL

string

apiServerURL은 스키마 'https', 주소 및 선택적으로 포트(선택 사항)가 있는 유효한 URI입니다. 웹 콘솔과 같은 구성 요소에서 apiServerURL을 사용하여 Kubernetes API를 찾을 위치를 사용자에게 알릴 수 있습니다.

controlPlaneTopology

string

controlPlaneTopology는 일반적으로 컨트롤 노드에서 실행되는 피연산자에 대한 기대치를 나타냅니다. 기본값은 'HighlyAvailable'이며, 이는 Operator가 "일반" 클러스터에 있는 동작을 나타냅니다. 'SingleReplica' 모드는 단일 노드 배포에서 사용되며 Operator는 고가용성 작업에 대한 피연산자를 구성하지 않아야 합니다. 'External' 모드는 컨트롤 플레인이 클러스터에 외부에 호스팅되고 해당 구성 요소가 클러스터 내에 표시되지 않음을 나타냅니다.

cpuPartitioning

string

cpu Cryostat는 클러스터에서 CPU 파티셔닝이 현재 활성화된 기능인지 여부를 나타냅니다. CPU 파티셔닝은 이 클러스터가 특정 CPU 세트에 대한 워크로드 파티셔닝을 지원할 수 있음을 의미합니다. 유효한 값은 "None" 및 "AllNodes"입니다. 생략하면 기본값은 "없음"입니다. 기본값 "없음"은 CPU 파티셔닝으로 노드가 설정되지 않음을 나타냅니다. "AllNodes" 값은 모든 노드가 CPU 파티셔닝으로 설정되었음을 나타내며 PerformanceProfile API를 통해 추가로 구성할 수 있습니다.

etcdDiscoveryDomain

string

etcdDiscoveryDomain은 etcd 서버 및 클라이언트를 검색하기 위해 SRV 레코드를 가져오는 데 사용되는 도메인입니다. 자세한 정보: https://github.com/etcd-io/etcd/blob/329be66e8b3f9e2e6af83c123ff89297e49ebd15/Documentation/op-guide/clustering.md#dns-discovery 더 이상 사용되지 않음: 4.7부터 이 필드는 더 이상 설정되거나 적용되지 않습니다. 향후 릴리스에서 제거됩니다.

infrastructureName

string

infrastructureName은 사람이 친숙한 이름으로 클러스터를 고유하게 식별합니다. 설정한 후에는 변경할 수 없습니다. 최대 길이 27이어야 하며 영숫자 또는 하이픈 문자만 있어야 합니다.

infrastructureTopology

string

infrastructureTopology는 컨트롤 플레인 노드에서 실행되지 않는 인프라 서비스에 대한 기대치를 표현합니다. 일반적으로 master 이외의 역할 값에 대한 노드 선택기로 표시됩니다. 기본값은 'HighlyAvailable'이며, 이는 Operator가 "일반" 클러스터에 있는 동작을 나타냅니다. 'SingleReplica' 모드는 단일 노드 배포에서 사용되며 Operator는 고가용성 작동에 대한 피연산자를 구성하지 않아야 합니다. 외부 토폴로지 모드는 이 필드에 적용되지 않습니다.

platform

string

플랫폼은 클러스터의 기본 인프라 공급자입니다. deprecated: 대신 platformStatus.type을 사용합니다.

platformStatus

object

platformStatus는 기본 인프라 공급자와 관련된 상태 정보를 보유합니다.

15.1.40. .status.platformStatus

설명
platformStatus는 기본 인프라 공급자와 관련된 상태 정보를 보유합니다.
유형
object
속성유형설명

alibabaCloud

object

alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.

AWS

object

AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.

azure

object

Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다.

baremetal

object

baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다.

equinixMetal

object

EquinixMetal에는 Equinix Metal 인프라 공급자에 대한 설정이 포함되어 있습니다.

external

object

external에는 일반 외부 인프라 공급자와 관련된 설정이 포함되어 있습니다.

gcp

object

GCP에는 Google Cloud Platform 인프라 공급자와 관련된 설정이 포함되어 있습니다.

ibmcloud

object

IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.

kubevirt

object

kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.

nutanix

object

Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다.

OpenStack

object

OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다.

ovirt

object

ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.

powervs

object

PowerVS에는 Power Systems Virtual Servers 인프라 공급자와 관련된 설정이 포함되어 있습니다.

type

string

type은 클러스터의 기본 인프라 공급자입니다. 이 값은 서비스 로드 밸런서, 동적 볼륨 프로비저닝, 머신 생성 및 삭제와 같은 인프라 자동화가 활성화되는지 여부를 제어합니다. None인 경우 인프라 자동화가 활성화되지 않습니다. 허용되는 값은 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "EquinixMetal", "PowerVS", "AlibabaCloud", "Nutanix" 및 "None"입니다. 개별 구성 요소는 모든 플랫폼을 지원하지 않을 수 있으며, 해당 플랫폼을 지원하지 않는 경우 인식되지 않은 플랫폼을 None으로 처리해야 합니다. 이 값은 status.platformstatus.platformStatus.type 과 동기화됩니다. 현재는 이 값을 설정한 후에는 변경할 수 없습니다.

vSphere

object

vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다.

15.1.41. .status.platformStatus.alibabaCloud

설명
alibabacloud에는 Alibaba Cloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
필수 항목
  • region
속성유형설명

region

string

region은 클러스터에 대해 생성된 Alibaba Cloud 리소스의 리전을 지정합니다.

resourceGroupID

string

resourceGroupID는 클러스터의 리소스 그룹의 ID입니다.

resourceTags

array

resourceTags는 클러스터에 대해 생성된 Alibaba Cloud 리소스에 적용할 추가 태그 목록입니다.

resourceTags[]

object

AlibabaCloudResourceTag는 리소스에 적용할 태그 세트입니다.

15.1.42. .status.platformStatus.alibabaCloud.resourceTags

설명
resourceTags는 클러스터에 대해 생성된 Alibaba Cloud 리소스에 적용할 추가 태그 목록입니다.
유형
array

15.1.43. .status.platformStatus.alibabaCloud.resourceTags[]

설명
AlibabaCloudResourceTag는 리소스에 적용할 태그 세트입니다.
유형
object
필수 항목
  • key
  • value
속성유형설명

key

string

key는 태그의 키입니다.

value

string

value는 태그의 값입니다.

15.1.44. .status.platformStatus.aws

설명
AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

region

string

리전에는 클러스터에서 생성한 새 AWS 리소스의 기본 AWS 리전이 있습니다.

resourceTags

array

resourceTags는 클러스터에 대해 생성된 AWS 리소스에 적용할 추가 태그 목록입니다. AWS 리소스 태그 지정에 대한 자세한 내용은 https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html 을 참조하십시오. AWS는 리소스당 최대 50개의 태그를 지원합니다. OpenShift는 사용할 수 있도록 25개의 태그를 예약하고 사용자가 사용할 수 있는 25개의 태그를 사용할 수 있습니다.

resourceTags[]

object

AWSResourceTag는 클러스터에 대해 생성된 AWS 리소스에 적용할 태그입니다.

serviceEndpoints

array

serviceEndpoints 목록에는 AWS Services의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점이 포함되어 있습니다. 서비스에는 하나의 ServiceEndpoint만 있어야 합니다.

serviceEndpoints[]

object

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

string

key는 태그의 키입니다.

value

string

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
속성유형설명

name

string

이름은 AWS 서비스의 이름입니다. 모든 서비스 이름 목록은 https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html 에서 확인할 수 있으며 제공해야 하며 비워 둘 수 없습니다.

url

string

URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다.

15.1.49. .status.platformStatus.azure

설명
Azure에는 Azure 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

armEndpoint

string

armEndpoint는 Azure Stack과 같이 정렬되지 않은 클라우드에서 리소스 관리에 사용할 URL을 지정합니다.

cloudName

string

cloudName은 적절한 Azure API 엔드포인트로 Azure SDK를 구성하는 데 사용할 수 있는 Azure 클라우드 환경의 이름입니다. 비어 있는 경우 값은 AzurePublicCloud 와 동일합니다.

networkResourceGroupName

string

NetworkResourceGroupName은 클러스터에서 사용하는 가상 네트워크 및 서브넷과 같은 네트워크 리소스의 리소스 그룹입니다. 비어 있는 경우 값은 ResourceGroupName과 동일합니다.

resourceGroupName

string

resourceGroupName은 클러스터에 대해 생성된 새 Azure 리소스의 리소스 그룹입니다.

resourceTags

array

resourceTags는 클러스터에 대해 생성된 Azure 리소스에 적용할 추가 태그 목록입니다. Azure 리소스에 태그 지정에 대한 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/resources/tags 을 참조하십시오. Automation, Content Delivery Network, DNS Azure 리소스에 대한 제한으로 인해 최대 15개의 태그가 적용될 수 있습니다. OpenShift는 내부 사용을 위해 5개의 태그를 예약하여 사용자 구성에 10개의 태그를 허용합니다.

resourceTags[]

object

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

string

key는 태그의 주요 부분입니다. 태그 키는 최대 128자를 가질 수 있으며 비워 둘 수 없습니다. key는 문자, 숫자 또는 밑줄로 끝나야 하며 영숫자와 다음과 같은 특수 문자만 포함해야 합니다.

value

string

value는 태그의 값 부분입니다. 태그 값은 최대 256자일 수 있으며 비워 둘 수 없습니다. value에는 영숫자만 포함되어야 하며 다음 특수 문자 _ + . / : ; < = > ? @.

15.1.52. .status.platformStatus.baremetal

설명
baremetal에는 BareMetal 플랫폼과 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIP

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다.

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

loadBalancer

object

LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.

machineNetworks

배열(문자열)

machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다.

nodeDNSIP

string

nodeDNSIP는 노드에서 사용하는 내부 DNS의 IP 주소입니다. DNS Operator에서 관리하는 것과 달리 NodeDNSIP 는 노드 자체의 이름 확인을 제공합니다. BareMetal 배포를 위한 DNS-as-a-service가 없습니다. 데이터 센터 DNS에 대한 필요한 변경을 최소화하기 위해 DNS 서비스는 클러스터의 노드에 해당 호스트 이름을 제공하기 위해 정적 포드로 호스팅됩니다.

15.1.53. .status.platformStatus.baremetal.loadBalancer

설명
LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
유형
object
속성유형설명

type

string

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

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다.

15.1.55. .status.platformStatus.external

설명
external에는 일반 외부 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

cloudControllerManager

object

CloudControllerManager에는 외부 클라우드 컨트롤러 관리자(a.k.a)와 관련된 설정이 포함되어 있습니다. CCM 또는 CPI). 생략하면 새 노드가 테인트되지 않으며 클라우드 컨트롤러 관리자에서 추가 초기화가 필요하지 않습니다.

15.1.56. .status.platformStatus.external.cloudControllerManager

설명
CloudControllerManager에는 외부 클라우드 컨트롤러 관리자(a.k.a)와 관련된 설정이 포함되어 있습니다. CCM 또는 CPI). 생략하면 새 노드가 테인트되지 않으며 클라우드 컨트롤러 관리자에서 추가 초기화가 필요하지 않습니다.
유형
object
속성유형설명

상태

string

상태에 따라 외부 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
속성유형설명

projectID

string

resourceGroupName은 클러스터에 대해 생성된 새 GCP 리소스의 프로젝트 ID입니다.

region

string

리전에는 클러스터에 대해 생성된 새 GCP 리소스의 리전이 있습니다.

resourceLabels

array

resourceLabels는 클러스터에 대해 생성된 GCP 리소스에 적용할 추가 레이블 목록입니다. GCP 리소스에 레이블을 지정하는 방법에 대한 자세한 내용은 https://cloud.google.com/compute/docs/labeling-resources 을 참조하십시오. GCP는 리소스당 최대 64개의 라벨을 지원합니다. OpenShift는 내부 사용을 위해 32 레이블을 예약하여 사용자 구성에 32개의 레이블을 허용합니다.

resourceLabels[]

object

GCPResourceLabel은 클러스터에 대해 생성된 GCP 리소스에 적용할 레이블입니다.

resourceTags

array

resourceTags는 클러스터에 대해 생성된 GCP 리소스에 적용할 추가 태그 목록입니다. GCP 리소스 태그 지정에 대한 자세한 내용은 https://cloud.google.com/resource-manager/docs/tags/tags-overview 을 참조하십시오. GCP는 리소스당 최대 50개의 태그를 지원합니다.

resourceTags[]

object

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

string

key는 라벨의 핵심 부분입니다. 레이블 키는 최대 63자의 수 있으며 비워 둘 수 없습니다. 레이블 키는 소문자로 시작해야 하며 소문자, 숫자 문자 및 다음 특수 문자 _- 만 포함해야 합니다. 레이블 키에는 예약된 접두사 kubernetes-ioopenshift-io 가 없어야 합니다.

value

string

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

string

key는 태그의 주요 부분입니다. 태그 키는 최대 63자의 수 있으며 비워 둘 수 없습니다. 태그 키는 영숫자 문자로 시작하고 끝나야 하며 대문자, 소문자 영숫자 및 다음 특수 문자 ._- 만 포함해야 합니다.

parentID

string

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

string

value는 태그의 값 부분입니다. 태그 값은 최대 63자의 수 있으며 비워 둘 수 없습니다. 태그 값은 영숫자 문자로 시작하고 끝나야 하며 대문자, 소문자 영숫자 및 다음 특수 문자 _-.@%=+:,*#&(){}[] 및 공백만 포함해야 합니다.

15.1.62. .status.platformStatus.ibmcloud

설명
IBMCloud에는 IBMCloud 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

cisInstanceCRN

string

CISInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 Cloud Internet Services 인스턴스의 CRN입니다.

dnsInstanceCRN

string

DNSInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 DNS 서비스 인스턴스의 CRN입니다.

위치

string

Location is where the cluster has been deployed

providerType

string

ProviderType은 생성된 클러스터 유형을 나타냅니다.

resourceGroupName

string

resourceGroupName은 클러스터에 대해 생성된 새 IBMCloud 리소스의 리소스 그룹입니다.

serviceEndpoints

array

serviceEndpoints는 IBM Cloud 서비스의 기본 서비스 끝점을 재정의하는 사용자 정의 끝점 목록입니다. 이러한 끝점은 각 IBM Cloud Services에 도달하기 위해 클러스터 내의 구성 요소에서 사용됩니다.

serviceEndpoints[]

object

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
속성유형설명

name

string

이름은 IBM Cloud 서비스의 이름입니다. 가능한 값은 CIS, COSConfig, DNSServices, GlobalCatalog, GlobalSearch, GlobalTagging, HyperProtect, IAM, KeyProtect, ResourceController, ResourceManager 또는 VPC입니다. 예를 들어 IBM Cloud Private IAM 서비스는 IAM 서비스 이름과 https://private.iam.cloud.ibm.comURL 로 구성할 수 있습니다. 미국 남부의 IBM Cloud Private VPC 서비스는 VPCurl 의 서비스 이름으로 구성할 수 있습니다.https://us.south.private.iaas.cloud.ibm.com

url

string

URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다.

15.1.65. .status.platformStatus.kubevirt

설명
kubevirt에는 kubevirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIP

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다.

15.1.66. .status.platformStatus.nutanix

설명
Nutanix에는 Nutanix 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIP

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다.

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

loadBalancer

object

LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.

15.1.67. .status.platformStatus.nutanix.loadBalancer

설명
LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
유형
object
속성유형설명

type

string

type은 OpenShift API 및 Ingress 끝점에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 Nutanix 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다.

15.1.68. .status.platformStatus.openstack

설명
OpenStack에는 OpenStack 인프라 공급업체와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIP

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다.

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

cloudName

string

cloudName은 클라이언트 구성 파일(clouds.yaml)에서 원하는 OpenStack 클라우드의 이름입니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

loadBalancer

object

LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.

machineNetworks

배열(문자열)

machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다.

nodeDNSIP

string

nodeDNSIP는 노드에서 사용하는 내부 DNS의 IP 주소입니다. DNS Operator에서 관리하는 것과 달리 NodeDNSIP 는 노드 자체의 이름 확인을 제공합니다. OpenStack 배포를 위한 DNS-as-a-service가 없습니다. 데이터 센터 DNS에 대한 필요한 변경을 최소화하기 위해 DNS 서비스는 클러스터의 노드에 해당 호스트 이름을 제공하기 위해 정적 포드로 호스팅됩니다.

15.1.69. .status.platformStatus.openstack.loadBalancer

설명
LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
유형
object
속성유형설명

type

string

type은 OpenShift API 및 Ingress 엔드포인트에 사용할 사용자 관리 또는 openshift 관리 로드 밸런서일 수 있는 OpenStack 플랫폼의 클러스터에서 사용하는 로드 밸런서 유형을 정의합니다. OpenShiftManagedDefault로 설정하면 API를 담당하는 정적 Pod가 배포되고 머신 구성 Operator에 정의된 Ingress 트래픽 로드 밸런싱이 배포됩니다. UserManaged로 설정하면 이러한 정적 Pod가 배포되지 않으며 로드 밸런서가 배포자에 의해 대역 외부로 구성됩니다. 생략하면 이는 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 기본값은 OpenShiftManagedDefault입니다.

15.1.70. .status.platformStatus.ovirt

설명
ovirt에는 oVirt 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIP

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다.

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

loadBalancer

object

LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.

nodeDNSIP

string

더 이상 사용되지 않음: 4.6부터 이 필드는 더 이상 설정되거나 적용되지 않습니다. 향후 릴리스에서 제거됩니다.

15.1.71. .status.platformStatus.ovirt.loadBalancer

설명
LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
유형
object
속성유형설명

type

string

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

string

CISInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 Cloud Internet Services 인스턴스의 CRN입니다.

dnsInstanceCRN

string

DNSInstanceCRN은 클러스터의 기본 도메인의 DNS 영역을 관리하는 DNS 서비스 인스턴스의 CRN입니다.

region

string

리전에는 클러스터에서 생성한 새 Power VS 리소스의 기본 Power VS 리전이 있습니다.

resourceGroup

string

ResourceGroup은 클러스터에 대해 생성된 새 IBMCloud 리소스의 리소스 그룹 이름입니다. 여기에 지정된 리소스 그룹은 cluster-image-registry-operator에서 클러스터 레지스트리의 IBMCloud에 COS 인스턴스를 설정하는 데 사용됩니다. 리소스 그룹에 대한 자세한 내용은 여기에서 확인할 수 있습니다. https://cloud.ibm.com/docs/account?topic=account-rgs. 생략하면 이미지 레지스트리 Operator가 스토리지를 구성할 수 없으므로 이미지 레지스트리 클러스터 Operator가 사용 가능한 상태가 되지 않습니다.

serviceEndpoints

array

serviceEndpoints는 Power VS 서비스의 기본 서비스 끝점을 재정의하는 사용자 지정 끝점 목록입니다.

serviceEndpoints[]

object

PowervsServiceEndpoint는 사용자 지정 URL의 구성을 저장하여 PowerVS 서비스의 기존 기본값을 재정의합니다.

영역

string

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
속성유형설명

name

string

이름은 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

string

URL은 스키마 https로 정규화된 URI로, 클라이언트의 기본 생성된 엔드포인트를 덮어씁니다. 이 값을 제공해야 하며 비워 둘 수 없습니다.

15.1.75. .status.platformStatus.vsphere

설명
vSphere에는 VSphere 인프라 공급자와 관련된 설정이 포함되어 있습니다.
유형
object
속성유형설명

apiServerInternalIP

string

apiServerInternalIP는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. Infrastructure.status.apiServerInternalURI가 가리키는 IP입니다. API 서버 앞에 자체 호스팅 로드 밸런서의 IP입니다. deprecated: 대신 APIServerInternalIP를 사용합니다.

apiServerInternalIPs

배열(문자열)

apiServerInternalIPs는 Kubernetes 네트워킹이 아닌 인프라를 사용하는 kubelet과 같이 클러스터 내부의 구성 요소에서 사용할 수 있는 Kubernetes API 서버에 연결하는 IP 주소입니다. API 서버 앞에 있는 자체 호스팅 로드 밸런서의 IP입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

ingressIP

string

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. deprecated: 대신 IngressIP를 사용합니다.

ingressIPs

배열(문자열)

ingressIP는 기본 Ingress 컨트롤러로 라우팅하는 외부 IP입니다. IP는 기본 경로 호스트 이름을 확인하는 데 사용되는 와일드카드 DNS 레코드의 대상입니다. 듀얼 스택 클러스터에서 이 목록에는 두 개의 IP가 포함되어 있습니다. 그렇지 않으면 하나의 IP만 포함됩니다.

loadBalancer

object

LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.

machineNetworks

배열(문자열)

machineNetworks는 모든 OpenShift 클러스터 노드를 연결하는 데 사용되는 IP 네트워크입니다.

nodeDNSIP

string

nodeDNSIP는 노드에서 사용하는 내부 DNS의 IP 주소입니다. DNS Operator에서 관리하는 것과 달리 NodeDNSIP 는 노드 자체의 이름 확인을 제공합니다. vSphere 배포를 위한 DNS-as-a-service가 없습니다. 데이터 센터 DNS에 대한 필요한 변경을 최소화하기 위해 DNS 서비스는 클러스터의 노드에 해당 호스트 이름을 제공하기 위해 정적 포드로 호스팅됩니다.

15.1.76. .status.platformStatus.vsphere.loadBalancer

설명
LoadBalancer는 클러스터에서 사용하는 로드 밸런서를 구성하는 방법을 정의합니다.
유형
object
속성유형설명

type

string

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
설명
인프라 컬렉션 삭제
표 15.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
인프라 유형의 오브젝트 나열
표 15.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

InfrastructureList 스키마

401 - 무단

HTTP 방법
POST
설명
인프라 생성
표 15.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

인프라 스키마

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

200 - OK

인프라 스키마

201 - 생성됨

인프라 스키마

202 - 승인됨

인프라 스키마

401 - 무단

15.2.2. /apis/config.openshift.io/v1/infrastructures/{name}

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

name

string

인프라 이름

HTTP 방법
DELETE
설명
인프라 삭제
표 15.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 인프라 읽기
표 15.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

인프라 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

인프라 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 인프라를 교체
표 15.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

인프라 스키마

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

200 - OK

인프라 스키마

201 - 생성됨

인프라 스키마

401 - 무단

15.2.3. /apis/config.openshift.io/v1/infrastructures/{name}/status

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

name

string

인프라 이름

HTTP 방법
GET
설명
지정된 인프라의 읽기 상태
표 15.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

인프라 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 인프라의 부분적으로 업데이트 상태
표 15.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

인프라 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 인프라의 상태 교체
표 15.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

인프라 스키마

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

200 - OK

인프라 스키마

201 - 생성됨

인프라 스키마

401 - 무단

16장. Ingress [config.openshift.io/v1]

설명
Ingress에는 경로에 사용되는 기본 인그레스 도메인을 포함하여 Ingress에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은 cluster 입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

16.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

16.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

appsDomain

string

appsDomain은 명시적 호스트를 지정하지 않고 경로가 생성될 때 도메인 필드에 지정된 대신 사용할 선택적 도메인입니다. appsDomain이 비어 있지 않은 경우 이 값은 경로의 기본 호스트 값을 생성하는 데 사용됩니다. domain과 달리 appsDomain은 설치 후 수정할 수 있습니다. 이는 새 ingresscontroller가 와일드카드 인증서로 설정되었다고 가정합니다.

componentRoutes

array

componentRoutes는 cluster-admin이 호스트 이름 및 제공 인증서를 구성할 수 있는 OpenShift 구성 요소에서 관리하는 선택적 경로 목록입니다. 이 목록에 있는 각 경로의 네임스페이스 및 이름은 status.componentRoutes 목록의 기존 항목과 일치해야 합니다. 구성 가능한 경로 세트를 확인하려면 .status.componentRoutes 목록의 네임스페이스 및 항목 이름을 확인합니다. 여기서 참여 Operator는 구성 가능한 경로의 상태를 작성합니다.

componentRoutes[]

object

ComponentRouteSpec을 사용하면 경로의 호스트 이름 및 인증서를 제공할 수 있습니다.

domain

string

도메인은 경로의 호스트 이름이 비어 있을 때 경로에 대한 기본 호스트 이름을 생성하는 데 사용됩니다. 생성된 호스트 이름은 "<route-name>.<route-namespace>.<domain>" 패턴을 따릅니다. 또한 수신에 대한 기본 와일드카드 도메인 접미사로 사용됩니다. 기본 ingresscontroller 도메인은 "*.<domain>" 패턴을 따릅니다. 설정한 후에는 도메인 변경이 현재 지원되지 않습니다.

loadBalancer

object

LoadBalancer에는 현재 클러스터의 기본 인프라 공급자뿐만 아니라 OpenShift에서 작업하는 데 필요한 로드 밸런서 세부 정보가 포함되어 있습니다.

requiredHSTSPolicies

array

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 정책 주석이 유효합니다.

requiredHSTSPolicies[]

object

 

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

string

hostname은 경로에서 사용해야 하는 호스트 이름입니다.

name

string

name은 사용자 지정할 경로의 논리 이름입니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 status.componentRoutes 목록의 해당 항목과 일치해야 합니다.

네임스페이스

string

네임스페이스는 사용자 지정할 경로의 네임스페이스입니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 status.componentRoutes 목록의 해당 항목과 일치해야 합니다.

servingCertKeyPairSecret

object

servingCertKeyPairSecret은 openshift-config 네임스페이스에 있는 kubernetes.io/tls 유형의 보안에 대한 참조입니다. 제공 인증서/키 쌍은 일치하고 Operator가 이 이름으로 제공하려는 의도를 이행하기 위해 사용해야 합니다. 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다.

16.1.4. .spec.componentRoutes[].servingCertKeyPairSecret

설명
servingCertKeyPairSecret은 openshift-config 네임스페이스에 있는 kubernetes.io/tls 유형의 보안에 대한 참조입니다. 제공 인증서/키 쌍은 일치하고 Operator가 이 이름으로 제공하려는 의도를 이행하기 위해 사용해야 합니다. 사용자 정의 호스트 이름이 클러스터의 기본 라우팅 접미사를 사용하는 경우 제공 인증서에 대한 Secret 사양이 필요하지 않습니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

16.1.5. .spec.loadBalancer

설명
LoadBalancer에는 현재 클러스터의 기본 인프라 공급자뿐만 아니라 OpenShift에서 작업하는 데 필요한 로드 밸런서 세부 정보가 포함되어 있습니다.
유형
object
속성유형설명

platform

object

플랫폼에는 인그레스 로드 밸런서의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.

16.1.6. .spec.loadBalancer.platform

설명
플랫폼에는 인그레스 로드 밸런서의 기본 인프라 공급자와 관련된 구성이 있습니다. 생략하면 사용자에게 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다.
유형
object
속성유형설명

AWS

object

AWS에는 Amazon Web Services 인프라 공급자와 관련된 설정이 포함되어 있습니다.

type

string

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

string

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

배열(문자열)

domainPatterns는 원하는 HSTS 주석이 필요한 도메인 목록입니다. domainPatterns가 지정되고 도메인 중 하나와 일치하는 spec.host로 경로가 생성되는 경우 경로는 일치하는 RequiredHSTSPolicy에 설명된 HSTS 정책 구성 요소를 지정해야 합니다. 다음과 같이 와일드카드를 사용할 수 있습니다. .foo.com은 foo.com 아래의 모든 항목과 일치하므로 foo.com과 그 아래의 모든 항목을 포함하려면 *를 지정해야 합니다.

includeSubDomainsPolicy

string

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

object

maxAge는 HSTS 호스트로 간주되는 호스트 중 delta 시간 범위(초)입니다. 0으로 설정하면 효과가 무효화되고 호스트는 HSTS 호스트로 제거됩니다. 0으로 설정하고 includeSubdomains가 지정되면 호스트의 모든 하위 도메인도 HSTS 호스트로 제거됩니다. maxAge는 time-to-live 값이며 이 정책이 클라이언트에서 새로 고쳐지지 않으면 HSTS 정책이 결국 해당 클라이언트에 만료됩니다.

namespaceSelector

object

namespaceSelector는 선택기와 일치하는 라벨이 있고 DomainPatterns 중 하나에 있는 네임스페이스에 있는 네임스페이스에만 정책이 적용되도록 라벨 선택기를 지정합니다. 기본값은 모든 것과 일치하는 빈 LabelSelector입니다.

preloadPolicy

string

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
속성유형설명

largestMaxAge

integer

RequiredHSTSPolicy max-age 이 값은 지정되지 않은 상태로 둘 수 있으며 이 경우 상한이 적용되지 않습니다.

smallestMaxAge

integer

RequiredHSTSPolicy max-age Setting max-age=0의 최소 허용된 값(초)에서는 호스트에서 기존 HSTS 헤더를 삭제할 수 있습니다. 이는 관리자가 오류를 신속하게 수정하는 데 필요한 도구입니다. 이 값은 지정되지 않은 상태로 둘 수 있습니다. 이 경우 더 낮은 제한이 적용되지 않습니다.

16.1.11. .spec.requiredHSTSPolicies[].namespaceSelector

설명
namespaceSelector는 선택기와 일치하는 라벨이 있고 DomainPatterns 중 하나에 있는 네임스페이스에 있는 네임스페이스에만 정책이 적용되도록 라벨 선택기를 지정합니다. 기본값은 모든 것과 일치하는 빈 LabelSelector입니다.
유형
object
속성유형설명

matchExpressions

array

matchExpressions는 라벨 선택기 요구 사항 목록입니다. 요구 사항은 AND로 설정됩니다.

matchExpressions[]

object

레이블 선택기 요구 사항은 값, 키 및 키와 관련된 연산자를 포함하는 선택기입니다.

matchLabels

오브젝트(문자열)

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

string

key는 선택기가 적용되는 라벨 키입니다.

operator

string

Operator는 일련의 값과의 키 관계를 나타냅니다. 유효한 연산자는 In, NotIn, Exists 및 DoesNotExist입니다.

배열(문자열)

값은 문자열 값의 배열입니다. 연산자가 In 또는 NotIn인 경우 값 배열은 비어 있지 않아야 합니다. 연산자가 Exists 또는 DoesNotExist인 경우 값 배열은 비어 있어야 합니다. 이 배열은 전략적 병합 패치 중에 교체됩니다.

16.1.14. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

componentRoutes

array

componentRoutes는 참여 연산자가 cluster-admin에 의해 호스트 이름 및 제공 인증서를 사용자 지정할 수 있는 경로에 대한 현재 경로 상태를 배치하는 위치입니다.

componentRoutes[]

object

ComponentRouteStatus에는 경로의 호스트 이름 구성 및 제공 인증서를 허용하는 정보가 포함되어 있습니다.

defaultPlacement

string

기본적으로 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
속성유형설명

conditions

array

조건은 componentRoutes 항목의 상태를 전달하는 데 사용됩니다. 지원되는 상태에는 Available, Degraded 및 Progressing이 포함됩니다. 사용 가능한 경우 경로에서 제공하는 콘텐츠에 사용자가 액세스할 수 있습니다. 여기에는 cluster-admin에서 지정한 사용자 지정 경로가 구성된 동안 기본값이 계속 콘텐츠를 제공할 수 있는 경우가 포함됩니다. Degraded가 true인 경우 componentRoutes 항목을 처리하려고 하는 데 문제가 발생했습니다. currentHostnames 필드는 적용되거나 적용되지 않을 수 있습니다. Progressing이 true인 경우 구성 요소가 componentRoutes 항목과 관련된 몇 가지 작업을 수행 중임을 의미합니다.

conditions[]

object

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" // 기타 필드 }

consumingUsers

배열(문자열)

consumingUsers는 servingCertKeyPairSecret 보안에 대한 읽기 권한이 필요한 ServiceAccounts 슬라이스입니다.

currentHostnames

배열(문자열)

currentHostnames는 경로에서 사용하는 현재 이름 목록입니다. 일반적으로 이 목록은 단일 호스트 이름으로 구성되어야 하지만 경로에서 여러 호스트 이름을 지원하는 경우 Operator는 이 목록에 여러 항목을 작성할 수 있습니다.

defaultHostname

string

defaultHostName은 사용자 지정 전에 이 경로의 호스트 이름입니다.

name

string

name은 사용자 지정할 경로의 논리 이름입니다. 경로 리소스의 실제 이름일 필요는 없지만 이름을 변경할 수 없습니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 spec.componentRoutes 목록의 해당 항목과 일치해야 합니다.

네임스페이스

string

네임스페이스는 사용자 지정할 경로의 네임스페이스입니다. 실제 네임스페이스여야 합니다. 실제 네임스페이스를 사용하면 두 구성 요소가 충돌하지 않으며 동일한 구성 요소를 여러 번 설치할 수 있습니다. 이 componentRoute의 네임스페이스 및 이름은 경로를 사용자 지정할 경우 spec.componentRoutes 목록의 해당 항목과 일치해야 합니다.

relatedObjects

array

relatedObjects는 spec.componentRoutes가 적용되는 방법을 디버깅하거나 검사할 때 유용한 리소스 목록입니다.

relatedObjects[]

object

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

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

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

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.

16.1.19. .status.componentRoutes[].relatedObjects

설명
relatedObjects는 spec.componentRoutes가 적용되는 방법을 디버깅하거나 검사할 때 유용한 리소스 목록입니다.
유형
array

16.1.20. .status.componentRoutes[].relatedObjects[]

설명
ObjectReference에는 참조된 오브젝트를 검사하거나 수정할 수 있는 충분한 정보가 포함되어 있습니다.
유형
object
필수 항목
  • group
  • name
  • resource
속성유형설명

group

string

추천자 그룹입니다.

name

string

추천자의 이름입니다.

네임스페이스

string

참조의 네임스페이스입니다.

resource

string

참조 항목의 리소스입니다.

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 컬렉션 삭제
표 16.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
Ingress 유형의 오브젝트 나열
표 16.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

IngressList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

Ingress 스키마

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

202 - 승인됨

Ingress 스키마

401 - 무단

16.2.2. /apis/config.openshift.io/v1/ingresses/{name}

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

name

string

Ingress의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

Ingress 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

Ingress 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

Ingress 스키마

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

401 - 무단

16.2.3. /apis/config.openshift.io/v1/ingresses/{name}/status

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

name

string

Ingress의 이름

HTTP 방법
GET
설명
지정된 Ingress의 읽기 상태
표 16.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

Ingress 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 Ingress의 부분적으로 업데이트 상태
표 16.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

Ingress 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 Ingress의 상태 교체
표 16.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

Ingress 스키마

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

200 - OK

Ingress 스키마

201 - 생성됨

Ingress 스키마

401 - 무단

17장. Network [config.openshift.io/v1]

설명
네트워크에는 네트워크에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은 cluster 입니다. 서비스/Pod IP의 IP 주소 풀, 네트워크 플러그인 등 원하는 네트워크 구성을 구성하는 데 사용됩니다. 이 리소스를 구성할 때 적용되는 사항에 대한 설명은 network.spec을 참조하십시오. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

17.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능한 값이 있습니다. 일반적으로 이 내용은 직접 읽지 않습니다. 대신 현재 배포된 구성을 나타내는 NetworkStatus를 사용해야 합니다. 현재 대부분의 spec 필드는 설치 후 변경할 수 없습니다. 각각에 대한 자세한 내용은 개별 항목을 참조하십시오.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

17.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능한 값이 있습니다. 일반적으로 이 내용은 직접 읽지 않습니다. 대신 현재 배포된 구성을 나타내는 NetworkStatus를 사용해야 합니다. 현재 대부분의 spec 필드는 설치 후 변경할 수 없습니다. 각각에 대한 자세한 내용은 개별 항목을 참조하십시오.
유형
object
속성유형설명

clusterNetwork

array

Pod IP에 사용할 IP 주소 풀입니다. 설치 후 이 필드는 변경할 수 없습니다.

clusterNetwork[]

object

ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다.

externalIP

object

ExternalIP는 Service.ExternalIP에 영향을 주는 컨트롤러에 대한 구성을 정의합니다. nil인 경우 ExternalIP를 설정할 수 없습니다.

networkDiagnostics

object

NetworkDiagnostics는 네트워크 진단 구성을 정의합니다. network.operator.openshift.io에서 spec.disableNetworkDiagnostics보다 우선합니다. networkDiagnostics를 지정하지 않거나 비어 있고 network.operator.openshift.io의 spec.disableNetworkDiagnostics 플래그가 true로 설정된 경우 네트워크 진단 기능이 비활성화됩니다.

networkType

string

networkType은 배포할 플러그인입니다(예: OVNKubernetes). 이는 cluster-network-operator가 이해할 수 있는 값과 일치해야 하며 그렇지 않으면 네트워킹이 설치되지 않습니다. 현재 지원되는 값은 - OVNKubernetes 이 필드는 설치 후 변경할 수 없습니다.

serviceNetwork

배열(문자열)

서비스를 위한 IP 주소 풀입니다. 현재는 단일 항목만 지원합니다. 설치 후 이 필드는 변경할 수 없습니다.

serviceNodePortRange

string

NodePort 유형의 서비스에 허용되는 포트 범위입니다. 지정하지 않으면 기본값 30000-32767이 사용됩니다. NodePort를 지정하지 않은 이러한 서비스는 이 범위에서 자동으로 할당됩니다. 이 매개변수는 클러스터를 설치한 후 업데이트할 수 있습니다.

17.1.2. .spec.clusterNetwork

설명
Pod IP에 사용할 IP 주소 풀입니다. 설치 후 이 필드는 변경할 수 없습니다.
유형
array

17.1.3. .spec.clusterNetwork[]

설명
ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다.
유형
object
속성유형설명

cidr

string

Pod IP의 전체 블록입니다.

hostPrefix

integer

각 노드에 할당할 블록의 크기(접두사)입니다. 이 필드를 플러그인에서 사용하지 않으면 설정되지 않은 상태로 둘 수 있습니다.

17.1.4. .spec.externalIP

설명
ExternalIP는 Service.ExternalIP에 영향을 주는 컨트롤러에 대한 구성을 정의합니다. nil인 경우 ExternalIP를 설정할 수 없습니다.
유형
object
속성유형설명

autoAssignCIDRs

배열(문자열)

autoAssignCIDRs는 Service.ExternalIP를 자동으로 할당할 CIDR 목록입니다. 서비스가 LoadBalancer 유형의 경우 할당됩니다. 일반적으로 이는 베어 메탈 클러스터에만 유용합니다. Openshift 3.x에서는 이를 "IngressIPs"라고 잘못 칭했습니다. 자동으로 할당된 외부 IP는 ExternalIPPolicy 규칙의 영향을 받지 않습니다. 현재는 하나의 항목만 제공될 수 있습니다.

policy

object

policy는 ExternalIP 필드에 적용되는 제한 세트입니다. nil 또는 empty인 경우 ExternalIP를 설정할 수 없습니다.

17.1.5. .spec.externalIP.policy

설명
policy는 ExternalIP 필드에 적용되는 제한 세트입니다. nil 또는 empty인 경우 ExternalIP를 설정할 수 없습니다.
유형
object
속성유형설명

allowedCIDRs

배열(문자열)

allowedCIDRs는 허용된 CIDR 목록입니다.

rejectedCIDRs

배열(문자열)

rejectedCIDRs는 허용되지 않은 CIDR 목록입니다. 이는 allowedCIDR보다 우선합니다.

17.1.6. .spec.networkDiagnostics

설명
NetworkDiagnostics는 네트워크 진단 구성을 정의합니다. network.operator.openshift.io에서 spec.disableNetworkDiagnostics보다 우선합니다. networkDiagnostics를 지정하지 않거나 비어 있고 network.operator.openshift.io의 spec.disableNetworkDiagnostics 플래그가 true로 설정된 경우 네트워크 진단 기능이 비활성화됩니다.
유형
object
속성유형설명

mode

string

모드는 네트워크 진단 모드를 생략하면 사용자에게 의견이 없으며 플랫폼이 적절한 기본값을 선택할 수 있음을 의미합니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 all입니다.

sourcePlacement

object

sourcePlacement는 네트워크 진단 소스 배포의 스케줄링을 제어합니다. 자세한 내용은 NetworkDiagnosticsSourcePlacement를 참조하십시오.

targetPlacement

object

targetPlacement는 네트워크 진단 대상 데몬 세트의 스케줄링을 제어합니다. See NetworkDiagnosticsTargetPlacement for more details about default values.

17.1.7. .spec.networkDiagnostics.sourcePlacement

설명
sourcePlacement는 네트워크 진단 소스 배포의 스케줄링을 제어합니다. 자세한 내용은 NetworkDiagnosticsSourcePlacement를 참조하십시오.
유형
object
속성유형설명

nodeSelector

오브젝트(문자열)

nodeSelector는 네트워크 진단 구성 요소에 적용되는 노드 선택기입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 kubernetes.io/os: linux 입니다.

허용 오차

array

허용 오차는 네트워크 진단 구성 요소에 적용되는 허용 오차 목록입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 빈 목록입니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <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

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

17.1.10. .spec.networkDiagnostics.targetPlacement

설명
targetPlacement는 네트워크 진단 대상 데몬 세트의 스케줄링을 제어합니다. See NetworkDiagnosticsTargetPlacement for more details about default values.
유형
object
속성유형설명

nodeSelector

오브젝트(문자열)

nodeSelector는 네트워크 진단 구성 요소에 적용되는 노드 선택기입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 kubernetes.io/os: linux 입니다.

허용 오차

array

허용 오차는 네트워크 진단 구성 요소에 적용되는 허용 오차 목록입니다. 즉, 사용자가 의견이 없으며 플랫폼은 합리적인 기본값을 선택할 수 있습니다. 이러한 기본값은 시간에 따라 변경될 수 있습니다. 현재 기본값은 operator: "Exists" 입니다. 즉, 모든 테인트가 허용됩니다.

tolerations[]

object

이 허용 오차는 일치하는 연산자 <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

string

effect는 일치시킬 테인트 효과를 나타냅니다. 비어있는 것은 모든 테인트 효과와 일치함을 의미합니다. 지정된 경우 허용되는 값은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

키는 허용 오차가 적용되는 taint 키입니다. 비어있는 것은 모든 taint 키와 일치함을 의미합니다. 키가 비어 있으면 연산자가 Exists여야 합니다. 이 조합은 모든 값과 모든 키와 일치하는 것을 의미합니다.

operator

string

Operator는 값에 대한 키의 관계를 나타냅니다. 유효한 연산자는 Exists 및 Equal입니다. 기본값은 Equal입니다. exists는 값에 대한 와일드카드와 동일하므로 Pod에서 특정 카테고리의 모든 테인트를 허용할 수 있습니다.

tolerationSeconds

integer

tolerationSeconds는 허용 오차(영향이 NoExecute여야 하며, 그렇지 않으면 이 필드가 무시됨) 테인트를 허용하는 기간을 나타냅니다. 기본적으로 설정되어 있지 않습니다. 즉, 테인트를 영구적으로 허용합니다(제거되지 않음). 0 및 음수 값은 시스템에서 0( 즉시 제거)으로 처리됩니다.

value

string

값은 허용 오차와 일치하는 taint 값입니다. 연산자가 Exists인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

17.1.13. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

clusterNetwork

array

Pod IP에 사용할 IP 주소 풀입니다.

clusterNetwork[]

object

ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다.

clusterNetworkMTU

integer

ClusterNetworkMTU는 Pod 간 네트워킹을 위한 MTU입니다.

conditions

array

조건은 network.config 현재 상태를 관찰하는 것을 나타냅니다. 알려진 .status.conditions.type은 "NetworkDiagnosticsAvailable"입니다.

conditions[]

object

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" // 기타 필드 }

Migration

object

마이그레이션에는 클러스터 네트워크 마이그레이션 구성이 포함되어 있습니다.

networkType

string

networkType은 배포된 플러그인(예: OVNKubernetes)입니다.

serviceNetwork

배열(문자열)

서비스를 위한 IP 주소 풀입니다. 현재는 단일 항목만 지원합니다.

17.1.14. .status.clusterNetwork

설명
Pod IP에 사용할 IP 주소 풀입니다.
유형
array

17.1.15. .status.clusterNetwork[]

설명
ClusterNetworkEntry는 Pod IP가 할당되는 연속적인 IP 주소 블록입니다.
유형
object
속성유형설명

cidr

string

Pod IP의 전체 블록입니다.

hostPrefix

integer

각 노드에 할당할 블록의 크기(접두사)입니다. 이 필드를 플러그인에서 사용하지 않으면 설정되지 않은 상태로 둘 수 있습니다.

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

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

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

type

string

CamelCase 또는 foo.example.com/CamelCase의 조건 유형. --- many .condition.type 값은 Available와 같은 리소스 간에 일관되지만 임의의 조건이 유용할 수 있으므로 (.node.status.conditions 참조), deconflict 기능이 중요합니다. 정규 표현식이 일치하는 정규 표현식은 (dns1123SubdomainFmt/)?(qualifiedNameFmt)입니다.

17.1.18. .status.migration

설명
마이그레이션에는 클러스터 네트워크 마이그레이션 구성이 포함되어 있습니다.
유형
object
속성유형설명

mtu

object

MTU는 배포 중인 MTU 구성입니다.

networkType

string

networkType은 배포 중인 대상 플러그인입니다. DEPRECATED: 네트워크 유형 마이그레이션은 더 이상 지원되지 않으므로 이 마이그레이션은 항상 설정되지 않아야 합니다.

17.1.19. .status.migration.mtu

설명
MTU는 배포 중인 MTU 구성입니다.
유형
object
속성유형설명

머신

object

머신에는 머신의 uplink에 대한 MTU 마이그레이션 구성이 포함되어 있습니다.

network

object

네트워크에는 기본 네트워크의 MTU 마이그레이션 구성이 포함되어 있습니다.

17.1.20. .status.migration.mtu.machine

설명
머신에는 머신의 uplink에 대한 MTU 마이그레이션 구성이 포함되어 있습니다.
유형
object
속성유형설명

from

integer

에서 마이그레이션할 MTU입니다.

다음으로 변경

integer

마이그레이션할 MTU입니다.

17.1.21. .status.migration.mtu.network

설명
네트워크에는 기본 네트워크의 MTU 마이그레이션 구성이 포함되어 있습니다.
유형
object
속성유형설명

from

integer

에서 마이그레이션할 MTU입니다.

다음으로 변경

integer

마이그레이션할 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
설명
네트워크 컬렉션 삭제
표 17.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
네트워크 유형의 오브젝트 나열
표 17.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

NetworkList 스키마

401 - 무단

HTTP 방법
POST
설명
네트워크 생성
표 17.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

네트워크 스키마

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

200 - OK

네트워크 스키마

201 - 생성됨

네트워크 스키마

202 - 승인됨

네트워크 스키마

401 - 무단

17.2.2. /apis/config.openshift.io/v1/networks/{name}

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

name

string

네트워크 이름

HTTP 방법
DELETE
설명
네트워크 삭제
표 17.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 네트워크 읽기
표 17.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

네트워크 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

네트워크 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 네트워크를 교체
표 17.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

네트워크 스키마

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

200 - OK

네트워크 스키마

201 - 생성됨

네트워크 스키마

401 - 무단

18장. Node [config.openshift.io/v1]

설명
노드에는 노드별 기능에 대한 클러스터 전체 정보가 있습니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

18.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 관찰된 값이 포함되어 있습니다.

18.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

cgroupMode

string

CgroupMode에서 노드의 cgroups 버전을 결정합니다.

workerLatencyProfile

string

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
설명
노드 컬렉션 삭제
표 18.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 노드 나열
표 18.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

NodeList 스키마

401 - 무단

HTTP 방법
POST
설명
노드 생성
표 18.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

노드 스키마

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

200 - OK

노드 스키마

201 - 생성됨

노드 스키마

202 - 승인됨

노드 스키마

401 - 무단

18.2.2. /apis/config.openshift.io/v1/nodes/{name}

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

name

string

노드 이름

HTTP 방법
DELETE
설명
노드 삭제
표 18.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

노드 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

노드 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 노드 교체
표 18.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

노드 스키마

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

200 - OK

노드 스키마

201 - 생성됨

노드 스키마

401 - 무단

18.2.3. /apis/config.openshift.io/v1/nodes/{name}/status

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

name

string

노드 이름

HTTP 방법
GET
설명
지정된 노드의 읽기 상태
표 18.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

노드 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

노드 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 노드의 상태 교체
표 18.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

노드 스키마

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

200 - OK

노드 스키마

201 - 생성됨

노드 스키마

401 - 무단

19장. OAuth [config.openshift.io/v1]

설명
OAuth에 대한 클러스터 전체 정보가 있습니다. 표준 이름은 cluster 입니다. 통합 OAuth 서버를 구성하는 데 사용됩니다. 이 구성은 최상위 인증 구성의 유형이 IntegratedOAuth로 설정된 경우에만 적용됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

19.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

19.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

identityProviders

array

identityProviders는 사용자가 자신을 식별할 수 있는 정렬된 방법 목록입니다. 이 목록이 비어 있으면 사용자에 대한 ID가 프로비저닝되지 않습니다.

identityProviders[]

object

IdentityProvider는 인증 정보를 사용하여 인증할 수 있는 ID를 제공합니다.

templates

object

템플릿을 사용하면 로그인 페이지와 같은 페이지를 사용자 지정할 수 있습니다.

tokenConfig

object

tokenConfig에는 권한 부여 및 액세스 토큰 옵션이 포함되어 있습니다.

19.1.2. .spec.identityProviders

설명
identityProviders는 사용자가 자신을 식별할 수 있는 정렬된 방법 목록입니다. 이 목록이 비어 있으면 사용자에 대한 ID가 프로비저닝되지 않습니다.
유형
array

19.1.3. .spec.identityProviders[]

설명
IdentityProvider는 인증 정보를 사용하여 인증할 수 있는 ID를 제공합니다.
유형
object
속성유형설명

basicAuth

object

basicauth에는 BasicAuth IdP에 대한 구성 옵션이 포함되어 있습니다.

github

object

GitHub에서 GitHub 자격 증명을 사용하여 사용자 인증 가능

gitlab

object

GitLab에서 GitLab 인증 정보를 사용하여 사용자 인증 가능

google

object

Google에서 Google 인증 정보를 사용하여 사용자 인증 가능

htpasswd

object

htpasswd를 사용하면 HTPasswd 파일을 사용하여 사용자 인증을 통해 인증 정보를 검증할 수 있습니다.

Keystone

object

Keystone에서 keystone 암호 자격 증명을 사용하여 사용자 인증 가능

ldap

object

LDAP에서 LDAP 인증 정보를 사용하여 사용자 인증 가능

mappingMethod

string

mappingMethod는 이 공급자의 ID가 사용자에게 매핑되는 방식을 결정합니다. 기본값은 "claim"입니다.

name

string

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

object

OpenID는 OpenID 인증 정보를 사용하여 사용자 인증 가능

requestHeader

object

requestHeader를 사용하면 요청 헤더 자격 증명을 사용한 사용자 인증 가능

type

string

type은 이 항목의 ID 공급자 유형을 식별합니다.

19.1.4. .spec.identityProviders[].basicAuth

설명
basicauth에는 BasicAuth IdP에 대한 구성 옵션이 포함되어 있습니다.
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

tlsClientCert

object

tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

tlsClientKey

object

tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

url

string

URL은 연결할 원격 URL입니다.

19.1.5. .spec.identityProviders[].basicAuth.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.6. .spec.identityProviders[].basicAuth.tlsClientCert

설명
tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.7. .spec.identityProviders[].basicAuth.tlsClientKey

설명
tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.8. .spec.identityProviders[].github

설명
GitHub에서 GitHub 자격 증명을 사용하여 사용자 인증 가능
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이는 hostname이 비어 있지 않은 값으로 설정된 경우에만 구성할 수 있습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

clientID

string

clientID는 oauth 클라이언트 ID입니다.

clientSecret

object

clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

hostname

string

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

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.10. .spec.identityProviders[].github.clientSecret

설명
clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.11. .spec.identityProviders[].gitlab

설명
GitLab에서 GitLab 인증 정보를 사용하여 사용자 인증 가능
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

clientID

string

clientID는 oauth 클라이언트 ID입니다.

clientSecret

object

clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

url

string

URL은 oauth 서버 기본 URL입니다.

19.1.12. .spec.identityProviders[].gitlab.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.13. .spec.identityProviders[].gitlab.clientSecret

설명
clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.14. .spec.identityProviders[].google

설명
Google에서 Google 인증 정보를 사용하여 사용자 인증 가능
유형
object
속성유형설명

clientID

string

clientID는 oauth 클라이언트 ID입니다.

clientSecret

object

clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

hostedDomain

string

hostedDomain은 로그인을 제한하는 선택적 Google 앱 도메인(예: "mycompany.com")입니다.

19.1.15. .spec.identityProviders[].google.clientSecret

설명
clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.16. .spec.identityProviders[].htpasswd

설명
htpasswd를 사용하면 HTPasswd 파일을 사용하여 사용자 인증을 통해 인증 정보를 검증할 수 있습니다.
유형
object
속성유형설명

fileData

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

string

name은 참조된 보안의 metadata.name입니다.

19.1.18. .spec.identityProviders[].keystone

설명
Keystone에서 keystone 암호 자격 증명을 사용하여 사용자 인증 가능
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

domainName

string

keystone v3에는 domainname이 필요합니다.

tlsClientCert

object

tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

tlsClientKey

object

tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

url

string

URL은 연결할 원격 URL입니다.

19.1.19. .spec.identityProviders[].keystone.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.20. .spec.identityProviders[].keystone.tlsClientCert

설명
tlsClientCert는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.21. .spec.identityProviders[].keystone.tlsClientKey

설명
tlsClientKey는 tlsClientCert에서 참조하는 클라이언트 인증서에 대한 PEM 인코딩 TLS 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.key" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 인증서 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.22. .spec.identityProviders[].ldap

설명
LDAP에서 LDAP 인증 정보를 사용하여 사용자 인증 가능
유형
object
속성유형설명

속성

object

속성은 LDAP 속성을 ID에 매핑

bindDN

string

bindDN은 검색 단계에서 바인딩할 선택적 DN입니다.

bindPassword

object

bindPassword는 검색 단계에서 바인딩할 암호가 포함된 이름별 보안에 대한 선택적 참조입니다. "bindPassword" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

insecure

boolean

비보안( true 인 경우)은 연결이 TLS WARNING를 사용하지 않아야 함을 나타냅니다. URL 스키마 "ldaps://" URL을 "ldaps://" URL을 "ldaps://" URL로 설정하면 안전하지 않은 경우 insecure true 로 설정된 경우에도 "ldap://" URL이 안전하지 않게 연결됩니다. false 인 경우 "ldap://" URL은 https://tools.ietf.org/html/rfc2830 에 지정된 StartTLS를 사용하여 TLS 연결로 업그레이드됩니다.

url

string

URL은 사용할 LDAP 검색 매개변수를 지정하는 RFC 2255 URL입니다. URL 구문은 ldap://host:port/basedn?attribute?scope?filter입니다.

19.1.23. .spec.identityProviders[].ldap.attributes

설명
속성은 LDAP 속성을 ID에 매핑
유형
object
속성유형설명

email

배열(문자열)

email은 값을 이메일 주소로 사용해야 하는 속성 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID에 대한 이메일이 설정되어 있지 않습니다.

id

배열(문자열)

ID는 값을 사용자 ID로 사용해야 하는 속성 목록입니다. 필수 항목입니다. 비어 있지 않은 첫 번째 속성이 사용됩니다. 하나 이상의 속성이 필요합니다. 나열된 어떤 속성에도 값이 없는 경우 인증이 실패합니다. LDAP 표준 ID 속성은 "dn"입니다.

name

배열(문자열)

name은 표시 이름으로 값을 사용해야 하는 속성 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID LDAP 표준 표시 이름 속성에 대해 표시 이름이 "cn"으로 설정되어 있지 않습니다.

preferredUsername

배열(문자열)

PreferredUsername은 기본 사용자 이름으로 값을 사용해야 하는 속성 목록입니다. LDAP 표준 로그인 속성은 "uid"입니다.

19.1.24. .spec.identityProviders[].ldap.bindPassword

설명
bindPassword는 검색 단계에서 바인딩할 암호가 포함된 이름별 보안에 대한 선택적 참조입니다. "bindPassword" 키는 데이터를 찾는 데 사용됩니다. 지정된 및 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.25. .spec.identityProviders[].ldap.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.26. .spec.identityProviders[].openID

설명
OpenID는 OpenID 인증 정보를 사용하여 사용자 인증 가능
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 지정되고 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

클레임

object

클레임 매핑

clientID

string

clientID는 oauth 클라이언트 ID입니다.

clientSecret

object

clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

extraAuthorizeParameters

오브젝트(문자열)

extraAuthorizeParameters는 권한 부여 요청에 추가할 사용자 지정 매개변수입니다.

extraScopes

배열(문자열)

extraScopes는 표준 "openid" 범위 외에 요청할 모든 범위입니다.

issuer

string

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

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.28. .spec.identityProviders[].openID.claims

설명
클레임 매핑
유형
object
속성유형설명

email

배열(문자열)

email은 해당 값을 이메일 주소로 사용해야 하는 클레임 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID에 대한 이메일이 설정되어 있지 않습니다.

groups

배열(문자열)

그룹은 OIDC 공급자의 그룹을 사용자의 OpenShift와 동기화하는 데 사용해야 하는 클레임 값 목록입니다. 여러 클레임이 지정되는 경우 비어 있지 않은 값이 있는 첫 번째 클레임이 사용됩니다.

name

배열(문자열)

name은 표시 이름으로 값을 사용해야 하는 클레임 목록입니다. 선택 사항입니다. 지정되지 않은 경우 ID에 대한 표시 이름이 설정되어 있지 않습니다.

preferredUsername

배열(문자열)

PreferredUsername은 기본 사용자 이름으로 값을 사용해야 하는 클레임 목록입니다. 지정되지 않은 경우 기본 사용자 이름은 하위 클레임의 값에서 결정됩니다.

19.1.29. .spec.identityProviders[].openID.clientSecret

설명
clientSecret은 oauth 클라이언트 시크릿을 포함하는 이름별로 보안에 필요한 참조입니다. "clientSecret" 키는 데이터를 찾는 데 사용됩니다. 시크릿 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.30. .spec.identityProviders[].requestHeader

설명
requestHeader를 사용하면 요청 헤더 자격 증명을 사용한 사용자 인증 가능
유형
object
속성유형설명

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별로 구성 맵에 대한 필수 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. 특히, 헤더 스푸핑을 방지하기 위해 들어오는 요청을 확인할 수 있습니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.

challengeURL

string

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

배열(문자열)

clientCommonNames는 일치하는 항목이 필요한 일반 이름의 선택적 목록입니다. 비어 있는 경우 clientCA 번들에 대해 검증된 모든 클라이언트 인증서가 권한 있는 것으로 간주됩니다.

emailHeaders

배열(문자열)

emailHeaders는 이메일 주소를 확인할 헤더 세트입니다.

headers

배열(문자열)

헤더는 ID 정보를 확인할 헤더 세트입니다.

loginURL

string

loginURL은 대화형 로그인이 예상되는 OAuth 클라이언트의 인증되지 않은 /승인 요청을 리디렉션하는 URL입니다. 여기서 ${url}은 현재 URL로 교체되고, 로그인이 true로 설정된 경우 쿼리 매개변수 https://www.example.com/sso-login?then=${url} ${ query} 에서 안전하도록 이스케이프됩니다.

nameHeaders

배열(문자열)

nameHeaders는 표시 이름을 확인할 헤더 세트입니다.

preferredUsernameHeaders

배열(문자열)

preferredUsernameHeaders는 기본 사용자 이름을 확인할 헤더 세트입니다.

19.1.31. .spec.identityProviders[].requestHeader.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별로 구성 맵에 대한 필수 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. 특히, 헤더 스푸핑을 방지하기 위해 들어오는 요청을 확인할 수 있습니다. "ca.crt" 키는 데이터를 찾는 데 사용됩니다. 구성 맵 또는 예상 키를 찾을 수 없는 경우 ID 공급자가 적용되지 않습니다. 지정된 ca 데이터가 유효하지 않으면 ID 공급자가 적용되지 않습니다. 이 구성 맵의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

19.1.32. .spec.templates

설명
템플릿을 사용하면 로그인 페이지와 같은 페이지를 사용자 지정할 수 있습니다.
유형
object
속성유형설명

error

object

오류는 인증 또는 권한 부여 흐름 중에 오류 페이지를 렌더링하는 데 사용할 go 템플릿을 지정하는 보안의 이름입니다. "errors.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 오류 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 오류 페이지가 사용됩니다. 지정하지 않으면 기본 오류 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

login

object

login은 로그인 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "login.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 로그인 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 로그인 페이지가 사용됩니다. 지정되지 않은 경우 기본 로그인 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

providerSelection

object

providerSelection은 공급자 선택 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "providers.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정되고 시크릿 또는 예상 키가 없는 경우 기본 공급자 선택 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 공급자 선택 페이지가 사용됩니다. 지정되지 않은 경우 기본 공급자 선택 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.

19.1.33. .spec.templates.error

설명
오류는 인증 또는 권한 부여 흐름 중에 오류 페이지를 렌더링하는 데 사용할 go 템플릿을 지정하는 보안의 이름입니다. "errors.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 오류 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 오류 페이지가 사용됩니다. 지정하지 않으면 기본 오류 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.34. .spec.templates.login

설명
login은 로그인 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "login.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정된 경우 시크릿 또는 예상 키를 찾을 수 없는 경우 기본 로그인 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 로그인 페이지가 사용됩니다. 지정되지 않은 경우 기본 로그인 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.35. .spec.templates.providerSelection

설명
providerSelection은 공급자 선택 페이지를 렌더링하는 데 사용할 이동 템플릿을 지정하는 시크릿의 이름입니다. "providers.html" 키는 템플릿 데이터를 찾는 데 사용됩니다. 지정되고 시크릿 또는 예상 키가 없는 경우 기본 공급자 선택 페이지가 사용됩니다. 지정된 템플릿이 유효하지 않으면 기본 공급자 선택 페이지가 사용됩니다. 지정되지 않은 경우 기본 공급자 선택 페이지가 사용됩니다. 이 시크릿의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

19.1.36. .spec.tokenConfig

설명
tokenConfig에는 권한 부여 및 액세스 토큰 옵션이 포함되어 있습니다.
유형
object
속성유형설명

accessTokenInactivityTimeout

string

accessTokenInactivityTimeout은 클라이언트에서 부여하는 토큰에 대한 토큰 비활성 타임아웃을 정의합니다. 값은 토큰의 연속 사용 간에 발생할 수 있는 최대 시간을 나타냅니다. 이 시간 창에서 사용되지 않으면 토큰이 유효하지 않습니다. 사용자는 토큰이 시간 초과되면 액세스 권한을 얻기 위해 새 토큰을 취득해야 합니다. "5m", "1.5h" 또는 "2h45m"과 같은 유효한 시간 문자열을 사용합니다. 기간 동안 허용되는 최소 값은 300s(5분)입니다. 시간 초과가 클라이언트별로 구성된 경우 해당 값이 우선합니다. 시간 초과 값을 지정하지 않고 클라이언트가 값을 재정의하지 않으면 수명이 될 때까지 토큰이 유효합니다. 경고: 이 값을 변경하여 기존 토큰의 시간 초과는 영향을 받지 않습니다(낮음)

accessTokenInactivityTimeoutSeconds

integer

accessTokenInactivityTimeoutSeconds - DEPRECATED: 이 필드를 설정해도 적용되지 않습니다.

accessTokenMaxAgeSeconds

integer

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 컬렉션 삭제
표 19.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
OAuth 유형의 오브젝트 나열
표 19.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OAuthList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

OAuth 스키마

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

200 - OK

OAuth 스키마

201 - 생성됨

OAuth 스키마

202 - 승인됨

OAuth 스키마

401 - 무단

19.2.2. /apis/config.openshift.io/v1/oauths/{name}

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

name

string

OAuth 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

OAuth 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

OAuth 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

OAuth 스키마

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

200 - OK

OAuth 스키마

201 - 생성됨

OAuth 스키마

401 - 무단

19.2.3. /apis/config.openshift.io/v1/oauths/{name}/status

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

name

string

OAuth 이름

HTTP 방법
GET
설명
지정된 OAuth의 읽기 상태
표 19.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OAuth 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 OAuth의 부분적으로 업데이트 상태
표 19.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

OAuth 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 OAuth의 상태 교체
표 19.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

OAuth 스키마

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

200 - OK

OAuth 스키마

201 - 생성됨

OAuth 스키마

401 - 무단

20장. OperatorHub [config.openshift.io/v1]

설명
OperatorHub는 operatorhubs API의 스키마입니다. 클러스터의 OperatorHub의 기본 허브 소스의 상태를 enabled에서 disabled로 변경하고 그 반대의 경우도 마찬가지입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object

20.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

OperatorHubSpec은 원하는 OperatorHub 상태를 정의합니다.

status

object

OperatorHubStatus는 OperatorHub의 관찰 상태를 정의합니다. 기본 허브 소스의 현재 상태는 항상 여기에 반영됩니다.

20.1.1. .spec

설명
OperatorHubSpec은 원하는 OperatorHub 상태를 정의합니다.
유형
object
속성유형설명

disableAllDefaultSources

boolean

disableAllDefaultSources를 사용하면 기본 허브 소스를 모두 비활성화할 수 있습니다. true인 경우 소스의 특정 항목을 사용하여 기본 소스를 활성화할 수 있습니다. false인 경우 소스의 특정 항목을 사용하여 기본 소스를 비활성화하거나 활성화할 수 있습니다.

소스

array

소스는 기본 허브 소스 목록과 해당 구성입니다. 목록이 비어 있으면 disableAllDefaultSources가 true인 경우를 제외하고 클러스터에서 기본 허브 소스가 활성화되어 있음을 나타냅니다. disableAllDefaultSources가 true이고 소스가 비어 있지 않은 경우 소스에 있는 구성이 우선합니다. 기본 허브 소스 목록과 해당 현재 상태는 항상 status 블록에 반영됩니다.

sources[]

object

HubSource는 허브 소스 및 해당 구성을 지정하는 데 사용됩니다.

20.1.2. .spec.sources

설명
소스는 기본 허브 소스 목록과 해당 구성입니다. 목록이 비어 있으면 disableAllDefaultSources가 true인 경우를 제외하고 클러스터에서 기본 허브 소스가 활성화되어 있음을 나타냅니다. disableAllDefaultSources가 true이고 소스가 비어 있지 않은 경우 소스에 있는 구성이 우선합니다. 기본 허브 소스 목록과 해당 현재 상태는 항상 status 블록에 반영됩니다.
유형
array

20.1.3. .spec.sources[]

설명
HubSource는 허브 소스 및 해당 구성을 지정하는 데 사용됩니다.
유형
object
속성유형설명

비활성화됨

boolean

비활성화는 클러스터에서 기본 허브 소스를 비활성화하는 데 사용됩니다.

name

string

name은 기본 허브 소스 중 하나의 이름입니다.

20.1.4. .status

설명
OperatorHubStatus는 OperatorHub의 관찰 상태를 정의합니다. 기본 허브 소스의 현재 상태는 항상 여기에 반영됩니다.
유형
object
속성유형설명

소스

array

소스는 각 허브 소스에 대한 구성 적용 결과를 캡슐화합니다.

sources[]

object

HubSourceStatus는 기본 소스에 구성을 적용하는 현재 상태를 반영하는 데 사용됩니다.

20.1.5. .status.sources

설명
소스는 각 허브 소스에 대한 구성 적용 결과를 캡슐화합니다.
유형
array

20.1.6. .status.sources[]

설명
HubSourceStatus는 기본 소스에 구성을 적용하는 현재 상태를 반영하는 데 사용됩니다.
유형
object
속성유형설명

비활성화됨

boolean

비활성화는 클러스터에서 기본 허브 소스를 비활성화하는 데 사용됩니다.

message

string

메시지에서 실패에 대한 자세한 정보를 제공합니다.

name

string

name은 기본 허브 소스 중 하나의 이름입니다.

status

string

상태는 구성 적용의 성공 또는 실패를 나타냅니다.

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 컬렉션 삭제
표 20.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류의 OperatorHub 오브젝트 나열
표 20.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorHubList 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

OperatorHub 스키마

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

200 - OK

OperatorHub 스키마

201 - 생성됨

OperatorHub 스키마

202 - 승인됨

OperatorHub 스키마

401 - 무단

20.2.2. /apis/config.openshift.io/v1/operatorhubs/{name}

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

name

string

OperatorHub의 이름

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

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

OperatorHub 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

OperatorHub 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

OperatorHub 스키마

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

200 - OK

OperatorHub 스키마

201 - 생성됨

OperatorHub 스키마

401 - 무단

20.2.3. /apis/config.openshift.io/v1/operatorhubs/{name}/status

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

name

string

OperatorHub의 이름

HTTP 방법
GET
설명
지정된 OperatorHub의 상태 읽기
표 20.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

OperatorHub 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 OperatorHub의 부분 업데이트 상태
표 20.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

OperatorHub 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 OperatorHub의 상태 교체
표 20.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

OperatorHub 스키마

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

200 - OK

OperatorHub 스키마

201 - 생성됨

OperatorHub 스키마

401 - 무단

21장. Project [config.openshift.io/v1]

설명
프로젝트에는 프로젝트에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

21.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

21.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

projectRequestMessage

string

projectRequestMessage는 projectrequest api 끝점을 통해 프로젝트를 요청할 수 없는 경우 사용자에게 제공되는 문자열입니다.

projectRequestTemplate

object

projectRequestTemplate은 projectrequest에 대한 응답으로 프로젝트를 생성하는 데 사용할 템플릿입니다. 'openshift-config' 네임스페이스에서 템플릿을 가리켜야 합니다. 이는 선택 사항입니다. 지정하지 않으면 기본 템플릿이 사용됩니다.

21.1.2. .spec.projectRequestTemplate

설명
projectRequestTemplate은 projectrequest에 대한 응답으로 프로젝트를 생성하는 데 사용할 템플릿입니다. 'openshift-config' 네임스페이스에서 템플릿을 가리켜야 합니다. 이는 선택 사항입니다. 지정하지 않으면 기본 템플릿이 사용됩니다.
유형
object
속성유형설명

name

string

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
설명
프로젝트의 컬렉션 삭제
표 21.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
kind Project의 오브젝트 나열
표 21.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ProjectList 스키마

401 - 무단

HTTP 방법
POST
설명
프로젝트 생성
표 21.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

프로젝트 스키마

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

200 - OK

프로젝트 스키마

201 - 생성됨

프로젝트 스키마

202 - 승인됨

프로젝트 스키마

401 - 무단

21.2.2. /apis/config.openshift.io/v1/projects/{name}

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

name

string

프로젝트 이름

HTTP 방법
DELETE
설명
프로젝트 삭제
표 21.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 프로젝트 읽기
표 21.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

프로젝트 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

프로젝트 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 프로젝트를 교체
표 21.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

프로젝트 스키마

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

200 - OK

프로젝트 스키마

201 - 생성됨

프로젝트 스키마

401 - 무단

21.2.3. /apis/config.openshift.io/v1/projects/{name}/status

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

name

string

프로젝트 이름

HTTP 방법
GET
설명
지정된 프로젝트의 상태 보기
표 21.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

프로젝트 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 프로젝트의 부분 업데이트 상태
표 21.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

프로젝트 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 프로젝트의 상태 교체
표 21.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

프로젝트 스키마

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

200 - OK

프로젝트 스키마

201 - 생성됨

프로젝트 스키마

401 - 무단

22장. ProjectHelmChartRepository [helm.openshift.io/v1beta1]

설명
ProjectHelmChartRepository는 프록시된 Helm 차트 리포지터리 호환성 수준 2에 대한 네임스페이스 전체 구성을 보유하고 있습니다. 최소 9개월 또는 3개의 마이너 릴리스(더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

22.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

네임스페이스 내에서 리포지토리의 상태를 확인합니다.

22.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

connectionConfig

object

차트 리포지터리 연결에 필요한 구성

description

string

사람이 읽을 수 있는 선택적 리포지토리 설명인 UI에서 용도를 표시하는 데 사용할 수 있습니다.

비활성화됨

boolean

true로 설정하면 네임스페이스에서 리포지토리 사용을 비활성화합니다.

name

string

사람이 읽을 수 있는 선택적 리포지토리 이름, UI에서 용도를 표시하는 데 사용할 수 있습니다.

22.1.2. .spec.connectionConfig

설명
차트 리포지터리 연결에 필요한 구성
유형
object
속성유형설명

basicAuthConfig

object

basicAuthConfig는 서버에 연결할 때 존재하는 기본 인증 인증 정보가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "username" 키는 사용자 이름을 찾는 데 사용됩니다. "password" 키는 암호를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.

ca

object

CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.

tlsClientConfig

object

tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.

url

string

차트 리포지터리 URL

22.1.3. .spec.connectionConfig.basicAuthConfig

설명
basicAuthConfig는 서버에 연결할 때 존재하는 기본 인증 인증 정보가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "username" 키는 사용자 이름을 찾는 데 사용됩니다. "password" 키는 암호를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

22.1.4. .spec.connectionConfig.ca

설명
CA는 PEM 인코딩 CA 번들이 포함된 이름별 구성 맵에 대한 선택적 참조입니다. 원격 서버에서 제공하는 TLS 인증서의 유효성을 검사하는 신뢰 앵커로 사용됩니다. "ca-bundle.crt" 키는 데이터를 찾는 데 사용됩니다. 비어있는 경우 기본 시스템 루트가 사용됩니다. 이 구성 맵의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 구성 맵의 metadata.name입니다.

22.1.5. .spec.connectionConfig.tlsClientConfig

설명
tlsClientConfig는 서버에 연결할 때 제공할 PEM 인코딩 TLS 클라이언트 인증서 및 개인 키가 포함된 이름으로 시크릿에 대한 선택적 참조입니다. "tls.crt" 키는 클라이언트 인증서를 찾는 데 사용됩니다. "tls.key" 키는 개인 키를 찾는 데 사용됩니다. 이 시크릿의 네임스페이스는 프로젝트 helm 차트 리포지터리가 인스턴스화되는 네임스페이스와 동일해야 합니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

name은 참조된 보안의 metadata.name입니다.

22.1.6. .status

설명
네임스페이스 내에서 리포지토리의 상태를 확인합니다.
유형
object
속성유형설명

conditions

array

conditions는 조건 및 상태 목록입니다.

conditions[]

object

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" // 기타 필드 }

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

string

lastTransitionTime은 마지막으로 한 상태에서 다른 상태로 전환된 시간입니다. 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 API 필드가 변경된 시간을 사용합니다.

message

string

message는 변환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다. 빈 문자열일 수 있습니다.

observedGeneration

integer

observedGeneration은 조건에 따라 설정된 .metadata.generation을 나타냅니다. 예를 들어 .metadata.generation이 현재 12이지만 .status.conditions[x].observedGeneration이 9인 경우 현재 인스턴스 상태와 관련된 조건이 최신 상태가 아닙니다.

reason

string

이유에는 조건의 마지막 전환 이유를 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 예상되는 값과 의미를 정의할 수 있으며 값이 보장된 API로 간주되는지 여부를 정의할 수 있습니다. 값은 CamelCase 문자열이어야 합니다. 이 필드는 비어 있지 않을 수 있습니다.

status

string

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

type

string

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 유형의 오브젝트 나열
표 22.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ProjectHelmChartRepositoryList schema

401 - 무단

22.2.2. /apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories

HTTP 방법
DELETE
설명
ProjectHelmChartRepository 컬렉션 삭제
표 22.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
ProjectHelmChartRepository 유형의 오브젝트 나열
표 22.3. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ProjectHelmChartRepositoryList schema

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

body

ProjectHelmChartRepository 스키마

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

200 - OK

ProjectHelmChartRepository 스키마

201 - 생성됨

ProjectHelmChartRepository 스키마

202 - 승인됨

ProjectHelmChartRepository 스키마

401 - 무단

22.2.3. /apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories/{name}

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

name

string

ProjectHelmChartRepository의 이름

HTTP 방법
DELETE
설명
delete a ProjectHelmChartRepository
표 22.8. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

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

200 - OK

ProjectHelmChartRepository 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ProjectHelmChartRepository 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ProjectHelmChartRepository를 교체합니다.
표 22.13. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ProjectHelmChartRepository 스키마

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

200 - OK

ProjectHelmChartRepository 스키마

201 - 생성됨

ProjectHelmChartRepository 스키마

401 - 무단

22.2.4. /apis/helm.openshift.io/v1beta1/namespaces/{namespace}/projecthelmchartrepositories/{name}/status

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

name

string

ProjectHelmChartRepository의 이름

HTTP 방법
GET
설명
지정된 ProjectHelmChartRepository의 읽기 상태
표 22.17. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ProjectHelmChartRepository 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 ProjectHelmChartRepository의 부분적으로 업데이트 상태
표 22.18. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

ProjectHelmChartRepository 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 ProjectHelmChartRepository의 상태 교체
표 22.20. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

ProjectHelmChartRepository 스키마

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

200 - OK

ProjectHelmChartRepository 스키마

201 - 생성됨

ProjectHelmChartRepository 스키마

401 - 무단

23장. Proxy [config.openshift.io/v1]

설명
proxy에는 클러스터의 기본 프록시를 구성하는 방법에 대한 클러스터 전체 정보가 들어 있습니다. 표준 이름은 클러스터 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전)의 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

23.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 프록시 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

23.1.1. .spec

설명
spec에는 프록시 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

httpProxy

string

httpProxy는 HTTP 요청에 대한 프록시의 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

httpsProxy

string

httpsProxy는 HTTPS 요청의 프록시 URL입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

noProxy

string

noProxy는 프록시를 사용하지 않아야 하는 쉼표로 구분된 호스트 이름 및/또는 CIDR 및/또는 IP 목록입니다. 비어 있는 것은 설정되지 않으며 env var을 생성하지 않음을 의미합니다.

readinessEndpoints

배열(문자열)

readinessEndpoints는 프록시 준비 상태를 확인하는 데 사용되는 끝점 목록입니다.

trustedCA

object

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

string

name은 참조된 구성 맵의 metadata.name입니다.

23.1.3. .status

설명
status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.
유형
object
속성유형설명

httpProxy

string

httpProxy는 HTTP 요청에 대한 프록시의 URL입니다.

httpsProxy

string

httpsProxy는 HTTPS 요청의 프록시 URL입니다.

noProxy

string

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
설명
프록시 컬렉션 삭제
표 23.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
프록시 유형의 오브젝트 나열
표 23.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ProxyList 스키마

401 - 무단

HTTP 방법
POST
설명
프록시 생성
표 23.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

프록시 스키마

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

200 - OK

프록시 스키마

201 - 생성됨

프록시 스키마

202 - 승인됨

프록시 스키마

401 - 무단

23.2.2. /apis/config.openshift.io/v1/proxies/{name}

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

name

string

프록시의 이름

HTTP 방법
DELETE
설명
프록시 삭제
표 23.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 프록시 읽기
표 23.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

프록시 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

프록시 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 프록시 교체
표 23.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

프록시 스키마

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

200 - OK

프록시 스키마

201 - 생성됨

프록시 스키마

401 - 무단

23.2.3. /apis/config.openshift.io/v1/proxies/{name}/status

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

name

string

프록시의 이름

HTTP 방법
GET
설명
지정된 프록시의 읽기 상태
표 23.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

프록시 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 프록시의 부분적으로 업데이트
표 23.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

프록시 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 프록시의 상태 교체
표 23.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

프록시 스키마

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

200 - OK

프록시 스키마

201 - 생성됨

프록시 스키마

401 - 무단

24장. Scheduler [config.openshift.io/v1]

설명
스케줄러는 Kubernetes 스케줄러를 실행하고 배치 결정에 영향을 주기 위해 클러스터 전체 구성 정보를 보유합니다. 이 구성의 표준 이름은 cluster 입니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형
object
필수 항목
  • spec

24.1. 사양

속성유형설명

apiVersion

string

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

kind

string

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

메타데이터

ObjectMeta

표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

object

spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.

status

object

status에는 클러스터에서 관찰된 값이 포함되어 있습니다. 재정의할 수 없습니다.

24.1.1. .spec

설명
spec에는 구성에 대한 사용자 설정 가능 값이 있습니다.
유형
object
속성유형설명

defaultNodeSelector

string

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

boolean

mastersSchedulable을 사용하면 마스터 노드를 예약할 수 있습니다. 이 플래그가 켜지면 클러스터의 모든 마스터 노드가 예약 가능 상태가 되어 워크로드 Pod를 실행할 수 있습니다. 이 필드의 기본값은 false입니다. 즉, 마스터 노드를 예약할 수 없습니다. 중요 사항: 워크로드 Pod가 마스터 노드에서 실행되기 시작하면 클러스터 크리티컬 컨트롤 플레인 구성 요소에 영향을 미치지 않도록 주의해야 합니다. 실사를 수행한 후 이 필드를 켭니다.

policy

object

DEPRECATED: 스케줄러 정책 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 정책은 사용자가 지정한 서술자 및 우선순위가 있는 스케줄러 정책이 포함된 ConfigMap에 대한 참조입니다. 이 ConfigMap을 사용할 수 없는 경우 스케줄러는 기본적으로 DefaultAlgorithmProvider를 사용합니다. 이 configmap의 네임스페이스는 openshift-config입니다.

profile

string

프로필은 새 Pod에 대한 스케줄링 결정을 구성하기 위해 설정해야 하는 예약 프로필을 설정합니다. 유효한 값은 "LowNodeUtilization", "HighNodeUtilization", "NoScoring" 기본값을 "LowNodeUtilization"입니다.

24.1.2. .spec.policy

설명
DEPRECATED: 스케줄러 정책 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. 정책은 사용자가 지정한 서술자 및 우선순위가 있는 스케줄러 정책이 포함된 ConfigMap에 대한 참조입니다. 이 ConfigMap을 사용할 수 없는 경우 스케줄러는 기본적으로 DefaultAlgorithmProvider를 사용합니다. 이 configmap의 네임스페이스는 openshift-config입니다.
유형
object
필수 항목
  • name
속성유형설명

name

string

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
설명
스케줄러 컬렉션 삭제
표 24.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

HTTP 방법
GET
설명
종류 스케줄러의 오브젝트 나열
표 24.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

SchedulerList 스키마

401 - 무단

HTTP 방법
POST
설명
스케줄러 생성
표 24.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

스케줄러 스키마

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

200 - OK

스케줄러 스키마

201 - 생성됨

스케줄러 스키마

202 - 승인됨

스케줄러 스키마

401 - 무단

24.2.2. /apis/config.openshift.io/v1/schedulers/{name}

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

name

string

스케줄러의 이름

HTTP 방법
DELETE
설명
스케줄러 삭제
표 24.7. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

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

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

HTTP 방법
GET
설명
지정된 스케줄러 읽기
표 24.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케줄러 스키마

401 - 무단

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

dryRun

string

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

fieldValidation

string

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

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

200 - OK

스케줄러 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 스케줄러 교체
표 24.12. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

스케줄러 스키마

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

200 - OK

스케줄러 스키마

201 - 생성됨

스케줄러 스키마

401 - 무단

24.2.3. /apis/config.openshift.io/v1/schedulers/{name}/status

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

name

string

스케줄러의 이름

HTTP 방법
GET
설명
지정된 스케줄러의 읽기 상태
표 24.16. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

스케줄러 스키마

401 - 무단

HTTP 방법
PATCH
설명
지정된 스케줄러의 부분적으로 업데이트 상태
표 24.17. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

200 - OK

스케줄러 스키마

401 - 무단

HTTP 방법
PUT
설명
지정된 스케줄러의 상태 교체
표 24.19. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

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

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

body

스케줄러 스키마

 
표 24.21. HTTP 응답
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.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.