The Piraeus Operator manages LINSTOR clusters in Kubernetes.
All components of the LINSTOR software stack can be managed by the operator:
- DRBD
- LINSTOR
- LINSTOR CSI driver
- LINSTOR High-Availability Controller
The previous version of Piraeus Operator is still available here.
If you are currently using Piraeus Operator v1, please continue to use it. It will be maintained, receiving updates to fix issues or new software versions until a stable upgrade path to v2 is available.
To deploy Piraeus Operator v2, first make sure to deploy cert-manager
$ kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.10.0/cert-manager.yaml
Then, deploy the Operator from this repository:
$ kubectl apply --server-side -k "https://github.com/piraeusdatastore/piraeus-operator//config/default?ref=v2"
# Verify the operator is running:
$ kubectl get pods -n piraeus-datastore
NAME READY STATUS RESTARTS AGE
piraeus-operator-piraeus-operator-748c57bb8d-65cvw 2/2 Running 0 55s
Now you can create a basic storage cluster by applying the LinstorCluster
resource.
$ kubectl apply -f - <<EOF
apiVersion: piraeus.io/v1
kind: LinstorCluster
metadata:
name: linstorcluster
spec: {}
EOF
We are currently working on improving our documentation. Additional tutorials and explanation will be added soon.
Tutorials help you get started with Piraeus Operator.
How-To Guides show you how to configure a specific aspect or achieve a specific task with Piraeus Operator.
The API Reference for the Piraeus Operator. Contains documentation of the LINSTOR related resources that the user can modify or observe.
These are features that are currently present in Operator v1, and not yet available in this version of Operator v2:
- Backup of LINSTOR database before upgrades
Please see the dedicated UPGRADE document
If you'd like to contribute, please visit https://github.com/piraeusdatastore/piraeus-operator and look through the issues to see if there is something you'd like to work on. If you'd like to contribute something not in an existing issue, please open a new issue beforehand.
If you'd like to report an issue, please use the issues interface in this project's github page.
This project is built using the operator-sdk. Please refer to the documentation for the sdk.
Apache 2.0