Packages:

- operator.tigera.io/v1

## operator.tigera.io/v1

API Schema definitions for configuring the installation of Calico and Calico Enterprise

Resource Types:

- Installation
- TigeraStatus

### Installation

Installation configures an installation of Calico or Calico Enterprise. At most one instance of this resource is supported. It must be named “default”. The Installation API installs core networking and network policy components, and provides general install-time configuration.

Field | Description
--- | ---
`apiVersion` string | `operator.tigera.io/v1`
`kind` string | `Installation`
`metadata` Kubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the `metadata` field.
`spec` InstallationSpec | Specification of the desired state for the Calico or Calico Enterprise installation.
`variant` ProductVariant | (Optional) Variant is the product to install - one of Calico or TigeraSecureEnterprise Default: Calico
`registry` string | (Optional) Registry is the default Docker registry used for component Docker images. If specified, all images will be pulled from this registry. If not specified then the default registries will be used. Image format: `<registry>/<imagePath>/<imageName>:<image-tag>` This option allows configuring the `<registry>` portion of the above format.
`imagePath` string | (Optional) ImagePath allows for the path part of an image to be specified. If specified then the specified value will be used as the image path for each image. If not specified or empty, the default for each image will be used. Image format: `<registry>/<imagePath>/<imageName>:<image-tag>` This option allows configuring the `<imagePath>` portion of the above format.
`imagePullSecrets` []Kubernetes core/v1.LocalObjectReference | (Optional) ImagePullSecrets is an array of references to container registry pull secrets to use. These are applied to all images to be pulled.
`kubernetesProvider` Provider | (Optional) KubernetesProvider specifies a particular provider of the Kubernetes platform and enables provider-specific configuration. If the specified value is empty, the Operator will attempt to automatically determine the current provider. If the specified value is not empty, the Operator will still attempt auto-detection, but will additionally compare the auto-detected value to the specified value to confirm they match.
`cni` CNISpec | (Optional) CNI specifies the CNI that will be used by this installation.
`calicoNetwork` CalicoNetworkSpec | (Optional) CalicoNetwork specifies networking configuration options for Calico.
`controlPlaneNodeSelector` map[string]string | (Optional) ControlPlaneNodeSelector is used to select control plane nodes on which to run specific Calico components. This currently only applies to kube-controllers and the apiserver.
`nodeMetricsPort` int32 | (Optional) NodeMetricsPort specifies which port calico/node serves prometheus metrics on. By default, metrics are not enabled. If specified, this overrides any FelixConfiguration resources which may exist. If omitted, then prometheus metrics may still be configured through FelixConfiguration.
`flexVolumePath` string | (Optional) FlexVolumePath optionally specifies a custom path for FlexVolume. If not specified, FlexVolume will be enabled by default. If set to ‘None’, FlexVolume will be disabled. The default is based on the kubernetesProvider.
`nodeUpdateStrategy` Kubernetes apps/v1.DaemonSetUpdateStrategy | (Optional) NodeUpdateStrategy can be used to customize the desired update strategy, such as the MaxUnavailable field.
`componentResources` []ComponentResource | (Optional) ComponentResources can be used to customize the resource requirements for each component.
`status` InstallationStatus | Most recently observed state for the Calico or Calico Enterprise installation.

### TigeraStatus

TigeraStatus represents the most recently observed status for Calico or a Calico Enterprise functional area.

Field | Description
--- | ---
`apiVersion` string | `operator.tigera.io/v1`
`kind` string | `TigeraStatus`
`metadata` Kubernetes meta/v1.ObjectMeta | Refer to the Kubernetes API documentation for the fields of the `metadata` field.
`spec` TigeraStatusSpec |
`status` TigeraStatusStatus |

### BGPOption (`string` alias)

(Appears on: CalicoNetworkSpec)

### CNIPluginType (`string` alias)

(Appears on: CNISpec)

CNIPluginType describe the type of CNI plugin used.

### CNISpec

(Appears on: InstallationSpec)

Field | Description
--- | ---
`type` CNIPluginType | Specifies the CNI plugin that will be used in the Calico or Calico Enterprise installation. For KubernetesProvider GKE, this field defaults to GKE. For KubernetesProvider AKE, this field defaults to AzureVNET. For KubernetesProvider EKS, this field defaults to AmazonVPC. For all other KubernetesProviders this field defaults to Calico. For the value Calico, the CNI plugin binaries and CNI config will be installed as part of deployment, for all other values the CNI plugin binaries and CNI config is a dependency that is expected to be installed separately. Default: Calico

