Tigera 오퍼레이터 API 레퍼런스 파트 1

Tigera 오퍼레이터는 operator.tigera.io/v1 API 그룹의 커스텀 리소스를 감시하면서 Calico를 설치하고 관리해요. Installation 리소스는 설치 시점에 클러스터 전체 옵션을 정하고, APIServer, Goldmane, Whisker 같은 다른 리소스들은 개별 컴포넌트를 설정해요. 실행 중인 클러스터에서도 kubectl로 대부분의 설정을 바꿀 수 있고, 오퍼레이터가 클러스터를 그 상태에 맞게 조정(reconcile)해 줘요. 이 API 그룹은 일상적인 네트워킹과 정책에 쓰는 projectcalico.org/v3 리소스와는 별개라는 점도 기억하세요. 그쪽 내용이 필요하면 Resource definitions 문서를 참고하세요.

원문 문서가 길어서 여러 파트로 나눠 담았어요. 이 파일은 파트 1로, APIServer부터 CalicoNetworkSpec 항목까지를 다뤄요.

출처: 문서

본문

패키지 (Packages)

• operator.tigera.io/v1

operator.tigera.io/v1

Calico와 Calico Enterprise 설치를 구성하기 위한 API 스키마 정의예요.

v1 패키지에는 오퍼레이터 v1 API 그룹의 API 스키마 정의가 담겨 있어요.

리소스 타입 (Resource Types)

• APIServer
• GatewayAPI
• Goldmane
• ImageSet
• Installation
• Istio
• TigeraStatus
• Whisker

APIServer

APIServer는 Tigera API 서버와 관련 리소스를 설치해요. 이 리소스는 최대 한 인스턴스까지만 지원되며, 이름은 반드시 "default" 또는 "tigera-secure"여야 해요.

Field	Description
apiVersion string	operator.tigera.io/v1
kind string	APIServer
metadata ObjectMeta	metadata 필드는 Kubernetes API 문서를 참고하세요.
spec APIServerSpec	Tigera API 서버의 의도한 상태(desired state)에 대한 명세예요.
status APIServerStatus	Tigera API 서버에서 가장 최근에 관찰된 상태예요.

APIServerDeployment

APIServerDeployment는 API 서버 Deployment의 설정이에요.

등장 위치 (Appears in):

• APIServerSpec

Field	Description
metadata Metadata	(선택 사항) metadata 필드는 Kubernetes API 문서를 참고하세요.
spec APIServerDeploymentSpec	(선택 사항) Spec은 API 서버 Deployment의 명세예요.

APIServerDeploymentContainer

APIServerDeploymentContainer는 API 서버 Deployment의 컨테이너예요.

등장 위치 (Appears in):

• APIServerDeploymentPodSpec

Field	Description
name string	Name은 API 서버 Deployment 컨테이너를 이름으로 식별하는 enum이에요. 지원하는 값은: calico-apiserver, tigera-queryserver, calico-l7-admission-controller
ports APIServerDeploymentContainerPort array	(선택 사항) Ports는 컨테이너의 포트를 커스터마이징할 수 있게 해 줘요. 지정하면 이름이 일치하는 APIServer Deployment 컨테이너의 포트를 덮어써요. 생략하면 API 서버 Deployment는 이 컨테이너의 기본 포트 값을 사용해요.
resources ResourceRequirements	(선택 사항) Resources는 cpu, memory 같은 컴퓨팅 리소스의 limits와 requests를 커스터마이징할 수 있게 해 줘요. 지정하면 이름이 일치하는 API 서버 Deployment 컨테이너의 리소스를 덮어써요. 생략하면 API 서버 Deployment는 이 컨테이너의 기본 리소스 값을 사용해요. 지원 중단(deprecated)된 ComponentResources와 함께 사용하면 이 값이 우선해요.
readinessProbe ProbeOverride	(선택 사항) ReadinessProbe는 readiness 프로브의 타이밍 파라미터를 커스터마이징할 수 있게 해 줘요. 프로브 핸들러는 오퍼레이터가 설정하며 직접 바꿀 수 없어요.
livenessProbe ProbeOverride	(선택 사항) LivenessProbe는 liveness 프로브의 타이밍 파라미터를 커스터마이징할 수 있게 해 줘요. 프로브 핸들러는 오퍼레이터가 설정하며 직접 바꿀 수 없어요.

