Skip to content
master
Switch branches/tags

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

cilium

Version: 1.9.90 AppVersion: 1.9.90

Cilium is open source software for providing and transparently securing network connectivity and loadbalancing between application workloads such as application containers or processes. Cilium operates at Layer 3/4 to provide traditional networking and security services as well as Layer 7 to protect and secure use of modern application protocols such as HTTP, gRPC and Kafka.

A new Linux kernel technology called eBPF is at the foundation of Cilium. It supports dynamic insertion of eBPF bytecode into the Linux kernel at various integration points such as: network IO, application sockets, and tracepoints to implement security, networking and visibility logic. eBPF is highly efficient and flexible.

Cilium feature overview

Prerequisites

  • Kubernetes: >= 1.13.0-0
  • Helm: >= 3.0

Getting Started

Try Cilium on any Kubernetes distribution in under 15 minutes:

Minikube Self-Managed K8s Amazon EKS Google GKE Microsoft AKS
Minikube Self-Managed Kubernetes Amazon EKS Google GKE Microsoft AKS

Or, for a quick install with the default configuration:

$ helm repo add cilium https://helm.cilium.io/
$ helm install cilium cilium/cilium --namespace=kube-system

After Cilium is installed, you can explore the features that Cilium has to offer from the Getting Started Guides page.

Source Code

Getting Help

The best way to get help if you get stuck is to ask a question on the Cilium Slack channel. With Cilium contributors across the globe, there is almost always someone available to help.

Values

