Skip to content

crossplane/conformance

This branch is 1 commit ahead of main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2d6a2bf · Dec 15, 2023

History

57 Commits
Jun 12, 2021
Apr 29, 2021
May 3, 2021
May 11, 2021
May 11, 2021
Jun 12, 2021
May 6, 2021
Apr 29, 2021
Apr 29, 2021
May 4, 2021
Apr 28, 2021
May 3, 2021
May 14, 2021
May 11, 2021
May 11, 2021
May 3, 2021
May 3, 2021
Dec 15, 2023
Apr 30, 2021

Repository files navigation

Crossplane Conformance Suite

A Sonobuoy plugin to assess Crossplane conformance. To try it, first download the sonobuoy CLI, then:

# The version of Crossplane you wish to conform with.
CROSSPLANE_VERSION=1.2

# To determine whether a Crossplane distribution is conformant. The distribution
# must be pre-installed on the cluster where Sonobuoy will run.
sonobuoy run --wait --plugin https://raw.githubusercontent.com/crossplane/conformance/release-${CROSSPLANE_VERSION}/plugin-crossplane.yaml
sonobuoy results $(sonobuoy retrieve) -m dump

# To determine whether a Crossplane provider is conformant. The provider must be
# pre-installed on the cluster where Sonobuoy will run, and must be the only
# provider installed on the cluster.
sonobuoy run --wait --plugin https://raw.githubusercontent.com/crossplane/conformance/release-${CROSSPLANE_VERSION}/plugin-provider.yaml
sonobuoy results $(sonobuoy retrieve) -m dump

Note that the provider conformance tests require some advanced setup. The test requires that at least one of each kind of managed resource exists and is ready (in the status condition sense).

This repository maintains a branch for each version of Crossplane that the conformance test suite supports. For example branch release-1.2 will test conformance with Crossplane 1.2.x. The docker image that powers the conformance suite also derives its version from the version of Crossplane it corresponds to. Tags are of the form 1.2.0-cf.1, where 1.2.x is the target version of Crossplane, and cf.1 is the version of the conformance test.

Note that the conformance tests are not typically sensitive to Crossplane patch releases. That is, in most cases when Crossplane 1.2.1 is released the conformance test suite's version will not be bumped accordingly, and will remain at 1.2.0-cf.X. In the unlikely event that a Crossplane patch release necessitates a conformance test suite update the patch version of the test suite will be updated to match the Crossplane patch version. The image referenced by the distribution and provider plugins in any particular release branch is always the authoritative conformance test for that major and minor version of Crossplane.

About

A Sonobuoy plugin to assess @crossplane conformance.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages