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

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

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

additionalEnabledCapabilities

배열(문자열)

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

baselineCapabilitySet

string

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

아키텍처

string

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

force

boolean

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

image

string

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

version

string

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

group

string

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

kind

string

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

name

string

구성 요소의 이름입니다.

네임스페이스

string

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

Unmanaged

boolean

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

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는 불필요한 작업을 피하기 위해 사용되며 내부 용도로만 사용됩니다.

enabledCapabilities

배열(문자열)

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

knownCapabilities

배열(문자열)

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

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를 나타냅니다.

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)입니다.

채널

배열(문자열)

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

image

string

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

url

string

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

version

string

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

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에는 이 위험에 대한 정보가 포함되어 있습니다.

promql

object

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

type

string

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

promql

string

PromQL은 클러스터를 분류하는 PromQL 쿼리입니다. 이 쿼리 쿼리는 일치 항목에 1을 반환하고 does-not-match 경우 0을 반환해야 합니다. 시계열을 반환하지 않거나 0 또는 1 이외의 값을 반환하는 쿼리는 평가 실패입니다.

lastTransitionTime

string

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

message

string

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

reason

string

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

status

string

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

type

string

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

채널

배열(문자열)

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

image

string

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

url

string

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

version

string

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

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

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