Key Type Default Description
affinity object {"nodeAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":{"nodeSelectorTerms":[{"matchExpressions":[{"key":"kubernetes.io/os","operator":"In","values":["linux"]}]},{"matchExpressions":[{"key":"beta.kubernetes.io/os","operator":"In","values":["linux"]}]}]}},"podAntiAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":[{"labelSelector":{"matchExpressions":[{"key":"k8s-app","operator":"In","values":["cilium"]}]},"topologyKey":"kubernetes.io/hostname"}]}} Pod affinity for cilium-agent.
agent bool true Install the cilium agent resources.
autoDirectNodeRoutes bool false
azure.enabled bool false Enable Azure integration
bandwidthManager bool true Optimize TCP and UDP workloads and enable rate-limiting traffic from individual Pods with EDT (Earliest Departure Time) through the "kubernetes.io/egress-bandwidth" Pod annotation.
bpf.clockProbe bool false
bpf.lbMapMax int 65536 Configure the maximum number of entries in the TCP connection tracking table. ctTcpMax: '524288' -- Configure the maximum number of entries for the non-TCP connection tracking table. ctAnyMax: '262144' -- Configure the maximum number of service entries in the load balancer maps.
bpf.monitorAggregation string "medium" Configure auto-sizing for all BPF maps based on available memory. ref: https://docs.cilium.io/en/v1.9/concepts/ebpf/maps/#ebpf-maps -- Configure the level of aggregation for monitor notifications. Valid options are none, low, medium, maximum
bpf.monitorFlags string "all" Configure which TCP flags trigger notifications when seen for the first time in a connection.
bpf.monitorInterval string "5s" Configure the typical time between monitor notifications for active connections.
bpf.policyMapMax int 16384 Configure the maximum number of entries for the NAT table. natMax: 524288 -- Configure the maximum number of entries for the neighbor table. neighMax: 524288 -- Configure the maximum number of entries in endpoint policy map. (per endpoint)
bpf.preallocateMaps bool false Enables pre-allocation of eBPF map values. This increases memory usage but can reduce latency.
bpf.waitForMount bool false Force the cilium-agent DaemonSet to wait in an initContainer until the eBPF filesystem has been mounted.
certgen object {"image":{"pullPolicy":"Always","repository":"quay.io/cilium/certgen","tag":"v0.1.3"},"podLabels":{},"ttlSecondsAfterFinished":1800} Configure certificate generation for Hubble integration. If hubble.tls.auto.method=cronJob, these values are used for the Kubernetes CronJob which will be scheduled regularly to (re)generate any certificates not provided manually.
certgen.podLabels object {} Labels to be added to hubble-certgen pods
certgen.ttlSecondsAfterFinished int 1800 Seconds after which the completed job pod will be deleted
cleanBpfState bool false Clean all eBPF datapath state from the initContainer of the cilium-agent DaemonSet. WARNING: Use with care!
cleanState bool false Clean all local Cilium state from the initContainer of the cilium-agent DaemonSet. Implies cleanBpfState: true. WARNING: Use with care!
cluster.id int nil Unique ID of the cluster. Must be unique across all connected clusters and in the range of 1 to 255. Only required for Cluster Mesh.
cluster.name string "default" Name of the cluster. Only required for Cluster Mesh.
clustermesh.apiserver.etcd.image object {"pullPolicy":"Always","repository":"quay.io/coreos/etcd","tag":"v3.4.13"} Clustermesh API server etcd image.
clustermesh.apiserver.image object {"digest":"","pullPolicy":"Always","repository":"quay.io/cilium/clustermesh-apiserver","tag":"latest","useDigest":false} Clustermesh API server image.
clustermesh.apiserver.nodeSelector object {} Node labels for pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
clustermesh.apiserver.podAnnotations object {} Annotations to be added to clustermesh-apiserver pods
clustermesh.apiserver.podLabels object {} Labels to be added to clustermesh-apiserver pods
clustermesh.apiserver.replicas int 1 Number of replicas run for the clustermesh-apiserver deployment.
clustermesh.apiserver.resources object {} Resource requests and limits for the clustermesh-apiserver container of the clustermesh-apiserver deployment, such as resources: limits: cpu: 1000m memory: 1024M requests: cpu: 100m memory: 64Mi
clustermesh.apiserver.service.annotations object {} Annotations for the clustermesh-apiserver For GKE LoadBalancer, use annotation cloud.google.com/load-balancer-type: "Internal" For EKS LoadBalancer, use annotation service.beta.kubernetes.io/aws-load-balancer-internal: 0.0.0.0/0
clustermesh.apiserver.service.nodePort int 32379 Optional port to use as the node port for apiserver access.
clustermesh.apiserver.service.type string "NodePort"
clustermesh.apiserver.tls.admin object {"cert":"","key":""} base64 encoded PEM values for the clustermesh-apiserver admin certificate and private key Used if 'auto' is not enabled.
clustermesh.apiserver.tls.auto object {"certValidityDuration":1095,"enabled":true,"method":"helm"} Configure automatic TLS certificates generation. A Kubernetes CronJob is used the generate any certificates not provided by the user at installation time.
clustermesh.apiserver.tls.auto.certValidityDuration int 1095 Generated certificates validity duration in days.
clustermesh.apiserver.tls.auto.enabled bool true When set to true, automatically generate a CA and certificates to enable mTLS between clustermesh-apiserver and external workload instances. If set to false, the certs to be provided by setting appropriate values below.
clustermesh.apiserver.tls.ca object {"cert":"","key":""} base64 encoded PEM values for the ExternalWorkload CA certificate and private key.
clustermesh.apiserver.tls.ca.cert string "" Optional CA cert. If it is provided, it will be used by the 'cronJob' method to generate all other certificates. Otherwise, an ephemeral CA is generated.
clustermesh.apiserver.tls.ca.key string "" Optional CA private key. If it is provided, it will be used by the 'cronJob' method to generate all other certificates. Otherwise, an ephemeral CA is generated.
clustermesh.apiserver.tls.client object {"cert":"","key":""} base64 encoded PEM values for the clustermesh-apiserver client certificate and private key Used if 'auto' is not enabled.
clustermesh.apiserver.tls.remote object {"cert":"","key":""} base64 encoded PEM values for the clustermesh-apiserver remote cluster certificate and private key Used if 'auto' is not enabled.
clustermesh.apiserver.tls.server object {"cert":"","key":""} base64 encoded PEM values for the clustermesh-apiserver server certificate and private key Used if 'auto' is not enabled.
clustermesh.apiserver.tolerations list [] Node tolerations for pod assignment on nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
clustermesh.apiserver.updateStrategy object {"rollingUpdate":{"maxUnavailable":1},"type":"RollingUpdate"} clustermesh-apiserver update strategy
clustermesh.useAPIServer bool false Deploy clustermesh-apiserver for clustermesh
cni.binPath string "/opt/cni/bin" Configure the path to the CNI binary directory on the host.
cni.chainingMode string "none" Configure chaining on top of other CNI plugins. Possible values: - none - generic-veth - aws-cni - portmap
cni.confFileMountPath string "/tmp/cni-configuration" Configure the path to where to mount the ConfigMap inside the agent pod.
cni.confPath string "/etc/cni/net.d" Configure the path to the CNI configuration directory on the host.
cni.configMapKey string "cni-config" Specify the path to a CNI config to read from on agent start. This can be useful if you want to manage your CNI configuration outside of a Kubernetes environment. This parameter is mutually exclusive with the 'cni.configMap' parameter. readCniConf: /host/etc/cni/net.d/05-cilium.conf -- When defined, configMap will mount the provided value as ConfigMap and interpret the cniConf variable as CNI configuration file and write it when the agent starts up configMap: cni-configuration -- Configure the key in the CNI ConfigMap to read the contents of the CNI configuration from.
cni.customConf bool false Skip writing of the CNI configuration. This can be used if writing of the CNI configuration is performed by external automation.
cni.exclusive bool true Make Cilium take ownership over the /etc/cni/net.d directory on the node, renaming all non-Cilium CNI configurations to *.cilium_bak. This ensures no Pods can be scheduled using other CNI plugins during Cilium agent downtime.
cni.hostConfDirMountPath string "/host/etc/cni/net.d" Configure the path to where the CNI configuration directory is mounted inside the agent pod.
cni.install bool true Install the CNI configuration and binary files into the filesystem.
containerRuntime object {"integration":"none"} Configure how frequently garbage collection should occur for the datapath connection tracking table. conntrackGCInterval: "0s" -- Configure container runtime specific integration.
containerRuntime.integration string "none" Enables specific integrations for container runtimes. Supported values: - containerd - crio - docker - none - auto (automatically detect the container runtime)
daemon.runPath string "/var/run/cilium" Configure where Cilium runtime state should be stored.
datapathMode string "veth"
debug.enabled bool false Enable debug logging
enableCnpStatusUpdates bool false Specify which network interfaces can run the eBPF datapath. This means that a packet sent from a pod to a destination outside the cluster will be masqueraded (to an output device IPv4 address), if the output device runs the program. When not specified, probing will automatically detect devices. devices: "" TODO: Add documentation disableIptablesFeederRules: "" TODO: Add documentation egressMasqueradeInterfaces: ""
enableCriticalPriorityClass bool true Explicitly enable or disable priority class. .Capabilities.KubeVersion is unsettable in helm template calls, it depends on k8s libriaries version that Helm was compiled against. This option allows to explicitly disable setting the priority class, which is useful for rendering charts for gke clusters in advance.
enableIPv4Masquerade bool true hashSeed is the cluster-wide base64 encoded seed for the hashing hashSeed: -- Enables masquerading of IPv4 traffic leaving the node from endpoints.
enableIPv6Masquerade bool true Enables masquerading of IPv6 traffic leaving the node from endpoints.
enableK8sEventHandover bool false Configures the use of the KVStore to optimize Kubernetes event handling by mirroring it into the KVstore for reduced overhead in large clusters.
enableXTSocketFallback bool true
encryption.enabled bool false Enable transparent network encryption.
encryption.keyFile string "keys" Name of the key file inside the Kubernetes secret configured via secretName.
encryption.mountPath string "/etc/ipsec" Path to mount the secret inside the Cilium pod.
encryption.nodeEncryption bool false Enable encryption for pure node to node traffic.
encryption.secretName string "cilium-ipsec-keys" Name of the Kubernetes secret containing the encryption keys.
endpointHealthChecking.enabled bool true
endpointRoutes.enabled bool false Enable use of per endpoint routes instead of routing via the cilium_host interface.
eni.awsReleaseExcessIPs bool false Release IPs not used from the ENI
eni.ec2APIEndpoint string "" EC2 API endpoint to usee
eni.enabled bool false Enable Elastic Network Interface (ENI) integration.
eni.eniTags object {} Tags to apply to the newly created ENIs
eni.iamRole string "" If using IAM role for Service Accounts will not try to inject identity values from cilium-aws kubernetes secret. Adds annotation to service account if managed by Helm. See https://github.com/aws/amazon-eks-pod-identity-webhook
eni.subnetIDsFilter string "" Filter via subnet IDs which will dictate which subnets are going to be used to create new ENIs
eni.subnetTagsFilter string "" Filter via tags (k=v) which will dictate which subnets are going to be used to create new ENIs
eni.updateEC2AdapterLimitViaAPI bool false Update ENI Adapter limits from the EC2 API
etcd.clusterDomain string "cluster.local" Cluster domain for cilium-etcd-operator.
etcd.clusterSize int 3 Size of the managed etcd cluster.
etcd.enabled bool false Enable etcd mode for the agent.
etcd.endpoints list ["https://CHANGE-ME:2379"] List of etcd endpoints (not needed when using managed=true).
etcd.extraArgs list [] Additional cilium-etcd-operator container arguments
etcd.extraConfigmapMounts list [] Additional cilium-etcd-operator ConfigMap mounts
etcd.extraHostPathMounts list [] Additional cilium-etcd-operator hostPath mounts
etcd.extraInitContainers list [] Additional InitContainers to initialize the pod
etcd.image object {"pullPolicy":"Always","repository":"quay.io/cilium/cilium-etcd-operator","tag":"v2.0.7"} cilium-etcd-operator image.
etcd.k8sService bool false If etcd is behind a k8s service set this option to true so that Cilium does the service translation automatically without requiring a DNS to be running.
etcd.managed bool false Enable managed etcd mode based on the cilium-etcd-operator.
etcd.nodeSelector object {} Node labels for cilium-etcd-operator pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
etcd.podAnnotations object {} Annotations to be added to cilium-etcd-operator pods
etcd.podDisruptionBudget object {"enabled":true,"maxUnavailable":2} PodDisruptionBudget settings ref: https://kubernetes.io/docs/concepts/workloads/pods/disruptions/
etcd.podLabels object {} Labels to be added to cilium-etcd-operator pods
etcd.priorityClassName string "" cilium-etcd-operator priorityClassName
etcd.resources object {} cilium-etcd-operator resource limits & requests ref: https://kubernetes.io/docs/user-guide/compute-resources/
etcd.securityContext object {} Security context to be added to cilium-etcd-operator pods
etcd.ssl bool false Enable use of TLS/SSL for connectivity to etcd. (auto-enabled if managed=true)
etcd.tolerations list [{"operator":"Exists"}] Node tolerations for cilium-etcd-operator scheduling to nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
etcd.updateStrategy object {"rollingUpdate":{"maxSurge":1,"maxUnavailable":1},"type":"RollingUpdate"} cilium-etcd-operator update strategy
externalIPs.enabled bool false Enable ExternalIPs service support.
externalWorkloads object {"enabled":false} Configure external workloads support
externalWorkloads.enabled bool false Enable support for external workloads, such as VMs (false by default).
extraArgs list [] Additional agent container arguments
extraConfig object {} extraConfig allows you to specify additional configuration parameters to be included in the cilium-config configmap.
extraConfigmapMounts list [] Additional agent ConfigMap mounts
extraEnv object {} Additional agent container environment variables
extraHostPathMounts list [] Additional agent hostPath mounts
extraInitContainers list [] Additional InitContainers to initialize the pod
flannel.enabled bool false
flannel.masterDevice string "cni0"
flannel.uninstallOnExit bool false
gke.enabled bool false Enable Google Kubernetes Engine integration
healthChecking bool true
healthPort int 9876 TCP port for the agent health API. This is not the port for cilium-health.
hostFirewall bool false Enables the enforcement of host policies in the eBPF datapath.
hostPort.enabled bool false Enable hostPort service support.
hostServices object {"enabled":false,"protocols":"tcp,udp"} Configure ClusterIP service handling in the host namespace (the node).
hostServices.enabled bool false Enable host reachable services.
hostServices.protocols string "tcp,udp" Supported list of protocols to apply ClusterIP translation to.
hubble.enabled bool true Enable Hubble (true by default).
hubble.listenAddress string ":4244" An additional address for Hubble to listen to. Set this field ":4244" if you are enabling Hubble Relay, as it assumes that Hubble is listening on port 4244.
hubble.metrics object {"enabled":null,"port":9091,"serviceMonitor":{"enabled":false}} Buffer size of the channel Hubble uses to receive monitor events. If this value is not set, the queue size is set to the default monitor queue size. eventQueueSize: "" -- Number of recent flows for Hubble to cache. Defaults to 4095. Possible values are: 1, 3, 7, 15, 31, 63, 127, 255, 511, 1023, 2047, 4095, 8191, 16383, 32767, 65535 eventBufferCapacity: "4095" -- Hubble metrics configuration. See https://docs.cilium.io/en/stable/configuration/metrics/#hubble-metrics for more comprehensive documentation about Hubble metrics.
hubble.metrics.enabled string nil Configures the list of metrics to collect. If empty or null, metrics are disabled. Example: enabled: - dns:query;ignoreAAAA - drop - tcp - flow - icmp - http You can specify the list of metrics from the helm CLI: --set metrics.enabled="{dns:query;ignoreAAAA,drop,tcp,flow,icmp,http}"
hubble.metrics.port int 9091 Configure the port the hubble metric server listens on.
hubble.metrics.serviceMonitor.enabled bool false Create ServiceMonitor resources for Prometheus Operator. This requires the prometheus CRDs to be available. ref: https://github.com/prometheus-operator/prometheus-operator/blob/master/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml)
hubble.metricsServer string ""
hubble.relay.dialTimeout string nil Dial timeout to connect to the local hubble instance to receive peer information (e.g. "30s").
hubble.relay.enabled bool false Enable Hubble Relay (requires hubble.enabled=true)
hubble.relay.image object {"digest":"","pullPolicy":"Always","repository":"quay.io/cilium/hubble-relay","tag":"latest","useDigest":false} Hubble-relay container image.
hubble.relay.listenHost string "" Host to listen to. Specify an empty string to bind to all the interfaces.
hubble.relay.listenPort string "4245" Port to listen to.
hubble.relay.nodeSelector object {} Node labels for pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
hubble.relay.podAnnotations object {} Annotations to be added to hubble-relay pods
hubble.relay.podLabels object {} Labels to be added to hubble-relay pods
hubble.relay.replicas int 1 Number of replicas run for the hubble-relay deployment.
hubble.relay.resources object {} Specifies the resources for the hubble-relay pods
hubble.relay.retryTimeout string nil Backoff duration to retry connecting to the local hubble instance in case of failure (e.g. "30s").
hubble.relay.rollOutPods bool false Roll out Hubble Relay pods automatically when configmap is updated.
hubble.relay.sortBufferDrainTimeout string nil When the per-request flows sort buffer is not full, a flow is drained every time this timeout is reached (only affects requests in follow-mode) (e.g. "1s").
hubble.relay.sortBufferLenMax string nil Max number of flows that can be buffered for sorting before being sent to the client (per request) (e.g. 100).
hubble.relay.tls object {"client":{"cert":"","key":""},"server":{"cert":"","enabled":false,"key":""}} TLS configuration for Hubble Relay
hubble.relay.tls.client object {"cert":"","key":""} base64 encoded PEM values for the hubble-relay client certificate and private key This keypair is presented to Hubble server instances for mTLS authentication and is required when hubble.tls.enabled is true. These values need to be set manually if hubble.tls.auto.enabled is false.
hubble.relay.tls.server object {"cert":"","enabled":false,"key":""} base64 encoded PEM values for the hubble-relay server certificate and private key
hubble.relay.tolerations list [] Node tolerations for pod assignment on nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
hubble.relay.updateStrategy object {"rollingUpdate":{"maxUnavailable":1},"type":"RollingUpdate"} hubble-relay update strategy
hubble.socketPath string "/var/run/cilium/hubble.sock" Unix domain socket path to listen to when Hubble is enabled.
hubble.tls object {"auto":{"certValidityDuration":1095,"enabled":true,"method":"helm","schedule":"0 0 1 */4 *"},"ca":{"cert":"","key":""},"enabled":true,"server":{"cert":"","key":""}} TLS configuration for Hubble
hubble.tls.auto object {"certValidityDuration":1095,"enabled":true,"method":"helm","schedule":"0 0 1 */4 *"} Configure automatic TLS certificates generation.
hubble.tls.auto.certValidityDuration int 1095 Generated certificates validity duration in days.
hubble.tls.auto.enabled bool true Auto-generate certificates. When set to true, automatically generate a CA and certificates to enable mTLS between Hubble server and Hubble Relay instances. If set to false, the certs for Hubble server need to be provided by setting appropriate values below.
hubble.tls.auto.method string "helm" Set the method to auto-generate certificates. Supported values: - helm: This method uses Helm to generate all certificates. - cronJob: This method uses a Kubernetes CronJob the generate any certificates not provided by the user at installation time.
hubble.tls.auto.schedule string "0 0 1 */4 *" Schedule for certificates regeneration (regardless of their expiration date). Only used if method is "cronJob". If nil, then no recurring job will be created. Instead, only the one-shot job is deployed to generate the certificates at installation time. Defaults to midnight of the first day of every fourth month. For syntax, see https://kubernetes.io/docs/tasks/job/automated-tasks-with-cron-jobs/#schedule
hubble.tls.ca object {"cert":"","key":""} base64 encoded PEM values for the Hubble CA certificate and private key.
hubble.tls.ca.key string "" The CA private key (optional). If it is provided, then it will be used by hubble.tls.auto.method=cronJob to generate all other certificates. Otherwise, a ephemeral CA is generated if hubble.tls.auto.enabled=true.
hubble.tls.enabled bool true Enable mutual TLS for listenAddress. Setting this value to false is highly discouraged as the Hubble API provides access to potentially sensitive network flow metadata and is exposed on the host network.
hubble.tls.server object {"cert":"","key":""} base64 encoded PEM values for the Hubble server certificate and private key
hubble.ui.backend.image object {"pullPolicy":"Always","repository":"quay.io/cilium/hubble-ui-backend","tag":"latest"} Hubble-ui backend image.
hubble.ui.backend.resources object {}
hubble.ui.enabled bool false
hubble.ui.frontend.image object {"pullPolicy":"Always","repository":"quay.io/cilium/hubble-ui","tag":"latest"} Hubble-ui frontend image.
hubble.ui.frontend.resources object {}
hubble.ui.ingress object {"annotations":{},"enabled":false,"hosts":["chart-example.local"],"tls":[]} hubble-ui ingress configuration.
hubble.ui.nodeSelector object {} Node labels for pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
hubble.ui.podAnnotations object {} Annotations to be added to hubble-ui pods
hubble.ui.podLabels object {} Labels to be added to hubble-ui pods
hubble.ui.proxy.image object {"pullPolicy":"Always","repository":"docker.io/envoyproxy/envoy","tag":"v1.14.5"} Hubble-ui ingress proxy image.
hubble.ui.proxy.resources object {}
hubble.ui.replicas int 1
hubble.ui.rollOutPods bool false Roll out Hubble-ui pods automatically when configmap is updated.
hubble.ui.securityContext.enabled bool true
hubble.ui.tolerations list [] Node tolerations for pod assignment on nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
hubble.ui.updateStrategy object {"rollingUpdate":{"maxUnavailable":1},"type":"RollingUpdate"} hubble-ui update strategy.
identityAllocationMode string "crd"
image object {"digest":"","pullPolicy":"Always","repository":"quay.io/cilium/cilium","tag":"latest","useDigest":false} Agent container image.
imagePullSecrets string nil Configure image pull secrets for pulling container images
installIptablesRules bool true
ipMasqAgent object {"enabled":false} Configure the eBPF-based ip-masq-agent
ipam.mode string "cluster-pool" Configure IP Address Management mode. ref: https://docs.cilium.io/en/stable/concepts/networking/ipam/
ipam.operator.clusterPoolIPv4MaskSize int 24 IPv4 CIDR mask size to delegate to individual nodes for IPAM.
ipam.operator.clusterPoolIPv4PodCIDR string "10.0.0.0/8" IPv4 CIDR range to delegate to individual nodes for IPAM.
ipam.operator.clusterPoolIPv6MaskSize int 120 IPv6 CIDR mask size to delegate to individual nodes for IPAM.
ipam.operator.clusterPoolIPv6PodCIDR string "fd00::/104" IPv6 CIDR range to delegate to individual nodes for IPAM.
ipv4.enabled bool true Enable IPv4 support.
ipv6.enabled bool false Enable IPv6 support.
ipvlan.enabled bool false Enable the IPVLAN datapath
k8s object {} Configure Kubernetes specific configuration
keepDeprecatedLabels bool false requireIPv6PodCIDR enables waiting for Kubernetes to provide the PodCIDR range via the Kubernetes node resource requireIPv6PodCIDR: false -- Keep the deprecated selector labels when deploying Cilium DaemonSet
keepDeprecatedProbes bool false Keep the deprecated probes when deploying Cilium DaemonSet
kubeProxyReplacement string "probe" Configure the kube-proxy replacement in Cilium BPF datapath Valid options are "disabled", "probe", "partial", "strict". ref: https://docs.cilium.io/en/stable/gettingstarted/kubeproxy-free/
kubeProxyReplacementHealthzBindAddr string "" healthz server bind address for the kube-proxy replacement. To enable set the value to '0.0.0.0:10256' for all ipv4 addresses and this '[::]:10256' for all ipv6 addresses. By default it is disabled.
l7Proxy bool true Enable Layer 7 network policy.
localRedirectPolicy bool false
logSystemLoad bool false
maglev object {} Configure maglev consistent hashing
monitor object {"enabled":false} Specify the CIDR for native routing (ie to avoid IP masquerade for). This value corresponds to the configured cluster-cidr. nativeRoutingCIDR: -- Configure cilium-monitor sidecar
name string "cilium" Agent container name.
nodePort object {"autoProtectPortRange":true,"bindProtection":true,"enableHealthCheck":true,"enabled":false} Configure service load balancing loadBalancer: algorithm is the name of the load balancing algorithm for backend selection e.g. random or maglev algorithm: "random" mode is the operation mode of load balancing for remote backends e.g. snat, dsr, hybrid mode: snat acceleration is the option to accelerate service handling via XDP e.g. native, disabled acceleration: disabled
nodePort.autoProtectPortRange bool true Append NodePort range to ip_local_reserved_ports if clash with ephemeral ports is detected.
nodePort.bindProtection bool true Port range to use for NodePort services. range: "30000,32767" -- Set to true to prevent applications binding to service ports.
nodePort.enableHealthCheck bool true Enable healthcheck nodePort server for NodePort services
nodePort.enabled bool false Enable the Cilium NodePort service implementation.
nodeinit.bootstrapFile string "/tmp/cilium-bootstrap-time" bootstrapFile is the location of the file where the bootstrap timestamp is written by the node-init DaemonSet
nodeinit.enabled bool false Enable the node initialization DaemonSet
nodeinit.extraConfigmapMounts list []
nodeinit.extraEnv object {}
nodeinit.extraHostPathMounts list []
nodeinit.extraInitContainers list []
nodeinit.image object {"pullPolicy":"Always","repository":"quay.io/cilium/startup-script","tag":"62bfbe88c17778aad7bef9fa57ff9e2d4a9ba0d8"} node-init image.
nodeinit.nodeSelector object {} Node labels for nodeinit pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
nodeinit.podAnnotations object {} Annotations to be added to node-init pods
nodeinit.podDisruptionBudget object {"enabled":true,"maxUnavailable":2} PodDisruptionBudget settings ref: https://kubernetes.io/docs/concepts/workloads/pods/disruptions/
nodeinit.podLabels object {} Labels to be added to node-init pods
nodeinit.priorityClassName string ""
nodeinit.resources object {"requests":{"cpu":"100m","memory":"100Mi"}} nodeinit resource limits & requests ref: https://kubernetes.io/docs/user-guide/compute-resources/
nodeinit.securityContext object {} Security context to be added to nodeinit pods
nodeinit.tolerations list [{"operator":"Exists"}] Node tolerations for nodeinit scheduling to nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
nodeinit.updateStrategy object {"type":"RollingUpdate"} node-init update strategy
operator.affinity object {"podAntiAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":[{"labelSelector":{"matchExpressions":[{"key":"io.cilium/app","operator":"In","values":["operator"]}]},"topologyKey":"kubernetes.io/hostname"}]}} cilium-operator affinity
operator.enabled bool true Enable the cilium-operator component (required).
operator.endpointGCInterval string "5m0s"
operator.extraArgs list [] Additional cilium-operator container arguments
operator.extraConfigmapMounts list []
operator.extraEnv object {}
operator.extraHostPathMounts list [] Additional cilium-operator hostPath mounts
operator.extraInitContainers list [] Additional InitContainers to initialize the pod
operator.identityGCInterval string "15m0s"
operator.identityHeartbeatTimeout string "30m0s"
operator.image object {"awsDigest":"","azureDigest":"","genericDigest":"","pullPolicy":"Always","repository":"quay.io/cilium/operator","suffix":"","tag":"latest","useDigest":false} cilium-operator image.
operator.nodeSelector object {} Node labels for cilium-operator pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
operator.podAnnotations object {} Annotations to be added to cilium-operator pods
operator.podDisruptionBudget object {"enabled":false,"maxUnavailable":1} PodDisruptionBudget settings ref: https://kubernetes.io/docs/concepts/workloads/pods/disruptions/
operator.podLabels object {} Labels to be added to cilium-operator pods
operator.priorityClassName string "" cilium-operator priorityClassName
operator.prometheus object {"enabled":false,"port":6942,"serviceMonitor":{"enabled":false}} Enable prometheus metrics for cilium-operator on the configured port at /metrics
operator.prometheus.serviceMonitor.enabled bool false Enable service monitors. This requires the prometheus CRDs to be available (see https://github.com/prometheus-operator/prometheus-operator/blob/master/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml)
operator.replicas int 2 Number of replicas to run for the cilium-operator deployment
operator.resources object {} cilium-operator resource limits & requests ref: https://kubernetes.io/docs/user-guide/compute-resources/
operator.rollOutPods bool false Roll out cilium-operator pods automatically when configmap is updated.
operator.securityContext object {} Security context to be added to cilium-operator pods
operator.serviceAccountName string "cilium-operator" For using with an existing serviceAccount.
operator.tolerations list [{"operator":"Exists"}] Node tolerations for cilium-operator scheduling to nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
operator.updateStrategy object {"rollingUpdate":{"maxSurge":1,"maxUnavailable":1},"type":"RollingUpdate"} cilium-operator update strategy
podAnnotations object {} Annotations to be added to agent pods
podDisruptionBudget object {"enabled":true,"maxUnavailable":2} PodDisruptionBudget settings ref: https://kubernetes.io/docs/concepts/workloads/pods/disruptions/
podLabels object {} Labels to be added to agent pods
policyEnforcementMode string "default"
pprof.enabled bool false Enable Go pprof debugging
preflight.enabled bool false Enable Cilium pre-flight resources (required for upgrade)
preflight.extraConfigmapMounts list []
preflight.extraEnv object {}
preflight.extraHostPathMounts list []
preflight.extraInitContainers list []
preflight.image object {"digest":"","pullPolicy":"Always","repository":"quay.io/cilium/cilium","tag":"latest","useDigest":false} Cilium pre-flight image.
preflight.nodeSelector object {} Node labels for preflight pod assignment ref: https://kubernetes.io/docs/user-guide/node-selection/
preflight.podAnnotations object {} Annotations to be added to preflight pods
preflight.podDisruptionBudget object {"enabled":true,"maxUnavailable":2} PodDisruptionBudget settings ref: https://kubernetes.io/docs/concepts/workloads/pods/disruptions/
preflight.podLabels object {}
preflight.priorityClassName string ""
preflight.resources object {} preflight resource limits & requests ref: https://kubernetes.io/docs/user-guide/compute-resources/
preflight.securityContext object {} Security context to be added to preflight pods
preflight.tofqdnsPreCache string ""
preflight.tolerations list [{"effect":"NoSchedule","key":"node.kubernetes.io/not-ready"},{"effect":"NoSchedule","key":"node-role.kubernetes.io/master"},{"effect":"NoSchedule","key":"node.cloudprovider.kubernetes.io/uninitialized","value":"true"},{"key":"CriticalAddonsOnly","operator":"Exists"}] Node tolerations for preflight scheduling to nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
preflight.updateStrategy object {"type":"RollingUpdate"} preflight update strategy
preflight.validateCNPs bool true By default we should always validate the installed CNPs before upgrading Cilium. This will make sure the user will have the policies deployed in the cluster with the right schema.
priorityClassName string ""
prometheus object {"enabled":false,"metrics":null,"port":9090,"serviceMonitor":{"enabled":false}} Configure prometheus metrics on the configured port at /metrics
prometheus.metrics string nil Metrics that should be enabled or disabled from the default metric list. (+metric_foo to enable metric_foo , -metric_bar to disable metric_bar). ref: https://docs.cilium.io/en/stable/operations/metrics/#exported-metrics
prometheus.serviceMonitor.enabled bool false Enable service monitors. This requires the prometheus CRDs to be available (see https://github.com/prometheus-operator/prometheus-operator/blob/master/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml)
proxy object {"prometheus":{"enabled":true,"port":"9095"},"sidecarImageRegex":"cilium/istio_proxy"} Configure Istio proxy options.
proxy.sidecarImageRegex string "cilium/istio_proxy" Regular expression matching compatible Istio sidecar istio-proxy container image names
rbac.create bool true Enable creation of Resource-Based Access Control configuration.
remoteNodeIdentity bool true Enable use of the remote node identity. ref: https://docs.cilium.io/en/v1.7/install/upgrade/#configmap-remote-node-identity
resourceQuotas object {"cilium":{"hard":{"pods":"10k"}},"enabled":false,"operator":{"hard":{"pods":"15"}}} Enable resource quotas for priority classes used in the cluster.
resources object {} Agent resource limits & requests ref: https://kubernetes.io/docs/user-guide/compute-resources/
rollOutCiliumPods bool false Roll out cilium agent pods automatically when configmap is updated.
securityContext object {} Security context to be added to agent pods
serviceAccounts object Component's fully qualified name. Define serviceAccount names for components.
serviceAccounts.clustermeshcertgen object {"annotations":{},"create":true,"name":"clustermesh-apiserver-generate-certs"} Clustermeshcertgen is used if clustermesh.apiserver.tls.auto.method=cronJob
serviceAccounts.hubblecertgen object {"annotations":{},"create":true,"name":"hubble-generate-certs"} Hubblecertgen is used if hubble.tls.auto.method=cronJob
sleepAfterInit bool false
sockops object {"enabled":false} Configure BPF socket operations configuration
tls.enabled bool true
tls.secretsBackend string "local"
tolerations list [{"operator":"Exists"}] Node tolerations for agent scheduling to nodes with taints ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/
tunnel string "vxlan" Configure the encapsulation configuration for communication between nodes. Possible values: - disabled - vxlan (default) - geneve
updateStrategy object {"rollingUpdate":{"maxUnavailable":2},"type":"RollingUpdate"} Cilium agent update strategy