DEVELOPMENT.md

Development recommendations

Before continuing, make sure you've read the README

Development tools

This is a (probably incomplete) list of software used to develop the operator:

• golang >= v1.21 ...the operator is written in it...
• operator-sdk Provides all the plumbing and project structure
• pre-commit Used to ensure all files are formatted, generated code is up to date and more
• gofumpt Used for code formatting
• golangci-lint Lints for go code

Some additional software you may find useful:

• virter can create virtual machines (for example a virtual kubernetes cluster)

Commit hooks

Commit hooks ensure that all new and changed code is formatted and tested before committing. To set up commit hooks install pre-commit (see above) and run:

$ pre-commit install

Now, if you try to commit a file that for example is not properly formatted, you will receive a message like:

$ git commit -a -m "important fix; no time to check for errors"
Trim Trailing Whitespace.................................................Passed
Fix End of Files.........................................................Passed
Check Yaml...........................................(no files to check)Skipped
Check for added large files..............................................Passed
gofumpt..................................................................Failed
- hook id: gofumpt
- exit code: 1
- files were modified by this hook

version/version.go

golangci-lint............................................................Failed
- hook id: golangci-lint
- exit code: 1

Tests

Use make test to run our test suite. It will download the required control plane binaries to execute the webhook and controller tests.

For basic unit testing use the basic go test framework. If something you want to test relies on the Kubernetes API, check out the test suite for the controllers

As of right now, there is no recommended way to end-to-end test the operator. It probably involves some virtual machines running a basic kubernetes cluster.

Automated Tests

On every pull request, we run a set of tests, specified in .github/workflows. The checks include

• go test
• golandci-lint
• pre-commit run

Commits

This repository enforces Developer Certificate of Origin for every commit. Every commit needs a Signed-off-by line. You can add them by passing the -s flag to git commit:

$ git commit -s -m 'This is my commit message'