### CalicoNetworkSpec

(Appears on: InstallationSpec)

CalicoNetworkSpec specifies configuration options for Calico provided pod networking.

Field | Description
--- | ---
`bgp` BGPOption | (Optional) BGP configures whether or not to enable Calico’s BGP capabilities.
`ipPools` []IPPool | (Optional) IPPools contains a list of IP pools to create if none exist. At most one IP pool of each address family may be specified. If omitted, a single pool will be configured if needed.
`mtu` int32 | (Optional) MTU specifies the maximum transmission unit to use on the pod network. Default: 1410
`nodeAddressAutodetectionV4` NodeAddressAutodetection | (Optional) NodeAddressAutodetectionV4 specifies an approach to automatically detect node IPv4 addresses. If not specified, will use default auto-detection settings to acquire an IPv4 address for each node.
`nodeAddressAutodetectionV6` NodeAddressAutodetection | (Optional) NodeAddressAutodetectionV6 specifies an approach to automatically detect node IPv6 addresses. If not specified, IPv6 addresses will not be auto-detected.
`hostPorts` HostPortsType | (Optional) HostPorts configures whether or not Calico will support Kubernetes HostPorts. Valid only when using the Calico CNI plugin. Default: Enabled
`multiInterfaceMode` MultiInterfaceMode | (Optional) MultiInterfaceMode configures what will configure multiple interface per pod. Only valid for Calico Enterprise installations using the Calico CNI plugin. Default: None
`containerIPForwarding` ContainerIPForwardingType | (Optional) ContainerIPForwarding configures whether ip forwarding will be enabled for containers in the CNI configuration. Default: Disabled

### ComponentName (`string` alias)

(Appears on: ComponentResource)

ComponentName CRD enum

### ComponentResource

(Appears on: InstallationSpec)

The ComponentResource struct associates a ResourceRequirements with a component by name

Field | Description
--- | ---
`componentName` ComponentName | ComponentName is an enum which identifies the component
`resourceRequirements` Kubernetes core/v1.ResourceRequirements | ResourceRequirements allows customization of limits and requests for compute resources such as cpu and memory.

### ConditionStatus (`string` alias)

(Appears on: TigeraStatusCondition)

ConditionStatus represents the status of a particular condition. A condition may be one of: True, False, Unknown.

### ContainerIPForwardingType (`string` alias)

(Appears on: CalicoNetworkSpec)

ContainerIPForwardingType specifies whether the CNI config for container ip forwarding is enabled.

### EncapsulationType (`string` alias)

(Appears on: IPPool)

EncapsulationType is the type of encapsulation to use on an IP pool. Valid options are: IPIP, VXLAN, IPIPCrossSubnet, VXLANCrossSubnet, None.

### HostPortsType (`string` alias)

(Appears on: CalicoNetworkSpec)

HostPortsType specifies if the HostPorts plugin enabled status.

### IPPool

(Appears on: CalicoNetworkSpec)

Field | Description
--- | ---
`cidr` string | CIDR contains the address range for the IP Pool in classless inter-domain routing format.
`encapsulation` EncapsulationType | (Optional) Encapsulation specifies the encapsulation type that will be used with the IP Pool. Default: IPIP
`natOutgoing` NATOutgoingType | (Optional) NATOutgoing specifies if NAT will be enabled or disabled for outgoing traffic. Default: Enabled
`nodeSelector` string | (Optional) NodeSelector specifies the node selector that will be set for the IP Pool. Default: ‘all()’
`blockSize` int32 | (Optional) BlockSize specifies the CIDR prefex length to use when allocating per-node IP blocks from the main IP pool CIDR. Default: 26 (IPv4), 122 (IPv6)

### InstallationSpec

(Appears on: Installation)

InstallationSpec defines configuration for a Calico or Calico Enterprise installation.

