feat: initial commit

2021-09-14 08:32:10 +02:00
commit 2230cc9b98
8 changed files with 368 additions and 0 deletions
@@ -0,0 +1,49 @@
+# Run Unbound environment in local K8S
+
+This is a setup for running the Unbound environment in K8S using [KinD](https://kind.sigs.k8s.io/)
+
+## Prerequisites
+
+- [KinD](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)
+- [kubectl](https://kubernetes.io/docs/tasks/tools/)
+
+## Creating the cluster
+
+Just run the following:
+
+```shell
+./setup
+```
+
+Wait for the cluster to be ready. The K8S context should be set automatically. Check what's been deployed by running:
+
+```shell
+kubectl get pod -A
+```
+
+## Stopping/starting the cluster
+
+If you need to stop the cluster to be able to use the exposed ports for other things, run:
+
+```shell
+docker stop unbound-control-plane
+```
+
+To start it again:
+
+```shell
+docker start unbound-control-plane
+```
+
+## Removing the cluster
+
+To remove the cluster completely, run:
+
+```shell
+kind delete cluster --name unbound
+```
+
+## Cleaning up retained data
+
+The setup stores data for containers in the `data`-directory. To start from scratch, stop the cluster, empty the directory
+and start the cluster again.