Skip to content

Commit d595240

Browse files
authored
add installation guide for Talos (#256)
Signed-off-by: zhangzujian <[email protected]>
1 parent 2708bb5 commit d595240

File tree

3 files changed

+89
-0
lines changed

3 files changed

+89
-0
lines changed

docs/start/talos-install.en.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Deploy Kube-OVN on Talos Linux
2+
3+
[Talos Linux](https://github.com/siderolabs/talos) is a modern Linux distribution built for Kubernetes。
4+
5+
## Deploy Kube-OVN via Helm Chart
6+
7+
You can deploy Kube-OVN on Talos Linux clusters with the following command:
8+
9+
```shell
10+
helm install kube-ovn kubeovn/kube-ovn --wait \
11+
--set OVN_DIR=/var/lib/ovn \
12+
--set OPENVSWITCH_DIR=/var/lib/openvswitch \
13+
--set DISABLE_MODULES_MANAGEMENT=true \
14+
--set cni_conf.MOUNT_LOCAL_BIN_DIR=false
15+
```
16+
17+
If you want to use underlay as the default network, you need to pass the relevant chart values. Here is an example:
18+
19+
```shell
20+
helm install kubeovn kubeovn/kube-ovn --wait \
21+
--set OVN_DIR=/var/lib/ovn \
22+
--set OPENVSWITCH_DIR=/var/lib/openvswitch \
23+
--set DISABLE_MODULES_MANAGEMENT=true \
24+
--set cni_conf.MOUNT_LOCAL_BIN_DIR=false \
25+
--set networking.NETWORK_TYPE=vlan \
26+
--set networking.vlan.VLAN_INTERFACE_NAME=enp0s5f1 \
27+
--set networking.vlan.VLAN_ID=0 \
28+
--set networking.NET_STACK=ipv4 \
29+
--set-json networking.EXCLUDE_IPS='"172.99.99.11..172.99.99.99"' \
30+
--set-json ipv4.POD_CIDR='"172.99.99.0/24"' \
31+
--set-json ipv4.POD_GATEWAY='"172.99.99.1"'
32+
```
33+
34+
!!! note
35+
The network interface used by the default underlay network need to be ignored in the Talos machine configuration before deploying Kube-OVN. Here is an example:
36+
```yaml
37+
machine:
38+
network:
39+
interfaces:
40+
- interface: enp0s5f1
41+
ignore: true
42+
```

docs/start/talos-install.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# 在 Talos Linux 上部署 Kube-OVN
2+
3+
[Talos Linux](https://github.com/siderolabs/talos) 是为 Kubernetes 构建的现代 Linux 发行版。
4+
5+
## 通过 Helm Chart 部署 Kube-OVN
6+
7+
您可以通过以下命令在 Talos Linux 集群上部署 Kube-OVN:
8+
9+
```shell
10+
helm install kube-ovn kubeovn/kube-ovn --wait \
11+
--set OVN_DIR=/var/lib/ovn \
12+
--set OPENVSWITCH_DIR=/var/lib/openvswitch \
13+
--set DISABLE_MODULES_MANAGEMENT=true \
14+
--set cni_conf.MOUNT_LOCAL_BIN_DIR=false
15+
```
16+
17+
如果您希望使用 Underlay 作为默认网络,可以通过 Helm 命令传入相关的 Chart 参数。示例如下:
18+
19+
```shell
20+
helm install kubeovn kubeovn/kube-ovn --wait \
21+
--set OVN_DIR=/var/lib/ovn \
22+
--set OPENVSWITCH_DIR=/var/lib/openvswitch \
23+
--set DISABLE_MODULES_MANAGEMENT=true \
24+
--set cni_conf.MOUNT_LOCAL_BIN_DIR=false \
25+
--set networking.NETWORK_TYPE=vlan \
26+
--set networking.vlan.VLAN_INTERFACE_NAME=enp0s5f1 \
27+
--set networking.vlan.VLAN_ID=0 \
28+
--set networking.NET_STACK=ipv4 \
29+
--set-json networking.EXCLUDE_IPS='"172.99.99.11..172.99.99.99"' \
30+
--set-json ipv4.POD_CIDR='"172.99.99.0/24"' \
31+
--set-json ipv4.POD_GATEWAY='"172.99.99.1"'
32+
```
33+
34+
!!! note
35+
Underlay 使用的网卡需要在部署 Kube-OVN 前在 Talos 配置中将其设置为 ignore。示例如下:
36+
```yaml
37+
machine:
38+
network:
39+
interfaces:
40+
- interface: enp0s5f1
41+
ignore: true
42+
```

mkdocs.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ nav:
1111
- 一键安装: "start/one-step-install.md"
1212
- Underlay 网络安装: "start/underlay.md"
1313
- 使用 Sealos 一键部署 Kubernetes 和 Kube-OVN: "start/sealos-install.md"
14+
- 在 Talos Linux 上部署 Kube-OVN: "start/talos-install.md"
1415
- 卸载: "start/uninstall.md"
1516
- 使用指南:
1617
- 安装和配置选项: "guide/setup-options.md"
@@ -62,6 +63,7 @@ nav:
6263
- 使用 Submariner 进行多集群互联: "advance/with-submariner.md"
6364
- Overlay 下路由方式网络打通: "advance/overlay-with-route.md"
6465
- BGP 支持: "advance/with-bgp.md"
66+
- 使用 MetalLB 与 Kube-OVN Underlay 集成: "advance/with-metallb.md"
6567
- Cilium 集成: "advance/with-cilium.md"
6668
- Cilium NetworkPolicy 支持: "advance/cilium-networkpolicy.md"
6769
- Cilium 网络流量观测: "advance/cilium-hubble-observe.md"
@@ -126,6 +128,7 @@ theme:
126128
- content.action.edit
127129
- content.action.view
128130
markdown_extensions:
131+
- admonition
129132
- footnotes
130133
- fenced_code
131134
- attr_list
@@ -208,6 +211,7 @@ plugins:
208211
使用 OVN-IC 进行多集群互联: Cluster Inter-Connection with OVN-IC
209212
使用 Submariner 进行多集群互联: Cluster Inter-Connection with Submariner
210213
BGP 支持: BGP Support
214+
使用 MetalLB 与 Kube-OVN Underlay 集成: Integrating MetalLB with Kube-OVN Underlay
211215
Cilium 集成: Integration with Cilium
212216
Cilium NetworkPolicy 支持: Cilium NetworkPolicy Support
213217
Cilium 网络流量观测: Cilium Network Traffic Observation
@@ -244,6 +248,7 @@ plugins:
244248
默认 VPC NAT 策略规则: Default VPC NAT Policy Rule
245249
调整日志等级: Change Log Level
246250
使用 Sealos 一键部署 Kubernetes 和 Kube-OVN: Use Sealos to Deploy Kubernetes and Kube-OVN
251+
在 Talos Linux 上部署 Kube-OVN: Deploy Kube-OVN on Talos Linux
247252
版本管理: Release Management
248253
Annotation 使用说明: Annotation Usage
249254
VM 固定 IP: Fixed VM IP

0 commit comments

Comments
 (0)