Nosmoht / piraeus-operator

The Piraeus Operator manages LINSTOR clusters in Kubernetes.

Piraeus Operator

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

Legacy Operator

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.

Usage

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

Configuration

We are currently working on improving our documentation. Additional tutorials and explanation will be added soon.

Tutorials

Tutorials help you get started with Piraeus Operator.

How-To Guides

How-To Guides show you how to configure a specific aspect or achieve a specific task with Piraeus Operator.

API Reference

The API Reference for the Piraeus Operator. Contains documentation of the LINSTOR related resources that the user can modify or observe.

Missing features

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

Upgrading

Please see the dedicated UPGRADE document

Contributing

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.

Building and Development

This project is built using the operator-sdk. Please refer to the documentation for the sdk.

License

Apache 2.0