Lokomotive

Setup

Install a Lokomotive v1.17.x cluster on AWS, Packet, or bare-metal.

To install, first define a configuration in a cluster.lokocfg file. Here's an AWS config example.

variable "ssh_keys" {
  type = "list"
  default = [
    "ssh-rsa AAAAB3Nz...",
  ]
}

cluster "aws" {
  asset_dir = "./assets"

  cluster_name = "conformance"
  enable_aggregation = true

  os_channel = "stable"

  dns_zone = "example.com"
  dns_zone_id = "Z..."

  # Change SSH Public keys
  ssh_pubkeys = var.ssh_keys

  worker_pool "conformance-pool" {
    count = 2
    ssh_pubkeys = var.ssh_keys
  }
}

Get the lokoctl binary for v0.1.0:

curl -L 'https://github.com/kinvolk/lokomotive/releases/download/v0.1.0/lokoctl_0.1.0_linux_amd64.tar.gz' -O
tar xvf lokoctl_0.1.0_linux_amd64.tar.gz

Apply the configuration.

lokoctl_0.1.0_linux_amd64/lokoctl cluster apply

To get the full conformance tests passing you need to

• Enable aggregation with enable_aggregation = true.
• Allow inbound NodePort (30000-32767) traffic via firewall rules.

Use the generated kubeconfig to check the cluster is ready.

$ export KUBECONFIG=./assets/cluster-assets/auth/kubeconfig
$ kubectl get nodes
NAME             STATUS   ROLES    AGE   VERSION
ip-10-0-0-120    Ready    <none>   6m    v1.17.4
ip-10-0-27-200   Ready    <none>   5m    v1.17.4
ip-10-0-33-203   Ready    <none>   5m    v1.17.4

Conformance tests

Use sonobuoy.

go get -u -v github.com/vmware-tanzu/sonobuoy
sonobuoy run
sonobuoy status
outfile=$(sonobuoy retrieve)
mkdir ./results; tar xzf $outfile -C ./results

Inspect the results in plugins/e2e/results/{e2e.log,junit_01.xml}.