kots-lint

kots-lint is a service used for linting Replicated KOTS yaml files.

Linting with this service includes:

• Detecting YAML syntax errors
• Validating with Kubeval
• Utilizing OPA to lint for best practices and some special errors and warnings

Using the production API

$ tar cvf - path/to/folder | curl -XPOST --data-binary @- https://lint.replicated.com/v1/lint

To lint our example

$ tar cvf - example/files-to-lint | curl -XPOST --data-binary @- https://lint.replicated.com/v1/lint

Development

Development for the applications in this project is done through Okteto.

Debugging Rego files

Rego supports the use of print() function. To enable printing to stderr, add EnablePrintStatements and PrintHook to initialization code. For example:

	buildersQuery, err := rego.New(
		rego.Query("data.kots.spec.builders.lint"),
		rego.Module("builders-opa.rego", string(buildersRegoContent)),

		// The lines below allow using print() in the rego code to print to stderr
		rego.EnablePrintStatements(true),
		rego.PrintHook(topdown.NewPrintHook(os.Stderr)),
	).PrepareForEval(ctx)

Setup

1. Install the Okteto CLI (brew install okteto)
2. Setup Okteto CLI (okteto context create https://replicated.okteto.dev)
3. Setup Okteto context in kubectl (okteto context update-kubeconfig)
4. Deploy your current branch. (from the Vandoor root directory: okteto pipeline deploy)

The project can also be run with Skaffold for local development and testing.

$ skaffold dev

Once skaffold runs successfully, the service can be reached at http://localhost:30082/v1/lint

Run tests

Tests can be run manually with

$ make test

Updating specs

The make schemas command can be used to automatically update all Replicated schemas:

$ make schemas

This will update schemas for:

• KOTS (github.com/replicatedhq/kotskinds)
• Troubleshoot (github.com/replicatedhq/troubleshoot)
• Embedded Cluster (github.com/replicatedhq/embedded-cluster)

Updating Kubernetes specs

make schemas-kubernetes

This will update the schemas for the Kubernetes VERSION specified in the Makefile.