APIServerDeploymentContainerPort

등장 위치 (Appears in):

• APIServerDeploymentContainer

Field	Description
name string	Name은 API 서버 Deployment 컨테이너 포트를 이름으로 식별하는 enum이에요. 지원하는 값은: apiserver, queryserver, l7admctrl
containerPort integer	파드 IP 주소에 노출할 포트 번호예요. 유효한 포트 번호, 즉 0 < x < 65536을 만족해야 해요.

APIServerDeploymentInitContainer

APIServerDeploymentInitContainer는 API 서버 Deployment의 init 컨테이너예요.

등장 위치 (Appears in):

• APIServerDeploymentPodSpec

Field	Description
name string	Name은 API 서버 Deployment init 컨테이너를 이름으로 식별하는 enum이에요. 지원하는 값은: calico-apiserver-certs-key-cert-provisioner
resources ResourceRequirements	(선택 사항) Resources는 cpu, memory 같은 컴퓨팅 리소스의 limits와 requests를 커스터마이징할 수 있게 해 줘요. 지정하면 이름이 일치하는 API 서버 Deployment init 컨테이너의 리소스를 덮어써요. 생략하면 API 서버 Deployment는 이 init 컨테이너의 기본 리소스 값을 사용해요.

APIServerDeploymentPodSpec

APIServerDeploymentPodSpec는 API 서버 Deployment의 PodSpec이에요.

등장 위치 (Appears in):

• APIServerDeploymentPodTemplateSpec

Field	Description
initContainers APIServerDeploymentInitContainer array	(선택 사항) InitContainers는 API 서버 init 컨테이너 목록이에요. 지정하면 설정된 API 서버 Deployment init 컨테이너를 덮어써요. 생략하면 API 서버 Deployment는 init 컨테이너의 기본 값을 사용해요.
containers APIServerDeploymentContainer array	(선택 사항) Containers는 API 서버 컨테이너 목록이에요. 지정하면 설정된 API 서버 Deployment 컨테이너를 덮어써요. 생략하면 API 서버 Deployment는 컨테이너의 기본 값을 사용해요.
affinity Affinity	(선택 사항) Affinity는 API 서버 파드를 위한 어피니티 스케줄링 규칙 그룹이에요. 지정하면 API 서버 Deployment에 설정된 어피니티가 있더라도 그걸 덮어써요. 생략하면 API 서버 Deployment는 기본 어피니티 값을 사용해요. 경고(WARNING): 이 필드는 기본 API 서버 Deployment 어피니티를 덮어쓴다는 점에 유의하세요.
nodeSelector object (keys:string, values:string)	NodeSelector는 API 서버 파드의 스케줄링 제약 조건이에요. 지정하면 키/값 쌍 각각이 API 서버 Deployment nodeSelector에 추가되는데, 이때 해당 키가 객체의 nodeSelector에 아직 없는 경우에 한해 추가돼요. ControlPlaneNodeSelector와 함께 사용하면 그 nodeSelector가 API 서버 Deployment에 설정되고, 이 필드의 키/값 쌍 각각은 (해당 키가 객체의 nodeSelector에 아직 없는 경우에 한해) API 서버 Deployment nodeSelector에 추가돼요. 생략하면 API 서버 Deployment는 기본 nodeSelector 값을 사용해요. 경고(WARNING): 이 필드는 기본 API 서버 Deployment nodeSelector를 변경한다는 점에 유의하세요.
topologySpreadConstraints TopologySpreadConstraint array	(선택 사항) TopologySpreadConstraints는 파드 그룹이 토폴로지 도메인에 어떻게 분산되어야 하는지 설명해요. 스케줄러는 이 제약 조건을 지키는 방식으로 파드를 배치해요. 모든 topologySpreadConstraints는 AND 조건으로 결합돼요.
tolerations Toleration array	(선택 사항) Tolerations는 API 서버 파드의 톨러레이션이에요. 지정하면 API 서버 Deployment에 설정된 톨러레이션이 있더라도 그걸 덮어써요. 생략하면 API 서버 Deployment는 기본 톨러레이션 값을 사용해요. 경고(WARNING): 이 필드는 기본 API 서버 Deployment 톨러레이션을 덮어쓴다는 점에 유의하세요.
priorityClassName string	(선택 사항) PriorityClassName은 사용할 PriorityClass 리소스를 지정할 수 있게 해 줘요.

APIServerDeploymentPodTemplateSpec

APIServerDeploymentPodTemplateSpec는 API 서버 Deployment의 PodTemplateSpec이에요.

등장 위치 (Appears in):

• APIServerDeploymentSpec

Field	Description
metadata Metadata	(선택 사항) metadata 필드는 Kubernetes API 문서를 참고하세요.
spec APIServerDeploymentPodSpec	(선택 사항) Spec은 API 서버 Deployment의 PodSpec이에요.

APIServerDeploymentSpec

APIServerDeploymentSpec는 API 서버 Deployment의 설정을 정의해요.

등장 위치 (Appears in):

• APIServerDeployment

Field	Description
minReadySeconds integer	(선택 사항) MinReadySeconds는 새로 생성된 Deployment 파드가 '사용 가능(available)'으로 간주되기 위해, 어떤 컨테이너도 크래시 없이 준비 상태를 유지해야 하는 최소 시간(초)이에요. 지정하면 API 서버 Deployment에 설정된 minReadySeconds 값이 있더라도 그걸 덮어써요. 생략하면 API 서버 Deployment는 기본 minReadySeconds 값을 사용해요.
template APIServerDeploymentPodTemplateSpec	(선택 사항) Template은 생성될 API 서버 Deployment 파드를 설명해요.

APIServerLogging

등장 위치 (Appears in):

• APIServerPodLogging

Field	Description
logSeverity LogSeverity	(선택 사항) LogSeverity는 APIServer 컨테이너의 로그 레벨을 정의해요.

APIServerPodLogging

등장 위치 (Appears in):

• APIServerSpec

Field	Description
apiServer APIServerLogging	(선택 사항)
queryServer QueryServerLogging	(선택 사항)

APIServerSpec

APIServerSpec는 Tigera API 서버의 의도한 상태를 정의해요.

등장 위치 (Appears in):

• APIServer

Field	Description
logging APIServerPodLogging	(선택 사항)
apiServerDeployment APIServerDeployment	APIServerDeployment는 calico-apiserver Deployment를 설정해요. ControlPlaneNodeSelector나 ControlPlaneTolerations와 함께 사용하면 이 재정의 값들이 우선해요.
calicoWebhooksDeployment CalicoWebhooksDeployment	(선택 사항) CalicoWebhooksDeployment는 calico-webhooks Deployment를 설정해요.

APIServerStatus

APIServerStatus는 Tigera API 서버의 관찰된 상태를 정의해요.

등장 위치 (Appears in):

• APIServer

Field	Description
state string	State는 사용자가 읽을 수 있는 상태 정보를 제공해요.
conditions Condition array	(선택 사항) Conditions는 컴포넌트에서 가장 최근에 관찰된 조건 집합을 나타내요. 컴포넌트는 Ready, Progressing, Degraded 같은 하나 이상의 상태이거나 다른 타입일 수 있어요.

Alertmanager

등장 위치 (Appears in):

• MonitorSpec

Field	Description
spec AlertmanagerSpec	(선택 사항) Spec은 Alertmanager의 명세예요.

AlertmanagerSpec

