kubernetes-basic-example

Kubernetes Basic Example

This folder contains a minimal Kubernetes resource config file to demonstrate how you can use Terratest to write automated tests for Kubernetes.

This resource file deploys an nginx container as a single pod deployment with a node port service attached to it.

See the corresponding terratest code for an example of how to test this resource config:

• kubernetes_basic_example_test.go for the most basic verification
• kubernetes_basic_example_service_check_test.go for a more advanced version of checking the service.

Deploying the Kubernetes resource

1. Setup a Kubernetes cluster. We recommend using a local version:

   • minikube
   • Kubernetes on Docker For Mac
   • Kubernetes on Docker For Windows

2. Install and setup kubectl to talk to the deployed Kubernetes cluster.

3. Run kubectl apply -f nginx-deployment.yml

Running automated tests against this Kubernetes deployment

1. Setup a Kubernetes cluster. We recommend using a local version:

   • minikube
   • Kubernetes on Docker For Mac
   • Kubernetes on Docker For Windows

2. Install and setup kubectl to talk to the deployed Kubernetes cluster.

3. Install and setup kubectl.

4. Install Golang and make sure this code is checked out into your GOPATH.

5. cd test

6. dep ensure

7. go test -v -tags kubernetes -run TestKubernetesBasicExample

8. You can also run TestKubernetesBasicExampleServiceCheck