mirror of
https://github.com/outbackdingo/kamaji.git
synced 2026-01-28 02:19:23 +00:00
71 lines
2.0 KiB
Markdown
71 lines
2.0 KiB
Markdown
# CNCF Conformance
|
|
For organizations using Kubernetes, conformance enables interoperability, consistency, and confirmability between Kubernetes installations.
|
|
|
|
The Cloud Computing Native Foundation (_CNCF_) provides the [Certified Kubernetes Conformance Program](https://www.cncf.io/certification/software-conformance/).
|
|
|
|
<p align="left" style="padding: 6px 6px">
|
|
<img src="https://raw.githubusercontent.com/cncf/artwork/master/projects/kubernetes/certified-kubernetes/versionless/color/certified-kubernetes-color.png" width="100" />
|
|
</p>
|
|
|
|
All the _“Tenant Clusters”_ built with Kamaji are CNCF conformant.
|
|
|
|
!!! note "Conformance Test Suite"
|
|
The standard set of conformance tests is currently those defined by the `[Conformance]` tag in the [kubernetes e2e](https://github.com/kubernetes/kubernetes/tree/master/test/e2e) repository.
|
|
|
|
|
|
|
|
## Running the conformance tests
|
|
|
|
The standard tool for running CNCF conformance tests is [Sonobuoy](https://github.com/vmware-tanzu/sonobuoy). Sonobuoy is
|
|
regularly built and kept up to date to execute against all currently supported versions of kubernetes.
|
|
|
|
Download a [binary release](https://github.com/vmware-tanzu/sonobuoy/releases) of the CLI.
|
|
|
|
Make sure to access your Tenant Cluster:
|
|
|
|
```
|
|
export KUBECONFIG=tenant.kubeconfig
|
|
```
|
|
|
|
Deploy a Sonobuoy pod to your Tenant Cluster with:
|
|
|
|
```
|
|
sonobuoy run --mode=certified-conformance
|
|
```
|
|
|
|
You can run the command synchronously by adding the flag `--wait` but be aware that running the conformance tests can take an hour or more.
|
|
|
|
View actively running pods:
|
|
|
|
```
|
|
sonobuoy status
|
|
```
|
|
|
|
To inspect the logs:
|
|
|
|
```
|
|
sonobuoy logs -f
|
|
```
|
|
|
|
Once `sonobuoy status` shows the run as `completed`, copy the output directory from the main Sonobuoy pod to a local directory:
|
|
|
|
```
|
|
outfile=$(sonobuoy retrieve)
|
|
```
|
|
|
|
This copies a single `.tar.gz` snapshot from the Sonobuoy pod into your local
|
|
`.` directory. Extract the contents into `./results` with:
|
|
|
|
```
|
|
mkdir ./results; tar xzf $outfile -C ./results
|
|
```
|
|
|
|
To clean up Kubernetes objects created by Sonobuoy, run:
|
|
|
|
```
|
|
sonobuoy delete
|
|
```
|
|
|
|
|
|
|