등장 위치 (Appears in):

• Alertmanager

Field	Description
replicas integer	(선택 사항) Replicas는 Alertmanager 복제본 수를 정의해요. 0으로 설정하면 Alertmanager는 배포되지 않아요. 기본값: 0
resources ResourceRequirements	단일 파드에 대한 리소스 requests와 limits를 정의해요.

AssignmentMode

내부 타입 (Underlying type): string

등장 위치 (Appears in):

• IPPool

Value	Description
Automatic
Manual

Azure

등장 위치 (Appears in):

• InstallationSpec

Field	Description
policyMode PolicyMode	(선택 사항) PolicyMode는 "control-plane" 라벨을 네임스페이스에 적용할지 결정해요. Default와 Manual 두 옵션이 있어요. Default는 필요한 네임스페이스에 "control-plane" 라벨을 추가하고, Manual은 어떤 네임스페이스에도 "control-plane" 라벨을 적용하지 않아요. 기본값: Default

BGPOption

내부 타입 (Underlying type): string

BGPOption은 사용할 BGP 모드를 설명해요.

다음 중 하나: Enabled, Disabled

등장 위치 (Appears in):

• CalicoNetworkSpec

Value	Description
Enabled
Disabled

BPFNetworkBootstrapType

내부 타입 (Underlying type): string

BPFNetworkBootstrapType는 초기 네트워킹 구성이 어떻게 실행되는지 정의해요.

등장 위치 (Appears in):

• CalicoNetworkSpec

Value	Description
Enabled
Disabled

CNIInstallMode

내부 타입 (Underlying type): string

CNIInstallMode는 오퍼레이터가 호스트에 설치할 CNI 플러그인 바이너리를 제어해요.

등장 위치 (Appears in):

• CNISpec

Value	Description
All	CNIInstallModeAll은 전용 init 컨테이너를 통해 Calico 자체 CNI 바이너리와 업스트림 플러그인 세트(host-local, portmap, loopback, tuning, flannel)를 설치해요.
CalicoOnly	CNIInstallModeCalicoOnly는 Calico 자체 CNI 바이너리만 설치해요. 필요한 업스트림 플러그인은 호스트가 제공하는 것으로 간주해요.

CNILogging

등장 위치 (Appears in):

• Logging

Field	Description
logSeverity LogLevel	(선택 사항) 기본값: Info
logFileMaxSize Quantity	(선택 사항) 기본값: 100Mi
logFileMaxAgeDays integer	(선택 사항) 기본값: 30 (일)
logFileMaxCount integer	(선택 사항) 기본값: 10

CNIPluginType

내부 타입 (Underlying type): string

CNIPluginType는 사용하는 CNI 플러그인 타입을 설명해요.

다음 중 하나: Calico, GKE, AmazonVPC, AzureVNET

등장 위치 (Appears in):

• CNISpec

Value	Description
Calico
GKE
AmazonVPC
AzureVNET

CNISpec

CNISpec에는 CNI 플러그인 설정이 담겨 있어요.

등장 위치 (Appears in):

• InstallationSpec

