2장. CatalogSource [operators.coreos.com/v1alpha1]

address

string

address는 OLM이 기존 레지스트리에 연결하는 데 사용할 수 있는 호스트입니다. 형식: <registry-host 또는 ip>:<port>는 SourceType = SourceTypeGrpc에서만 사용됩니다. Image 필드가 설정될 때 무시됩니다.

configMap

string

ConfigMap은 configmap-server 레지스트리를 백업하는 데 사용할 ConfigMap의 이름입니다. SourceType = SourceTypeConfigmap 또는 SourceTypeInternal에서만 사용됩니다.

description

string

displayName

string

메타데이터

grpcPodConfig

object

grpcPodConfig는 CatalogSource Pod의 Pod 사양에 대해 다른 덮어쓰기를 노출합니다. SourceType = SourceTypeGrpc 및 Image가 설정된 경우에만 사용됩니다.

icon

object

image

string

image는 레지스트리 서버를 인스턴스화하는 operator-registry 컨테이너 이미지입니다. SourceType = SourceTypeGrpc에서만 사용됩니다. 존재하는 경우 address 필드는 무시됩니다.

priority

integer

우선순위 필드에 카탈로그 소스에 가중치를 할당하여 종속성 확인자가 사용할 수 있도록 우선 순위를 지정합니다. 사용량: 가중치가 높으면 종속성 확인 중에 이 카탈로그 소스가 더 낮은 카탈로그 소스보다 우선합니다. 우선순위 값의 범위는 int32 범위의 양수에서 음수로 이동할 수 있습니다. 할당되지 않은 우선 순위가 있는 카탈로그 소스의 기본값은 0입니다. 우선순위 값이 동일한 카탈로그 소스의 순위는 해당 이름을 기반으로 사전 결정됩니다.

게시자

string

secrets

배열(문자열)

보안은 카탈로그 콘텐츠에 액세스하는 데 사용할 수 있는 보안 세트를 나타냅니다. 이 목록은 모든 카탈로그 항목에 대해 시도해야 하므로 이 목록을 작게 유지하는 것이 가장 좋습니다.

sourceType

string

SourceType은 소스 유형입니다.

updateStrategy

object

updateStrategy는 폴링 기간 및 포함된 전략 유형을 정의하는 간격의 업데이트된 카탈로그 소스 이미지를 검색할 수 있는 방법을 정의합니다.

nodeSelector

오브젝트(문자열)

nodeSelector는 Pod가 노드에 적합하도록 true여야 하는 선택기입니다. 해당 노드에 예약하려면 Pod의 노드 레이블과 일치해야 하는 선택기입니다.

priorityClassName

string

지정된 경우 Pod의 우선 순위를 나타냅니다. 지정하지 않으면 Pod 우선순위가 기본값 또는 기본값이 없는 경우 0입니다.

securityContextConfig

string

SecurityContextConfig는 레거시 또는 제한 중 하나일 수 있습니다. CatalogSource의 Pod는 올바른 pod.spec.securityContext 및 pod.spec.container[*].securityContext 값으로 삽입되어 Pod가 PSA(Pod Security Admission) 제한된 모드에서 실행되도록 허용하거나 이러한 값을 전혀 설정하지 않습니다. 이 경우 Pod는 PSA 기준 또는 권한 있는 네임스페이스에서만 실행할 수 있습니다. 현재 SecurityContextConfig를 지정하지 않은 경우 기본값 legacy 가 사용됩니다. legacy 또는 restricted 이외의 값을 지정하면 검증 오류가 발생합니다. restricted 모드에서 실행할 수 없는 이전 카탈로그 이미지를 사용하는 경우 SecurityContextConfig를 legacy 로 설정해야 합니다. 향후 버전에서는 기본값이 restricted 로 설정됩니다. 카탈로그 유지 관리자는 이러한 변경 사항을 준비하기 위해 제한된 모드에서 catalogSource Pod 실행을 지원하는 opm 버전으로 카탈로그를 다시 빌드해야 합니다. PSA에 대한 자세한 내용은 여기에서 확인할 수 있습니다: https://kubernetes.io/docs/concepts/security/pod-security-admission/'

허용 오차

array

허용 오차는 카탈로그 소스의 Pod 허용 오차입니다.

tolerations[]

object

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

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인 경우 값은 비어 있어야 합니다. 그렇지 않으면 일반 문자열만 사용해야 합니다.

base64data

string

mediatype

string

registryPoll

object

간격

string

간격은 최신 카탈로그 소스 버전의 점검 사이의 시간 간격을 결정하는 데 사용됩니다. 카탈로그 Operator는 폴링하여 새 버전의 카탈로그 소스를 사용할 수 있는지 확인합니다. 사용 가능한 경우 최신 이미지를 가져오고 gRPC 트래픽이 최신 카탈로그 소스로 전달됩니다.

conditions

array

CatalogSource의 상태를 나타냅니다. Message 및 Reason은 원래 상태 정보를 나타내며, 이는 향후 조건에 따라 마이그레이션될 수 있습니다. 도입된 새로운 기능은 조건을 사용합니다.

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

configMapReference

object

connectionState

object

latestImageRegistryPoll

string

이미지가 최신 상태인지 확인하기 위해 CatalogSource 이미지 레지스트리를 마지막으로 폴링한 시간

message

string

이 조건에 있는 CatalogSource 이유에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

CatalogSource가 현재 상태로 전환된 이유는 다음과 같습니다.

registryService

object

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

lastUpdateTime

string

name

string

네임스페이스

string

resourceVersion

string

uid

string

UID는 UUID를 포함하여 고유한 ID 값을 보유하는 유형입니다. UUID만 사용하지 않기 때문에 문자열에 대한 별칭입니다. 유형이 되는 것은 의도를 캡처하고 UID와 이름이 혼동되지 않도록 하는 데 도움이 됩니다.

address

string

lastConnect

string

lastObservedState

string

createdAt

string

port

string

protocol

string

serviceName

string

serviceNamespace

string