Field | Description
--- | ---
`variant` ProductVariant | (Optional) Variant is the product to install - one of Calico or TigeraSecureEnterprise Default: Calico
`registry` string | (Optional) Registry is the default Docker registry used for component Docker images. If specified, all images will be pulled from this registry. If not specified then the default registries will be used. Image format: `<registry>/<imagePath>/<imageName>:<image-tag>` This option allows configuring the `<registry>` portion of the above format.
`imagePath` string | (Optional) ImagePath allows for the path part of an image to be specified. If specified then the specified value will be used as the image path for each image. If not specified or empty, the default for each image will be used. Image format: `<registry>/<imagePath>/<imageName>:<image-tag>` This option allows configuring the `<imagePath>` portion of the above format.
`imagePullSecrets` []Kubernetes core/v1.LocalObjectReference | (Optional) ImagePullSecrets is an array of references to container registry pull secrets to use. These are applied to all images to be pulled.
`kubernetesProvider` Provider | (Optional) KubernetesProvider specifies a particular provider of the Kubernetes platform and enables provider-specific configuration. If the specified value is empty, the Operator will attempt to automatically determine the current provider. If the specified value is not empty, the Operator will still attempt auto-detection, but will additionally compare the auto-detected value to the specified value to confirm they match.
`cni` CNISpec | (Optional) CNI specifies the CNI that will be used by this installation.
`calicoNetwork` CalicoNetworkSpec | (Optional) CalicoNetwork specifies networking configuration options for Calico.
`controlPlaneNodeSelector` map[string]string | (Optional) ControlPlaneNodeSelector is used to select control plane nodes on which to run specific Calico components. This currently only applies to kube-controllers and the apiserver.
`nodeMetricsPort` int32 | (Optional) NodeMetricsPort specifies which port calico/node serves prometheus metrics on. By default, metrics are not enabled. If specified, this overrides any FelixConfiguration resources which may exist. If omitted, then prometheus metrics may still be configured through FelixConfiguration.
`flexVolumePath` string | (Optional) FlexVolumePath optionally specifies a custom path for FlexVolume. If not specified, FlexVolume will be enabled by default. If set to ‘None’, FlexVolume will be disabled. The default is based on the kubernetesProvider.
`nodeUpdateStrategy` Kubernetes apps/v1.DaemonSetUpdateStrategy | (Optional) NodeUpdateStrategy can be used to customize the desired update strategy, such as the MaxUnavailable field.
`componentResources` []ComponentResource | (Optional) ComponentResources can be used to customize the resource requirements for each component.

### InstallationStatus

(Appears on: Installation)

InstallationStatus defines the observed state of the Calico or Calico Enterprise installation.

Field | Description
--- | ---
`variant` ProductVariant | Variant is the most recently observed installed variant - one of Calico or TigeraSecureEnterprise

### MultiInterfaceMode (`string` alias)

(Appears on: CalicoNetworkSpec)

### NATOutgoingType (`string` alias)

(Appears on: IPPool)

NATOutgoingType describe the type of outgoing NAT to use.

### NodeAddressAutodetection

(Appears on: CalicoNetworkSpec)

NodeAddressAutodetection provides configuration options for auto-detecting node addresses. At most one option can be used. If no detection option is specified, then IP auto detection will be disabled for this address family and IPs must be specified directly on the Node resource.

Field | Description
--- | ---
`firstFound` bool | (Optional) FirstFound uses default interface matching parameters to select an interface, performing best-effort filtering based on well-known interface names.
`interface` string | (Optional) Interface enables IP auto-detection based on interfaces that match the given regex.
`skipInterface` string | (Optional) SkipInterface enables IP auto-detection based on interfaces that do not match the given regex.
`canReach` string | (Optional) CanReach enables IP auto-detection based on which source address on the node is used to reach the specified IP or domain.

### ProductVariant (`string` alias)

(Appears on: InstallationSpec, InstallationStatus)

ProductVariant represents the variant of the product. Valid options are: Calico, TigeraSecureEnterprise.

### Provider (`string` alias)

(Appears on: InstallationSpec)

Provider represents a particular provider or flavor of Kubernetes. Valid options are: EKS, GKE, AKS, OpenShift, DockerEnterprise.

### StatusConditionType (`string` alias)

(Appears on: TigeraStatusCondition)

StatusConditionType is a type of condition that may apply to a particular component.

### TigeraStatusCondition

(Appears on: TigeraStatusStatus)

TigeraStatusCondition represents a condition attached to a particular component.

Field | Description
--- | ---
`type` StatusConditionType | The type of condition. May be Available, Progressing, or Degraded.
`status` ConditionStatus | The status of the condition. May be True, False, or Unknown.
`lastTransitionTime` Kubernetes meta/v1.Time | The timestamp representing the start time for the current status.
`reason` string | A brief reason explaining the condition.
`message` string | Optionally, a detailed message providing additional context.

### TigeraStatusSpec

(Appears on: TigeraStatus)

### TigeraStatusStatus

(Appears on: TigeraStatus)

TigeraStatusStatus defines the observed state of TigeraStatus

Field | Description
--- | ---
`conditions` []TigeraStatusCondition | Conditions represents the latest observed set of conditions for this component. A component may be one or more of Available, Progressing, or Degraded.