Field	Description
type CNIPluginType	Calico 또는 Calico Enterprise 설치에서 사용할 CNI 플러그인을 지정해요. * KubernetesProvider가 GKE면 이 필드는 GKE가 기본값이에요. * KubernetesProvider가 AKS면 이 필드는 AzureVNET이 기본값이에요. * KubernetesProvider가 EKS면 이 필드는 AmazonVPC가 기본값이에요. * Installation 리소스가 생성되는 시점에 kube-system에 aws-node 데몬셋이 있으면 이 필드는 AmazonVPC가 기본값이에요. * 그 외 모든 경우 이 필드는 Calico가 기본값이에요. 값이 Calico이면 CNI 플러그인 바이너리와 CNI 설정이 배포의 일부로 설치되고, 다른 값이면 CNI 플러그인 바이너리와 CNI 설정은 별도로 설치해야 하는 의존성으로 취급돼요. 기본값: Calico
ipam IPAMSpec	(선택 사항) IPAM은 Calico 또는 Calico Enterprise 설치에서 사용할 파드 IP 주소 관리(IPAM) 방식을 지정해요.
specVersion CNISpecVersion	(선택 사항) SpecVersion은 오퍼레이터가 생성하는 CNI 설정("cniVersion")에 선언되는 CNI 스펙 버전을 설정해요. Auto(기본값)는 오퍼레이터가 적절한 버전을 선택하게 하며, 이 버전은 오퍼레이터 업그레이드에 따라 올라갈 수 있어요. 환경의 체인드(chained) CNI 플러그인이나 컨테이너 런타임이 특정 버전을 요구한다면 명시적으로 버전을 고정하세요. Calico CNI 플러그인을 사용할 때만 관련이 있어요. 기본값: Auto
binDir string	(선택 사항) BinDir는 CNI 바이너리 디렉터리 경로예요. 컨테이너 런타임 설정에서 CNI 바이너리 설치 디렉터리를 변경했다면, 이 필드가 컨테이너 런타임 설정에 지정된 디렉터리와 일치하는지 확인하세요. 기본 디렉터리는 KubernetesProvider에 따라 달라요. * KubernetesProvider가 GKE면 이 필드는 "/home/kubernetes/bin"이 기본값이에요. * KubernetesProvider가 OpenShift면 이 필드는 "/var/lib/cni/bin"이 기본값이에요. * 그 외의 경우 이 필드는 "/opt/cni/bin"이 기본값이에요.
confDir string	(선택 사항) ConfDir는 CNI 설정 디렉터리 경로예요. 컨테이너 런타임 설정에서 CNI 설정 설치 디렉터리를 변경했다면, 이 필드가 컨테이너 런타임 설정에 지정된 디렉터리와 일치하는지 확인하세요. 기본 디렉터리는 KubernetesProvider에 따라 달라요. * KubernetesProvider가 GKE면 이 필드는 "/etc/cni/net.d"가 기본값이에요. * KubernetesProvider가 OpenShift면 이 필드는 "/var/run/multus/cni/net.d"가 기본값이에요. * 그 외의 경우 이 필드는 "/etc/cni/net.d"가 기본값이에요.
installMode CNIInstallMode	(선택 사항) InstallMode는 CNI.Type이 Calico일 때 오퍼레이터가 각 노드에 설치할 CNI 플러그인 바이너리를 제어해요. * All(기본값): 오퍼레이터는 cni-plugins init 컨테이너를 실행해 업스트림 CNI 플러그인 바이너리(host-local, portmap, loopback, tuning, flannel)를 공유 볼륨에 준비하고, install-cni init 컨테이너가 Calico 자체 바이너리와 함께 이를 호스트로 복사해요. * CalicoOnly: cni-plugins init 컨테이너를 건너뛰고 Calico 자체 바이너리만 설치해요. 호스트가 이미 업스트림 플러그인을 제공하는 경우(예: kind, 일부 관리형 노드 이미지)에 사용하세요. 기본값: All

CNISpecVersion

내부 타입 (Underlying type): string

CNISpecVersion는 오퍼레이터가 생성하는 CNI 설정에 선언되는 CNI 스펙 버전이에요.

등장 위치 (Appears in):

• CNISpec

Value	Description
Auto	CNISpecVersionAuto는 오퍼레이터가 CNI 스펙 버전을 선택하게 해요. 오래된 컨테이너 런타임이 지원 대상에서 빠지면서 선택된 버전은 향후 오퍼레이터 버전에서 올라갈 수 있어요.
0.3.1
0.4.0
1.0.0

CRDManagement

내부 타입 (Underlying type): string

유효성 검사 (Validation):

• Enum: [Reconcile PreferExisting]

등장 위치 (Appears in):

• GatewayAPISpec

Value	Description
Reconcile
PreferExisting

CSINodeDriverDaemonSet

