kamajictl

The Kamaji CLI

Installation

go install github.com/maxgio92/kamajictl@latest

Getting started

Install Kamaji

$ kamajictl install
 ►  applying resources
 ✔  resources applied
 ◎  verifying installation
 ✔  etcd: statefulset ready
 ✔  kamaji-controller-manager: deployment ready
 ✔  Install finished

Create a TenantControlPlane

$ kamajictl create tcp foo -n default --service-type=ClusterIP --version=v1.26.1
✔  TenantControlPlane default/foo created

List all your TenantControlPlanes

$ kamajictl get tcp
┌──────────────────────────────────────────────────────────────────────┐
| NAMESPACE | NAME | VERSION | STATUS | ENDPOINT          | DATA STORE |
| default   | bar  | v1.26.1 | Ready  | 10.96.219.55:6443 | default    |
| default   | foo  | v1.26.1 | Ready  | 10.96.1.206:6443  | default    |
└──────────────────────────────────────────────────────────────────────┘

Get a TenantControlPlane's kubeconfig

$ kamajictl get kubeconfig foo -n default -o yaml
apiVersion: v1
clusters:
- cluster:
    [...]
    server: https://10.96.1.206:6443
  name: foo
contexts:
- context:
    cluster: foo
    user: kubernetes-admin
  name: kubernetes-admin@foo
current-context: kubernetes-admin@foo
kind: Config
...

Cleanup

$ kamajictl uninstall
 ►  Deleting Kamaji TCPs
 -  TCP bar/default deleted
 -  TCP foo/default deleted
 ✔  TenantControlPlanes deleted
 ►  Deleting Kamaji controller
 ✔  Kamaji controller uninstalled
 ►  Deleting Kamaji CRDs
 -  CRD datastores.kamaji.clastix.io deleted
 -  CRD tenantcontrolplanes.kamaji.clastix.io deleted
 ✔  Kamaji CRDs deleted
 ►  Deleting Kamaji webhook configurations
 -  validatingwebhookconfiguration kamaji-validating-webhook-configuration deleted
 -  mutatingwebhookconfiguration kamaji-mutating-webhook-configuration deleted
 ✔  Kamaji webhook configurations deleted
 ►  Deleting Kamaji RBAC
 -  clusterrole kamaji-manager-role deleted
 -  clusterrole kamaji-metrics-reader deleted
 -  clusterrole kamaji-proxy-role deleted
 -  clusterrolebinding kamaji-manager-rolebinding deleted
 -  clusterrolebinding kamaji-proxy-rolebinding deleted
 ✔  Kamaji RBAC deleted
 ✔  Uninstall finished

For other commands please read the documentation.

Development

Lint

make lint

Build

make build

Run tests

make test

Update the documentation

make docs