Conformance results for v1.26/kubeone (#2462)

Signed-off-by: Marko Mudrinić <mudrinic.mare@gmail.com>

v1.26/kubeone/PRODUCT.yaml

@@ -0,0 +1,10 @@
+vendor: Kubermatic
+name: KubeOne
+version: v1.6.0
+website_url: https://kubeone.io
+repo_url: https://github.com/kubermatic/kubeone
+documentation_url: https://docs.kubermatic.com/kubeone/v1.6/
+product_logo_url: https://raw.githubusercontent.com/kubermatic/kubeone/master/docs/img/kubeone-stacked.svg
+type: installer
+description: "Kubermatic KubeOne automate cluster operations on all your cloud, on-prem, edge, and IoT environments."
+contact_email_address: support@kubermatic.com

v1.26/kubeone/README.md

@@ -0,0 +1,141 @@
+# KubeOne
+
+https://github.com/kubermatic/kubeone
+
+Official documentation: https://docs.kubermatic.com/kubeone/v1.6/
+
+By following these steps you may reproduce the KubeOne Conformance e2e results.
+
+## Downloading KubeOne
+
+The latest version of KubeOne can be downloaded from the 
+[GitHub Releases][kubeone-releases]. In order to manage Kubernetes v1.26
+clusters, KubeOne v1.6.0 or newer is required.
+
+The KubeOne binary comes along with Terraform configurations that can be used
+to create the needed infrastructure for all supported providers.
+The configurations can be found in the `./examples/terraform` directory.
+
+## Creating infrastructure
+
+In order to install Kubernetes using KubeOne, you need the infrastructure on
+which you'll install and provision the Kubernetes control plane.
+
+You can create the infrastructure manually or use the provided
+[Terraform configurations][terraform-config].
+
+In case you decide to use Terraform, you need to install Terraform v1.0+ by
+following the [official installation instructions][terraform-install].
+
+You can find more details about provisioning the infrastructure using Terraform
+and our example Terraform configurations in the
+[Using Terraform configs guide][kubeone-terraform].
+
+### Using the provided AWS Terraform configuration
+
+First, switch to the directory containing the Terraform configuration for AWS:
+
+```
+cd ./examples/terraform/aws
+```
+
+Initialize the Terraform working directory:
+
+```
+terraform init
+```
+
+Create the `terraform.tfvars` file and define the following variables:
+
+```
+cluster_name = "k8s-conformance" # name of the cluster
+
+ssh_public_key_file = "~/.ssh/id_rsa.pub" # ssh key to be deployed on instances
+```
+
+With the `terraform.tfvars` file in the place, create the infrastructure by
+running the following Terraform command:
+
+```
+terraform apply
+```
+
+The command will show what steps will be taken and will ask for the user
+confirmation. Once asked, type `yes` to proceed with the creation. It takes
+2-3 minutes to create the infrastructure.
+
+Finally, save the Terraform output by running the following command.
+The Terraform output is parsed by KubeOne to determine the information about
+the infrastructure.
+
+```
+terraform output -json > tf.json
+```
+
+## Provisioning the cluster
+
+Once you have the needed infrastructure and instances, you will need a KubeOne
+configuration manifest which describes the desired cluster.
+
+If you used the provided Terraform configurations to provision the
+infrastructure, KubeOne can read the Terraform's output to find out information
+about the infrastructure and information needed to create worker nodes.
+Otherwise, you need to provide those information manually. 
+You can run `kubeone config print -f` for the configuration file reference.
+
+You can use the following configuration manifest:
+
+```yaml
+apiVersion: kubeone.k8c.io/v1beta2
+kind: KubeOneCluster
+versions:
+  kubernetes: 1.26.1
+cloudProvider:
+  aws: {}
+```
+
+The cluster is provisioned using the following command, where `kubeone.yaml`
+is the configuration manifest and `tf.json` is output from the
+`terraform output -json` command:
+
+```
+kubeone apply --manifest kubeone.yaml -t tf.json --auto-approve
+```
+
+**Note:** If you are getting errors related to SSH, please check the
+[SSH requirements document][kubeone-ssh].
+
+Once the command is done, export the `KUBECONFIG` variable to point to the
+appropriate kubeconfig file. The kubeconfig file is automatically downloaded
+by KubeOne. It's named as `<cluster-name>-kubeconfig` (e.g. in our case
+`k8s-conformance-kubeconfig`).
+
+```
+export KUBECONFIG=$(pwd)/k8s-conformance-kubeconfig
+```
+
+Wait several minutes for the worker nodes to get created and joined the
+cluster. You can check the progress by running `kubectl get nodes`.
+There should be 3 control plane nodes and 3 worker nodes ready.
+
+Finally, run the conformance tests using Sonobuoy.
+You can find the instructions for running conformance tests [here][sonobuoy].
+
+## Cleanup
+
+Before destroying the infrastructure, run the following command
+to destroy the worker nodes and revert what has been done by KubeOne:
+
+```
+kubeone reset --manifest kubeone.yaml -t tf.json --auto-approve
+```
+
+Then proceed to destroy the infrastructure. If you used Terraform,
+that can be done by running the `terraform destroy` command.
+
+[kubeone-releases]: https://github.com/kubermatic/kubeone/releases
+[terraform-config]: https://github.com/kubermatic/kubeone/tree/release/v1.6/examples/terraform
+[terraform-install]: https://learn.hashicorp.com/tutorials/terraform/install-cli
+[kubeone-terraform]: https://docs.kubermatic.com/kubeone/v1.6/guides/using-terraform-configs/
+[kubeone-ssh]: https://docs.kubermatic.com/kubeone/v1.6/guides/ssh/
+[sonobuoy]: https://github.com/cncf/k8s-conformance/blob/master/instructions.md#running