Kubernetes Operator which implements the backend for Lieutenant API.
The operator keeps inventory about all the tenants and clusters in a SYN managed k8s cluster.
It also handles the management of some requirements like Git repositories and secret management. It can automatically populate Git repositories with template files when a new cluster is added. It will also generate a token to be used by Steward.
This repository is part of Project Syn. For documentation on Project Syn and this component, see https://syn.tools.
Documentation for this component is written using Asciidoc and Antora. It is located in the docs/ folder. The Divio documentation structure is used to organize its content.
You can use the make docs-serve
command and then browse to http://localhost:2020 to preview the documentation.
A Kustomize setup is available under config/samples/deployment
.
Example:
kubectl create ns syn-lieutenant
kubectl -n syn-lieutenant apply -k config/crd/
kubectl -n syn-lieutenant apply -k config/samples/deployment
Some example data to test the operator is available under config/samples/
.
The Operator is implemented using Kubebuilder.
There are many make
targets available.
Run make help
to get a list of relevant targets.
This library is licensed under BSD-3-Clause. For information about how to contribute see CONTRIBUTING.