Resources / Subnet
Subnet
An address range (a prefix) on a VPC's Ethernet segment. Every VPC has a default subnet, named <vpc>-default, with the VPC's own prefix; members that name no subnet are in it. A subnet is an addressing and routing construct, not a security boundary: all members of a VPC share one segment; separation needs separate VPCs.
Overview
| API | network.etorm.com/v1alpha1 |
| Resource | subnets (cluster-scoped inside its cluster) |
| Short names | subnet |
| Available in | project clusters only |
| Status | written by a controller through /status |
Minimal example
apiVersion: network.etorm.com/v1alpha1
kind: Subnet
metadata:
name: example
spec:
vpcRef:
name: "<name>"
Spec
| Field | Type | Required | Default | Allowed | Description |
vpcRef | reference to VPC | yes | | | The VPC this range belongs to. Cannot be changed. |
ipv6Prefix | string | | | up to 43 characters | The subnet's IPv6 /64 with a zero host part, for example fd12:3456:789a:1::/64. Omit it to get a unique-local /64 chosen for you (it is then written here). Must not overlap the VPC's own prefix or another subnet's. Cannot be changed. |
cidr | string | | | up to 18 characters | Optional IPv4 network of the subnet, /16 to /29. Omit for an IPv6-only subnet. Must not overlap the VPC's cidr or another subnet's. Cannot be changed. |
mtu | integer | | | 576 to 1350 | Largest packet in the subnet, at most the VPC's MTU. Advertised in the subnet's router advertisements once the gateway routes between subnets. |
crossSubnet | string (one of) | | "allow" | allow, deny | What the gateway routes between this subnet and the other subnets of the same VPC: allow, or deny to block routed traffic through the gateway. Members of one VPC still share one L2 segment, so this is not isolation: isolation needs separate VPCs. Takes effect when the gateway routes between subnets; until then nothing is routed. |
Status
| Field | Type | Required | Default | Allowed | Description |
phase | string | | | | Pending until the VPC is Ready, then Ready. |
ipv6Prefix | string | | | | The subnet's effective IPv6 /64. |
ipv6Address | string | | | | The gateway's address in the subnet (<prefix>::1/64). |
gatewayAddress | string | | | | The gateway's IPv4 address in the subnet (first host of cidr), when it has one. |
default | boolean | | | | True for the subnet every VPC gets, which has the VPC's own prefix and cidr. |
conditions | list of object | | | | Detailed state, one entry per aspect; Ready says whether the subnet is usable. |
conditions[].type | string | | | | Aspect. |
conditions[].status | string | | | | True or False. |
conditions[].reason | string | | | | Machine-readable reason. |
conditions[].message | string | | | | Human-readable detail. |
Columns in listings
| Column | From |
|---|
| VPC | .spec.vpcRef.name |
| IPv6 | .spec.ipv6Prefix |
| CIDR | .spec.cidr |
| Cross-subnet | .spec.crossSubnet |
| Phase | .status.phase |
All resources