Kubernetes Cloud Controller Manager for Hetzner Cloud

The Hetzner Cloud cloud-controller-manager integrates your Kubernetes cluster with the Hetzner Cloud & Robot APIs.

• 🚀 See the quick start guide to get you started.
• 📖 See the configuration reference for the available configuration.

For more information, see the documentation.

To set up a development environment, make sure you installed the following tools:

• tofu
• k3sup
• docker
• skaffold

1. Configure a HCLOUD_TOKEN in your shell session.

2. Deploy the development cluster:

3. Load the generated configuration to access the development cluster:

4. Check that the development cluster is healthy:

5. Start developing hcloud-cloud-controller-manager in the development cluster:

On code change, skaffold will rebuild the image, redeploy it and print all logs.

⚠️ Do not forget to clean up the development cluster once you are finished:

To run the unit tests, make sure you installed the following tools:

• Go

1. Run the following command to run the unit tests:

Before running the e2e tests, make sure you followed the Setup a development environment steps.

1. Run the kubernetes e2e tests using the following command:

If you want to work on the Robot support, you need to make some changes to the above setup.

This requires that you have a Robot Server in the same account you use for the development. The server needs to be setup with the Ansible Playbook dev/robot/install.yml and configured in dev/robot/install.yml.

1. Set these environment variables:

2. Continue with the environment setup until you reach the skaffold step. Run skaffold dev --profile=robot instead.

3. We have another suite of tests for Robot. You can run these with:

The Load Balancer annotation reference is autogenerated via a custom written tool. This tool can be found at tools/doc_generation.go.

The docstring format contains a description, starting with the constant name. The next lines can contain additional information about the annotation. Supported fields are:

• Type: Specifies the type of the annotation. If the annotation is an enum, all possible values need to be separated via a pipe symbol |.
• Default: Specifies the default value of the annotation. When no default value is set, - is displayed.
• Read-only: Specifies whether the annotation is read-only or not. If the annotation is read-only, it will be set by the HCCM and cannot be set by the user.
• Internal: Specifies whether the annotation is for internal use only. If the annotation is internal, it will not be displayed in the reference documentation.

Apache License, Version 2.0