CSINodeDriverDaemonSet은 csi-node-driver DaemonSet의 설정이에요.

등장 위치 (Appears in):

• InstallationSpec

Field	Description
metadata Metadata	(선택 사항) metadata 필드는 Kubernetes API 문서를 참고하세요.
spec CSINodeDriverDaemonSetSpec	(선택 사항) Spec은 csi-node-driver DaemonSet의 명세예요.

CSINodeDriverDaemonSetContainer

CSINodeDriverDaemonSetContainer는 csi-node-driver DaemonSet의 컨테이너예요.

등장 위치 (Appears in):

• CSINodeDriverDaemonSetPodSpec

Field	Description
name string	Name은 csi-node-driver DaemonSet 컨테이너를 이름으로 식별하는 enum이에요. 지원하는 값은: calico-csi, csi-node-driver-registrar.
resources ResourceRequirements	(선택 사항) Resources는 cpu, memory 같은 컴퓨팅 리소스의 limits와 requests를 커스터마이징할 수 있게 해 줘요. 지정하면 이름이 일치하는 csi-node-driver DaemonSet 컨테이너의 리소스를 덮어써요. 생략하면 csi-node-driver DaemonSet은 이 컨테이너의 기본 리소스 값을 사용해요.
readinessProbe ProbeOverride	(선택 사항) ReadinessProbe는 readiness 프로브의 타이밍 파라미터를 커스터마이징할 수 있게 해 줘요. 프로브 핸들러는 오퍼레이터가 설정하며 직접 바꿀 수 없어요.
livenessProbe ProbeOverride	(선택 사항) LivenessProbe는 liveness 프로브의 타이밍 파라미터를 커스터마이징할 수 있게 해 줘요. 프로브 핸들러는 오퍼레이터가 설정하며 직접 바꿀 수 없어요.

CSINodeDriverDaemonSetPodSpec

CSINodeDriverDaemonSetPodSpec는 csi-node-driver DaemonSet의 PodSpec이에요.

등장 위치 (Appears in):

• CSINodeDriverDaemonSetPodTemplateSpec

Field	Description
containers CSINodeDriverDaemonSetContainer array	(선택 사항) Containers는 csi-node-driver 컨테이너 목록이에요. 지정하면 설정된 csi-node-driver DaemonSet 컨테이너를 덮어써요. 생략하면 csi-node-driver DaemonSet은 컨테이너의 기본 값을 사용해요.
affinity Affinity	(선택 사항) Affinity는 csi-node-driver 파드를 위한 어피니티 스케줄링 규칙 그룹이에요. 지정하면 csi-node-driver DaemonSet에 설정된 어피니티가 있더라도 그걸 덮어써요. 생략하면 csi-node-driver DaemonSet은 기본 어피니티 값을 사용해요. 경고(WARNING): 이 필드는 기본 csi-node-driver DaemonSet 어피니티를 덮어쓴다는 점에 유의하세요.
nodeSelector object (keys:string, values:string)	(선택 사항) NodeSelector는 csi-node-driver 파드의 스케줄링 제약 조건이에요. 지정하면 키/값 쌍 각각이 csi-node-driver DaemonSet nodeSelector에 추가되는데, 이때 해당 키가 객체의 nodeSelector에 아직 없는 경우에 한해 추가돼요. 생략하면 csi-node-driver DaemonSet은 기본 nodeSelector 값을 사용해요. 경고(WARNING): 이 필드는 기본 csi-node-driver DaemonSet nodeSelector를 변경한다는 점에 유의하세요.
tolerations Toleration array	(선택 사항) Tolerations는 csi-node-driver 파드의 톨러레이션이에요. 지정하면 csi-node-driver DaemonSet에 설정된 톨러레이션이 있더라도 그걸 덮어써요. 생략하면 csi-node-driver DaemonSet은 기본 톨러레이션 값을 사용해요. 경고(WARNING): 이 필드는 기본 csi-node-driver DaemonSet 톨러레이션을 덮어쓴다는 점에 유의하세요.

