50 lines
1.0 KiB
Markdown
50 lines
1.0 KiB
Markdown
|
|
# 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.
|