Skip to content

private-network-setup.md

Latest commit

 

History

History
46 lines (30 loc) · 2.16 KB

private-network-setup.md

File metadata and controls

46 lines (30 loc) · 2.16 KB

Private Network Setup

This guide teaches you how to setup HCCM with support for Private Networks. Please familiarize yourself with the explanation document about Private Networks.

Before setting up the hcloud-cloud-controller-manager you need to configure your cluster appropriately. When creating your cluster you need to provide the kubelet option --cloud-provider=external. How this is done depends on your Kubernetes distribution.

By default, the HCCM's route controller is enabled. For this reason, you need to choose an appropriate CNI plugin, which supports native routing capabilities of the underlying infrastructure. As an example, Cilium can be set to use the routing-mode: native.

  1. Select the appropriate IP ranges for your cluster. You can reference the explanation document.

  2. Create the Private Network from the Hetzner Cloud Console or via the hcloud-cli:

hcloud network create --name my-network --ip-range=10.0.0.0/8

  1. Add your nodes to the network.

  2. Provision your Kubernetes cluster with the Kubelet option --cloud-provider=external.

  3. Create a read+write API token in the Hetzner Cloud Console as described in this document.

  4. Create a secret containing your Hetzner Cloud API token and your Private Network ID or name:

kubectl -n kube-system create secret generic hcloud \
    --from-literal=token=<hcloud API token> \
    --from-literal=network=<hcloud network-id-or-name>
  1. Add the Helm repository:
helm repo add hcloud https://charts.hetzner.cloud
helm repo update hcloud
  1. Install the chart:
helm install hccm hcloud/hcloud-cloud-controller-manager -n kube-system \
    --set networking.enabled=true \
    --set networking.clusterCIDR=<cluster-cidr>
  1. Install your CNI plugin.