Document AWS VPC requirements for private node IPs
- Dominant language
- SCSS
- Stars
- 19
- Forks
- 117
- Avg merge
- 13h 29m
- Merged PRs (30d)
- 13
Description
When using private node IPs (the default in KKP 2.23.0 since https://github.com/kubermatic/dashboard/pull/5938 (!)), the target VPC and its subnets in AWS need to fulfil certain criteria. We need to document those criteria.
As far as I could say from a Friday afternoon experiment, the following needs to be given:
- For each availability zone that is planned to be used, a private subnet in the AWS VPC. This means the VPC has no internet gateway associated in the route table.
- For each private subnet, a public subnet counterpart in the same availability zone needs to exist. This means that per AZ, you need two subnets. This public subnet needs to have an internet gateway.
- Per private subnet, a NAT Gateway needs to exist in the **public** subnet counterpart.
- Per private subnet, a custom route table needs to route `0.0.0.0/0` to the NAT Gateway in the public subnet in the same AZ.
If any of those are not given, nodes either do not join the cluster due to lack of internet access or creating a `LoadBalancer` service doesn't work (the ELB needs a public subnet in the same AZ to route traffic to the nodes in the private subnet).
For dualstack, additional requirements (egress only gateway?) might be necessary.
Contributor guide
Research direction
Use the AWS private-node IP requirements in the issue and dashboard pull request #5938 as context. Locate the appropriate KKP documentation entry point, document the per-AZ subnet, NAT Gateway, route-table, and LoadBalancer constraints, and resolve or explicitly scope the dualstack question. Done when users can configure a qualifying VPC without relying on the issue text.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- aws
- Domain
- cloud, documentation, infrastructure
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100