Awesome
<!-- SPDX-License-Identifier: MIT -->garm-operator
<!-- toc -->- โจ What is the <code>garm-operator</code>?
- ๐ Versioning
- ๐ Installation
- ๐ป Development
- ๐ ADRs
- Contributing
- Code of Conduct
- License
- Provider Information
โจ What is the garm-operator
?
garm-operator
is a Kubernetesยฎ operator that manages the lifecycle of garm objects by creating/updating/deleting corresponding objects in the Kubernetes cluster.
๐ Versioning
Garm Version
garm-operator uses garm-api-client
to talk
with garm
servers. The supported garm
server version is determined by garm-api-client
.
[!WARNING]
garm-operator
is currently tested withgarm
server versionv0.1.4
. Newer versions are not guaranteed to work.
garm
server version>v0.1.4
introduces a few breaking changes. provider and credential configuration has moved away from being defined in thegarm
server configuration. Instead, they are now defined via thegarm
API itself. This feature set isn't implemented in thegarm-operator
yet.
Kubernetes Version
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.
๐ Installation
Prerequisites
- A Kubernetes cluster you want to deploy the
garm-operator
. - As we use
ValidatingWebhooks
for validation,cert-manager
must be installed. (You can find the installation instructions here). - You need to have a
garm
server up and running and reachable from within the Kubernetes cluster you want to deploy thegarm-operator
.
Deployment
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
Custom Resources
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
.
๐ป Development
For local development, please read the development guide.
๐ ADRs
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.
Contributing
We welcome any contributions. If you want to contribute to this project, please read the contributing guide.
Code of Conduct
Please read our Code of Conduct as it is our base for interaction.
License
This project is licensed under the MIT LICENSE.
Provider Information
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.