Need help with k8s-conformance?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

637 Stars 636 Forks Apache License 2.0 1.9K Commits 11 Opened issues


🧪CNCF K8s Conformance Working Group

Services available


Need anything else?

Contributors list

Conformance Tests per Release



release document contains a list of conformance tests required for that release of Kubernetes. The goal of these files is to help the Kubernetes community understand the range of tests required for a release to be conformant. Refer to SIG-Architecture: Conformance Testing in Kubernetes for details around the testing requirements.

Generating Release Documents

The conformance test documentation can be generated using the script This script uses the code under test/conformance in combination with a release branch of kubernetes/kubernetes to generate the final release document in this folder. Only releases from 1.18 onwards can be created this way.

Before you run this, make sure your local Kubernetes repo is on a clean branch as the script will need to switch to the requested release branch.

An example of creating the documentation for release 1.21.

cd k8s-conformance/docs
export KUBE_ROOT=$HOME/go/src/
export VERSION=1.21

Script output

Note: switching to 'v1.21.0'.

You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by switching back to a branch.

If you want to create a new branch to retain commits you create, you may do so (now or later) by using -c with the switch command. Example:

git switch -c

Or undo this operation with:

git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at cb303e613a1 Release commit for Kubernetes v1.21.0

  • (HEAD detached at v1.21.0) master

+++ [0506 09:55:59] Building go targets for linux/amd64: vendor/ test/e2e/e2e.test

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.