Skip to content

Commit

Permalink
docs: add description of custom kubeconfig
Browse files Browse the repository at this point in the history
  • Loading branch information
oilbeater committed May 30, 2021
1 parent f7172b7 commit 2a2160d
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 additions & 0 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ Kube-OVN includes two parts:
- Docker >= 1.12.6
- OS: CentOS 7.5/7.6/7.7, Ubuntu 16.04/18.04
- Kernel boot with `ipv6.disable=0`
- Kube-proxy to provide service discovery for kube-ovn to connect to apiserver

*NOTE*
1. Ubuntu 16.04 users should build the related ovs-2.11.1 kernel module to replace the kernel built-in module
Expand Down Expand Up @@ -158,6 +159,34 @@ You can use `--default-cidr` flags below to config default Pod CIDR or create a
--vmodule moduleSpec comma-separated list of pattern=N settings for file-filtered logging
```
### Install with customized kubeconfig
By default, Kube-OVN uses in-cluster config to init kube client. In this way, Kube-OVN relies on kube-proxy to provide service discovery to connect to Kubernetes apiserver.
To use an external or high available Kubernetes apiserver, users can use self customized kubeconfig to connect to apiserver.
1. Generate configmap from an existed kubeconfig
```bash
kubectl create -n kube-system configmap admin-conf --from-file=admin.conf
```
2. Edit `kube-ovn-controller`, `kube-ovn-cni` to use previous kubeconfig
```yaml
- args:
- --kubeconfig=/etc/kube/admin.conf

...

volumeMounts:
- mountPath: /etc/kube
name: kubeconfig
volumes:
- configMap:
defaultMode: 420
name: admin-conf
name: kubeconfig
```
## To uninstall
1. Remove Kubernetes resources:
Expand Down

0 comments on commit 2a2160d

Please sign in to comment.