Conformance results for v1.12/typhoon (#356)

v1.12/typhoon/PRODUCT.yaml

@@ -0,0 +1,8 @@
+vendor: Poseidon
+name: Typhoon
+version: v1.12.1
+website_url: https://typhoon.psdn.io/
+documentation_url: https://typhoon.psdn.io/
+product_logo_url: https://storage.googleapis.com/poseidon/typhoon.png
+type: distro
+description: Minimal and free Kubernetes distribution via Terraform 

v1.12/typhoon/README.md

@@ -0,0 +1,72 @@
+# Typhoon
+
+## Setup
+
+Install a Typhoon Kubernetes v1.12.1 cluster on [bare-metal](https://typhoon.psdn.io/cl/bare-metal/), [AWS](https://typhoon.psdn.io/cl/aws/), or [Google Cloud](https://typhoon.psdn.io/cl/google-cloud/). You may pick any OS + platform combination marked [stable](https://github.com/poseidon/typhoon#modules).
+
+Define a cluster at v1.12.1 and `terraform apply`. Example:
+
+```
+module "google-cloud-yavin" {
+  source = "git::https://github.com/poseidon/typhoon//google-cloud/container-linux/kubernetes?ref=v1.12.1"
+
+  providers = {
+    google   = "google.default"
+    local    = "local.default"
+    null     = "null.default"
+    template = "template.default"
+    tls      = "tls.default"
+  }
+
+  # Google Cloud
+  cluster_name  = "yavin"
+  region        = "us-central1"
+  dns_zone      = "example.com"
+  dns_zone_name = "example-zone"
+
+  # configuration
+  ssh_authorized_key = "ssh-rsa AAAAB3Nz..."
+  asset_dir          = "/home/user/.secrets/clusters/yavin"
+
+  # optional
+  worker_count = 2
+}
+```
+
+Use the generated `kubeconfig` from `ASSETS_DIR/auth/kubeconfig`.
+
+```
+$ export KUBECONFIG=/home/user/.secrets/clusters/yavin/auth/kubeconfig
+$ kubectl get nodes
+NAME                                          STATUS   AGE    VERSION
+yavin-controller-0.c.example-com.internal     Ready    6m     v1.12.1
+yavin-worker-jrbf.c.example-com.internal      Ready    5m     v1.12.1
+yavin-worker-mzdm.c.example-com.internal      Ready    5m     v1.12.1
+```
+
+## Reproduce Conformance Results
+
+### curl
+
+Run the sonobuoy conformance tests using curl piped to kubectl.
+
+```
+curl -L https://github.com/cncf/k8s-conformance/blob/master/sonobuoy-conformance.yaml
+```
+
+Follow the [instructions](https://github.com/cncf/k8s-conformance/blob/master/instructions.md#running) to `kubectl cp` results from `plugins/e2e/results{e2e.log,junit.xml}`.
+
+
+### sonobuoy tool
+
+Alternately, use the `sonobuoy` command line tool (requires Go).
+
+```
+go get -u -v github.com/heptio/sonobuoy
+sonobuoy run
+sonobuoy status
+sonobuoy retrieve .
+mkdir ./results; tar xzf *.tar.gz -C ./results
+```
+
+Inspect the results in `plugins/e2e/results/{e2e.log,junit.xml}`.