Skip to content

Commit 5c91f15

Browse files
committed
cni: document the requirement for calico ipv6 support
1 parent fa93a53 commit 5c91f15

File tree

2 files changed

+22
-0
lines changed

2 files changed

+22
-0
lines changed

docs/book/src/topics/ipv6-enabled-cluster.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,20 @@ By default, no CNI plugin is installed when provisioning a self-managed cluster.
8181

8282
You can find the guides to enable [IPv6](https://docs.tigera.io/calico/latest/networking/ipam/ipv6#ipv6) and [VXLAN](https://docs.tigera.io/calico/latest/networking/configuring/vxlan-ipip) support for Calico on their official documentation. Or you can use a customized Calico manifests [here](https://raw.githubusercontent.com/kubernetes-sigs/cluster-api-provider-aws/refs/heads/main/test/e2e/data/cni/calico_ipv6.yaml) for IPv6.
8383

84+
**Note**: If you are using Calico as the CNI provider, ensure the CNI ingress rule allows VXLAN. You can set the rule in the `AWSCluster` resource, for example:
85+
```yaml
86+
spec:
87+
network:
88+
cni:
89+
cniIngressRules:
90+
# If using Calico as CNI provider, this rule is required.
91+
# Note: Calico currently supports IPv6 with VXLAN.
92+
- description: "IPv6 VXLAN (calico)"
93+
protocol: udp
94+
fromPort: 4789
95+
toPort: 4789
96+
```
97+
8498
## IPv6 CIDR Allocations
8599

86100
### AWS-assigned IPv6 VPC CIDR

templates/cluster-template-ipv6.yaml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,14 @@ spec:
3131
loadBalancerType: nlb
3232
healthCheckProtocol: HTTPS
3333
network:
34+
cni:
35+
cniIngressRules:
36+
# If using Calico as CNI provider, this rule is required.
37+
# Note: Calico currently supports IPv6 with VXLAN.
38+
- description: "IPv6 VXLAN (calico)"
39+
protocol: udp
40+
fromPort: 4789
41+
toPort: 4789
3442
vpc:
3543
ipv6: {}
3644
region: "${AWS_REGION}"

0 commit comments

Comments
 (0)