Knop, Kubernetes Nodejs OPerators made easy

Getting started

# install cli
npm install -g knop-cli

# or using knop-cli with npx
npx -p knop-cli knop

# create an operator projet into my-operator directory (package name)
npx -p knop-cli knop new operator --name MyOperator

# add a controlled crd (api)
npx -p knop-cli knop new api --api-version svc.docaposte.cloud/v1alpha1 --kind Elasticsearch

# add the corresponding crd controller (api)
npx -p knop-cli knop new crd-controller --api-version svc.docaposte.cloud/v1alpha1 --kind Elasticsearch

# run operator in dev mode
npm run dev

Development

Scripts

npm run dev : start operator locally (uses ~/.kube/config for connecting to cluster)
npm run dk:build : Build docker operator image
npm run clean : remove artifacts (coverage, tmp, compiled files)
npm run test : run tests (jest)
npm run test:watch : run tests with watching
npm run lint : check code with eslint
npm run build : build (compile) operator sources files
npm run build:watch : build with watching

Generators

Operator

Generate a new node project for an operator

knop new operator --name "MyOperator"

only name is required.

parameter	value
name	Humanized operator name, (underscore + dash for package name)
orgName	Humanized Organization name
org	npm organization
repo	git repository
dockerRepo	docker repository

Api (CRD)

Generate a new CRD (yaml files & types)

knop new api --api-version svc.docaposte.cloud/v1alpha1 --kind Elasticsearch

api-version & kind are required

parameter	value
api-version	kubernetes api version with group (ex svc.docaposte.cloud/v1alpha1)
kind	kubernetes kind

CRD Controller

Generate a new CRD Controller, handle CR create/update/delete with deduplication (dosent fire if CR doesn't change)

knop new crd-controller --api-version svc.docaposte.cloud/v1alpha1 --kind Elasticsearch

api-version & kind are required (refers to managed CRD)

parameter	value
api-version	kubernetes api version with group (ex svc.docaposte.cloud/v1alpha1)
kind	kubernetes kind

Operator Engines

KudoLikeEngine

Templating

it uses consolidate.js for agnostic templating engine support (default to handlebars)

Deployment

# In a generated application (with at least an API)
# Register CRDs first
kubectl apply -f ./deploy/crds/*_crd.yaml

# Deploy operator (need docker image)
kubectl apply -f ./deploy/*.yaml

Operator runtime Env options

Variable	Default	Info
`NODE_ENV`	null
`LOGGER_LEVEL`	`info`	see pino level
`LAST_CONFIG_ANNOTATION`	`knop.skimia.org/last-applied-configuration`	annotation used in resource for storing changes
`WATCH_NAMESPACE`	null	When deployed it take the namespace of pod
`REGISTER_CRD`	`0`	Unused now, create CRD in kubernetes at startup (update if exists)

kesslerdev/knop