CSINodeDriverDaemonSetPodTemplateSpec

CSINodeDriverDaemonSetPodTemplateSpec는 csi-node-driver DaemonSet의 PodTemplateSpec이에요.

등장 위치 (Appears in):

• CSINodeDriverDaemonSetSpec

Field	Description
metadata Metadata	(선택 사항) metadata 필드는 Kubernetes API 문서를 참고하세요.
spec CSINodeDriverDaemonSetPodSpec	(선택 사항) Spec은 csi-node-driver DaemonSet의 PodSpec이에요.

CSINodeDriverDaemonSetSpec

CSINodeDriverDaemonSetSpec는 csi-node-driver DaemonSet의 설정을 정의해요.

등장 위치 (Appears in):

• CSINodeDriverDaemonSet

Field	Description
minReadySeconds integer	(선택 사항) MinReadySeconds는 새로 생성된 DaemonSet 파드가 '사용 가능(available)'으로 간주되기 위해, 어떤 컨테이너도 크래시 없이 준비 상태를 유지해야 하는 최소 시간(초)이에요. 지정하면 csi-node-driver DaemonSet에 설정된 minReadySeconds 값이 있더라도 그걸 덮어써요. 생략하면 csi-node-driver DaemonSet은 기본 minReadySeconds 값을 사용해요.
template CSINodeDriverDaemonSetPodTemplateSpec	(선택 사항) Template은 생성될 csi-node-driver DaemonSet 파드를 설명해요.

CalicoKubeControllersDeployment

CalicoKubeControllersDeployment는 calico-kube-controllers Deployment의 설정이에요.

등장 위치 (Appears in):

• InstallationSpec

Field	Description
metadata Metadata	(선택 사항) metadata 필드는 Kubernetes API 문서를 참고하세요.
spec CalicoKubeControllersDeploymentSpec	(선택 사항) Spec은 calico-kube-controllers Deployment의 명세예요.

CalicoKubeControllersDeploymentContainer

CalicoKubeControllersDeploymentContainer는 calico-kube-controllers Deployment의 컨테이너예요.

등장 위치 (Appears in):

• CalicoKubeControllersDeploymentPodSpec

Field	Description
name string	Name은 calico-kube-controllers Deployment 컨테이너를 이름으로 식별하는 enum이에요. 지원하는 값은: calico-kube-controllers, es-calico-kube-controllers
resources ResourceRequirements	(선택 사항) Resources는 cpu, memory 같은 컴퓨팅 리소스의 limits와 requests를 커스터마이징할 수 있게 해 줘요. 지정하면 이름이 일치하는 calico-kube-controllers Deployment 컨테이너의 리소스를 덮어써요. 생략하면 calico-kube-controllers Deployment는 이 컨테이너의 기본 리소스 값을 사용해요. 지원 중단(deprecated)된 ComponentResources와 함께 사용하면 이 값이 우선해요.
readinessProbe ProbeOverride	(선택 사항) ReadinessProbe는 readiness 프로브의 타이밍 파라미터를 커스터마이징할 수 있게 해 줘요. 프로브 핸들러는 오퍼레이터가 설정하며 직접 바꿀 수 없어요.
livenessProbe ProbeOverride	(선택 사항) LivenessProbe는 liveness 프로브의 타이밍 파라미터를 커스터마이징할 수 있게 해 줘요. 프로브 핸들러는 오퍼레이터가 설정하며 직접 바꿀 수 없어요.

CalicoKubeControllersDeploymentPodSpec

CalicoKubeControllersDeploymentPodSpec는 calico-kube-controllers Deployment의 PodSpec이에요.

등장 위치 (Appears in):

• CalicoKubeControllersDeploymentPodTemplateSpec

