Repository files navigation

This is aContainer Storage Interface driver for Hetzner Cloudenabling you to use ReadWriteOnce Volumes within Kubernetes & other ContainerOrchestrators. Please note that this driverrequires Kubernetes 1.19 or newer.

Depending on your Container Orchestrator you need to follow different steps toget started with the Hetzner Cloud csi-driver. You can also find other docsrelevant to that Container Orchestrator behind the link:

• Kubernetes
• Docker Swarm️⚠️ Not officially supported
• HashiCorp Nomad️⚠️ Not officially supported

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

• tofu
• k3sup
• docker
• skaffold

1. Configure aHCLOUD_TOKEN in your shell session.

2. Deploy the development cluster:

make -C dev up

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

source dev/files/env.sh

4. Check that the development cluster is healthy:

kubectl get nodes -o wide

5. Start developing the CSI driver in the development cluster:

skaffold dev

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

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

make -C dev down

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

• docker

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

gotest -v -tags integration ./test/integration

The Hetzner Cloud CSI driver is tested against the official kubernetes e2e tests.

Before running the integrations tests, make sure you followed theSetup a development environment steps.

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

make -C test/e2e/kubernetestest

MIT license