Skip to content

Commit ee962e5

Browse files
update documentation on deploying OVN K8s with KIND
Signed-off-by: Geo Turcsanyi <[email protected]>
1 parent abc2b83 commit ee962e5

File tree

1 file changed

+14
-4
lines changed

1 file changed

+14
-4
lines changed

docs/installation/launching-ovn-kubernetes-on-kind.md

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,16 @@ KIND (Kubernetes in Docker) deployment of OVN kubernetes is a fast and easy mean
1818
- jq
1919
- openssl
2020
- openvswitch
21+
- Go 1.23.0 or above
2122
22-
**NOTE :** In certain operating systems such as CentOS 8.x, pip2 and pip3 binaries are installed instead of pip. In such situations create a softlink for "pip" that points to "pip2".
23+
**NOTE :** In certain operating systems such as CentOS 8.x, pip2 and pip3 binaries are installed instead of pip. In such situations create a softlink for "pip" that points to "pip2".
2324
2425
For OVN kubernetes KIND deployment, use the `kind.sh` script.
2526
2627
First Download and build the OVN-Kubernetes repo:
2728
2829
```
29-
git clone github.com/ovn-org/ovn-kubernetes;
30+
git clone https://github.com/ovn-kubernetes/ovn-kubernetes.git;
3031
cd ovn-kubernetes
3132
```
3233
The `kind.sh` script builds OVN-Kubernetes into a container image. To verify
@@ -53,6 +54,13 @@ $ ./kind.sh
5354
$ popd
5455
```
5556
57+
**NOTE:** If you run into issues with installing jinjanate on Ubuntu due to [PEP-0668](https://peps.python.org/pep-0668/) you can work around via:
58+
```
59+
sudo apt-get install pipx
60+
pipx install jinjanator[yaml]
61+
pipx ensurepath
62+
```
63+
5664
### Run the KIND deployment with podman
5765
5866
To verify local changes, the steps are mostly the same as with docker, except the `fedora` make target:
@@ -80,12 +88,14 @@ To deploy KIND however, you need to start it as root and then copy root's kube c
8088
$ pushd contrib
8189
$ sudo ./kind.sh -ep podman
8290
$ sudo cp /root/ovn.conf ~/.kube/kind-config
83-
$ sudo chown $(id -u):$(id -g) ~/.kube/kind-config
91+
$ sudo chown $(id -u):$(id -g) -R ~/.kube
8492
$ export KUBECONFIG=~/.kube/kind-config
8593
$ popd
8694
```
8795
88-
This will launch a KIND deployment. By default the cluster is named `ovn`.
96+
**NOTE:** If you installed go via the official path on Linux and have encountered the "go: command not found" issue, you can preserve your environment when doing sudo: `sudo --preserve-env=PATH ./kind.sh -ep podman`
97+
98+
This will launch a KIND deployment. By default, the cluster is named `ovn`.
8999
90100
```
91101
$ kubectl get nodes

0 commit comments

Comments
 (0)