Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hetznercloud/csi-driver
Kubernetes Container Storage Interface driver for Hetzner Cloud Volumes
https://github.com/hetznercloud/csi-driver
csi csi-driver csi-plugin hetzner-cloud hetzner-cloud-volumes kubernetes kubernetes-volumes
Last synced: 6 days ago
JSON representation
Kubernetes Container Storage Interface driver for Hetzner Cloud Volumes
- Host: GitHub
- URL: https://github.com/hetznercloud/csi-driver
- Owner: hetznercloud
- License: mit
- Created: 2018-12-19T13:26:16.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T12:21:42.000Z (3 months ago)
- Last Synced: 2024-10-29T13:27:03.122Z (3 months ago)
- Topics: csi, csi-driver, csi-plugin, hetzner-cloud, hetzner-cloud-volumes, kubernetes, kubernetes-volumes
- Language: Go
- Homepage:
- Size: 1.02 MB
- Stars: 639
- Watchers: 20
- Forks: 103
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-swarm - Hetzner Cloud Volume CSI Driver - Hetzner Cloud Volume CSI Driver with experimental support for Docker Swarm. (Community Tools / Volumes and Storage)
- awesome-hcloud - hcloud-csi
- awesome-starred - hetznercloud/csi-driver - Kubernetes Container Storage Interface driver for Hetzner Cloud Volumes (kubernetes)
README
# Container Storage Interface driver for Hetzner Cloud
[](https://github.com/hetznercloud/csi-driver/actions)
[](https://codecov.io/github/hetznercloud/csi-driver/tree/main)
This is a [Container Storage Interface](https://github.com/container-storage-interface/spec) driver for Hetzner Cloud
enabling you to use ReadWriteOnce Volumes within Kubernetes & other Container
Orchestrators. Please note that this driver **requires Kubernetes 1.19 or newer**.
## Getting Started
Depending on your Container Orchestrator you need to follow different steps to
get started with the Hetzner Cloud csi-driver. You can also find other docs
relevant to that Container Orchestrator behind the link:
- [Kubernetes](./docs/kubernetes/README.md#getting-started)
- [Docker Swarm](./docs/docker-swarm/README.md)️ _⚠️ Not officially supported_
- [HashiCorp Nomad](./docs/nomad/README.md)️ _⚠️ Not officially supported_
## Development
### Setup a development environment
To setup a development environment, make sure you installed the following tools:
- [tofu](https://opentofu.org/)
- [k3sup](https://github.com/alexellis/k3sup)
- [docker](https://www.docker.com/)
- [skaffold](https://skaffold.dev/)
1. Configure a `HCLOUD_TOKEN` in your shell session.
> [!WARNING]
> The development environment runs on Hetzner Cloud servers which will induce costs.
2. Deploy the development cluster:
```sh
make -C dev up
```
3. Load the generated configuration to access the development cluster:
```sh
source dev/files/env.sh
```
4. Check that the development cluster is healthy:
```sh
kubectl get nodes -o wide
```
5. Start developing the CSI driver in the development cluster:
```sh
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:
```sh
make -C dev down
```
### Run the docker e2e tests
To run the integrations tests, make sure you installed the following tools:
- [docker](https://www.docker.com/)
1. Run the following command to run the integrations tests:
```sh
go test -v -tags integration ./test/integration
```
### Run the kubernetes e2e tests
The Hetzner Cloud CSI driver is tested against the official kubernetes e2e tests.
Before running the integrations tests, make sure you followed the [Setup a development environment](#setup-a-development-environment) steps.
1. Run the kubernetes e2e tests using the following command:
```sh
make -C test/e2e/kubernetes test
```
## License
MIT license