kubermatic / kubermatic/docs

Document AWS VPC requirements for private node IPs

Open
#1,495 1 comment 0 reactions 0 assignees View on GitHub
kind/documentation
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.