Field	Description
containers CalicoKubeControllersDeploymentContainer array	(선택 사항) Containers는 calico-kube-controllers 컨테이너 목록이에요. 지정하면 설정된 calico-kube-controllers Deployment 컨테이너를 덮어써요. 생략하면 calico-kube-controllers Deployment는 컨테이너의 기본 값을 사용해요.
affinity Affinity	(선택 사항) Affinity는 calico-kube-controllers 파드를 위한 어피니티 스케줄링 규칙 그룹이에요. 지정하면 calico-kube-controllers Deployment에 설정된 어피니티가 있더라도 그걸 덮어써요. 생략하면 calico-kube-controllers Deployment는 기본 어피니티 값을 사용해요. 경고(WARNING): 이 필드는 기본 calico-kube-controllers Deployment 어피니티를 덮어쓴다는 점에 유의하세요.
nodeSelector object (keys:string, values:string)	NodeSelector는 calico-kube-controllers 파드의 스케줄링 제약 조건이에요. 지정하면 키/값 쌍 각각이 calico-kube-controllers Deployment nodeSelector에 추가되는데, 이때 해당 키가 객체의 nodeSelector에 아직 없는 경우에 한해 추가돼요. ControlPlaneNodeSelector와 함께 사용하면 그 nodeSelector가 calico-kube-controllers Deployment에 설정되고, 이 필드의 키/값 쌍 각각은 (해당 키가 객체의 nodeSelector에 아직 없는 경우에 한해) calico-kube-controllers Deployment nodeSelector에 추가돼요. 생략하면 calico-kube-controllers Deployment는 기본 nodeSelector 값을 사용해요. 경고(WARNING): 이 필드는 기본 calico-kube-controllers Deployment nodeSelector를 변경한다는 점에 유의하세요.
tolerations Toleration array	(선택 사항) Tolerations는 calico-kube-controllers 파드의 톨러레이션이에요. 지정하면 calico-kube-controllers Deployment에 설정된 톨러레이션이 있더라도 그걸 덮어써요. 생략하면 calico-kube-controllers Deployment는 기본 톨러레이션 값을 사용해요. 경고(WARNING): 이 필드는 기본 calico-kube-controllers Deployment 톨러레이션을 덮어쓴다는 점에 유의하세요.

CalicoKubeControllersDeploymentPodTemplateSpec

CalicoKubeControllersDeploymentPodTemplateSpec는 calico-kube-controllers Deployment의 PodTemplateSpec이에요.

등장 위치 (Appears in):

• CalicoKubeControllersDeploymentSpec

Field	Description
metadata Metadata	(선택 사항) metadata 필드는 Kubernetes API 문서를 참고하세요.
spec CalicoKubeControllersDeploymentPodSpec	(선택 사항) Spec은 calico-kube-controllers Deployment의 PodSpec이에요.

CalicoKubeControllersDeploymentSpec

CalicoKubeControllersDeploymentSpec는 calico-kube-controllers Deployment의 설정을 정의해요.

등장 위치 (Appears in):

• CalicoKubeControllersDeployment

Field	Description
minReadySeconds integer	(선택 사항) MinReadySeconds는 새로 생성된 Deployment 파드가 '사용 가능(available)'으로 간주되기 위해, 어떤 컨테이너도 크래시 없이 준비 상태를 유지해야 하는 최소 시간(초)이에요. 지정하면 calico-kube-controllers Deployment에 설정된 minReadySeconds 값이 있더라도 그걸 덮어써요. 생략하면 calico-kube-controllers Deployment는 기본 minReadySeconds 값을 사용해요.
template CalicoKubeControllersDeploymentPodTemplateSpec	(선택 사항) Template은 생성될 calico-kube-controllers Deployment 파드를 설명해요.

CalicoNetworkSpec

더 알아보기 (Learn more)

Calico 설치 옵션의 전체 목록은 Tigera 오퍼레이터 API 레퍼런스 원문에서 확인할 수 있어요. 일상적인 네트워킹·정책에 쓰는 projectcalico.org/v3 리소스는 Resource definitions 문서를 참고하세요.