Kubernetes Host Scope

cilium IPAM的kubernetes host-scope模式通过选项ipam: kubernetes开启，将集群IP地址分配委托给每个独立的节点，并在每个kubernetes node的podCIDR范围内分配IP地址。

kubernetes host模式下，cilium agent会等待kubernetes的v1.Node对象通过以下任意一种办法告知podCIDR的地址族范围后后再完成启动：

1. 通过 v1.Node的资源域

域	描述
spec.podCIDRs	IPv4 and/or IPv6 PodCIDR 范围
spec.podCIDR	IPv4 or IPv6 PodCIDR 范围

kube-controler-manager 的 --allocate-node-cidrs选项用于告诉kubernetes 为PodCIDR准备的地址范围。

2. 通过v1.Nodeannotation

Annotation	描述
io.cilium.network.ipv4-pod-cidr	IPv4 PodCIDR 范围
io.cilium.network.ipv6-pod-cidr	IPv6 PodCIDR 范围
io.cilium.network.ipv4-cilium-host	IPv4 address of the cilium host interface
io.cilium.network.ipv6-cilium-host	IPv6 address of the cilium host interface
io.cilium.network.ipv4-health-ip	IPv4 address of the cilium-health endpoint
io.cilium.network.ipv6-health-ip	IPv6 address of the cilium-health endpoint

基于注释的机制主要与不支持spec.podCIDRs但支持IPv4和IPv6的旧版本Kubernetes结合使用。

配置

下面两种方式用于配置kubernetes host-scope 模式IPAM。

1. ConfigMap

• ipam: kubernetes：启用 kubernetes host-scope 模式IPAM。开启模式时如果配置了enable-ipv4: true选项会自动启用k8s-require-ipv4-pod-cidr；如果配置了enable-ipv6则会自动启用 k8s-require-ipv6-pod-cidr。
• k8s-require-ipv4-pod-cidr: true: 通知cilium agent等待，直到v1.Node资源的IPV4 PodCIDR 可用。
• k8s-require-ipv6-pod-cidr: true: 通知cilium agent等待，直到v1.Node资源的IPV6 PodCIDR 可用。

2. Helm

在helm中可使用下面的选项来实现ConfigMap的能力：

• ipam: kubernetes: --set ipam.mode=kubernetes.
• k8s-require-ipv4-pod-cidr: true: --set k8s.requireIPv4PodCIDR=true, 需要和 --set ipam.mode=kubernetes选项配合使用。
• k8s-require-ipv6-pod-cidr: true: --set k8s.requireIPv6PodCIDR=true, 需要和 --set ipam.mode=kubernetes选项配合使用。