Skip to content

Commit a9ebea3

Browse files
committed
Add documentation for alias IP ranges feature
1 parent d8b369f commit a9ebea3

File tree

2 files changed

+35
-0
lines changed

2 files changed

+35
-0
lines changed

docs/book/src/SUMMARY.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,9 @@
1616
- [Enabling](./clusterclass/enabling.md)
1717
- [Disabling](./clusterclass/disabling.md)
1818
- [General Topics](./topics/index.md)
19+
- [Alias IP Ranges](./topics/alias-ip-ranges.md)
1920
- [Conformance](./topics/conformance.md)
21+
- [GPUs](./topics/gpus.md)
2022
- [Machine Locations](./topics/machine-locations.md)
2123
- [Preemptible VMs](./topics/preemptible-vms.md)
2224
- [Developer Guide](./developers/index.md)
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Alias IP Ranges
2+
3+
Configure secondary IP ranges for instances via the `aliasIPRanges` field in `GCPMachineTemplate`.
4+
5+
This enables CNI plugins like Cilium to use [Native Routing](https://docs.cilium.io/en/stable/network/concepts/routing/#google-cloud) by allocating pod and service IPs from the alias ranges.
6+
7+
```yaml
8+
---
9+
apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
10+
kind: GCPMachineTemplate
11+
metadata:
12+
name: mygcpmachinetemplate
13+
namespace: mynamespace
14+
spec:
15+
template:
16+
spec:
17+
image: projects/myproject/global/images/myimage
18+
instanceType: n1-standard-2
19+
aliasIPRanges:
20+
- ipCidrRange: /24
21+
subnetworkRangeName: pods
22+
- ipCidrRange: 10.96.0.0/16
23+
subnetworkRangeName: services
24+
```
25+
26+
The `ipCidrRange` accepts:
27+
- CIDR notation: `10.0.0.0/24`
28+
- IP address only: `10.0.0.1`
29+
- Netmask only: `/24`
30+
31+
The `subnetworkRangeName` is optional and references a secondary IP range configured on the subnet.
32+
33+
https://cloud.google.com/vpc/docs/alias-ip

0 commit comments

Comments
 (0)