Project Syn: Lieutenant Operator
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
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.
Deployment
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/
.
Development
The Operator is implemented using Kubebuilder.
There are many make
targets available.
Run make help
to get a list of relevant targets.
Contributing and license
This library is licensed under BSD-3-Clause.
For information about how to contribute see CONTRIBUTING.