• ✨ What is the garm-operator?
• 🔀 Versioning
  • Garm Version
  • Kubernetes Version
• 🚀 Installation
  • Prerequisites
  • Deployment
• 💻 Development
• 📋 ADRs
• Contributing
• Code of Conduct
• License
• Provider Information

garm-operator is a Kubernetes® operator that manages the lifecycle of garm objects by creating/updating/deleting corresponding objects in the Kubernetes cluster.

garm-operator uses garm-api-client to talk with garm servers. The supported garm server version is determined by garm-api-client.

garm-operator uses client-go to talk with Kubernetes clusters. The supported Kubernetes cluster version is determined by client-go. The compatibility matrix for client-go and Kubernetes cluster can be found here.

1. A Kubernetes cluster you want to deploy the garm-operator.
2. As we use ValidatingWebhooks for validation, cert-manager must be installed. (You can find the installation instructions here).
3. You need to have a garm server up and running and reachable from within the Kubernetes cluster you want to deploy the garm-operator.

We are releasing the garm-operator as container image together with the corresponding Kubernetes manifests. You can find the latest release here.

This manifests can be used to deploy the garm-operator into your Kubernetes cluster.

export GARM_OPERATOR_VERSION=<garm-operator-version>
export GARM_SERVER_URL=<garm-server-url> 
export GARM_SERVER_USERNAME=<garm-server-username>
export GARM_SERVER_PASSWORD=<garm-server-password>
export OPERATOR_WATCH_NAMESPACE=<operator-watch-namespace>
curl -L https://github.com/mercedes-benz/garm-operator/releases/download/${GARM_OPERATOR_VERSION}/garm-operator-all.yaml | envsubst | kubectl apply -f -

The full configuration parsing documentation can be found in the configuration parsing guide

The CRD documentation can be also seen via docs.crds.dev.

Folder config/samples contains few basic examples of Pools, Images and corresponding Repositories, Organizations or Enterprises.

For local development, please read the development guide.

To make some assumptions and corresponding decisions transparent, we use ADRs (Architecture Decision Records) to document them.

All ADRs can be found in the here.

We welcome any contributions. If you want to contribute to this project, please read the contributing guide.

Please read our Code of Conduct as it is our base for interaction.

This project is licensed under the MIT LICENSE.

Please visit https://www.mercedes-benz-techinnovation.com/en/imprint/ for information on the provider.

Notice: Before you use the program in productive use, please take all necessary precautions, e.g. testing and verifying the program with regard to your specific use. The program was tested solely for our own use cases, which might differ from yours.