aboutsummaryrefslogtreecommitdiff
path: root/contrib/kubernetes/testscripts/README.md
blob: 9642b42a866fb5631bb597cdb9662dd484f321b2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
## Test scripts to automate kubernetes startup

Requirements:
	docker
	curl

The scripts in this directory startup kubernetes with docker as the container runtime.
After starting kubernetes, a couple of kubernetes services are started to allow automatic
testing of CoreDNS with kubernetes. The kubernetes integration tests in `test/kubernetes_test.go` depend on having some sample services running. The scripts in this folder
automate the launch of kubernetes and the creation of the expected sample services.

To start up kubernetes and launch some sample services,
run the script `start_k8s_with_services.sh`.

~~~
$ ./start_k8s_with_services.sh
~~~

Alternatively, the individual scripts may be run independently as needed:

~~~
$ ./00_run_k8s.sh && ./10_setup_kubectl.sh && ./20_setup_k8s_services.sh
~~~

After running the above scripts, kubernetes will be running on the localhost with the following services
exposed:

~~
NAMESPACE   NAME         CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
default     kubernetes   10.0.0.1     <none>        443/TCP   48m
demo        mynginx      10.0.0.168   <none>        80/TCP    9m
demo        webserver    10.0.0.28    <none>        80/TCP    2m
test        mynginx      10.0.0.4     <none>        80/TCP    2m
test        webserver    10.0.0.39    <none>        80/TCP    2m
~~


Kubernetes and all running containers can be uncerimoniously stopped by
running the `kill_all_containers.sh` script.

~~~
$ ./kill_all_containers.sh
~~~