mirror of https://github.com/easzlab/kubeasz.git
106 lines
4.1 KiB
Markdown
106 lines
4.1 KiB
Markdown
## 06-安装flannel网络组件.md
|
||
|
||
本项目提供多种网络插件可选，如果需要安装flannel，请在`clusters/xxxx/hosts`文件中设置变量 `CLUSTER_NETWORK="flannel"`，参考[这里](../config_guide.md)
|
||
|
||
`Flannel`是最早应用到k8s集群的网络插件之一，简单高效，且提供多个后端`backend`模式供选择；本文介绍以`DaemonSet Pod`方式集成到k8s集群，需要在所有master节点和node节点安装。
|
||
|
||
``` text
|
||
roles/flannel/
|
||
├── tasks
|
||
│ └── main.yml
|
||
└── templates
|
||
└── kube-flannel.yaml.j2
|
||
```
|
||
|
||
请在另外窗口打开`roles/flannel/tasks/main.yml`文件，对照看以下讲解内容。
|
||
|
||
### 下载基础cni 插件
|
||
|
||
项目已经自动下载基础cni插件，请参考这里 https://github.com/kubeasz/dockerfiles/blob/master/kubeasz-ext-bin/Dockerfile
|
||
|
||
- flannel用到的插件
|
||
- bridge
|
||
- flannel
|
||
- host-local
|
||
- loopback
|
||
- portmap
|
||
|
||
Flannel CNI 插件的配置文件可以包含多个`plugin` 或由其调用其他`plugin`；`Flannel DaemonSet Pod`运行以后会生成`/run/flannel/subnet.env `文件，例如：
|
||
|
||
``` bash
|
||
FLANNEL_NETWORK=10.1.0.0/16
|
||
FLANNEL_SUBNET=10.1.17.1/24
|
||
FLANNEL_MTU=1472
|
||
FLANNEL_IPMASQ=true
|
||
```
|
||
然后它利用这个文件信息去配置和调用`bridge`插件来生成容器网络，调用`host-local`来管理`IP`地址，例如：
|
||
|
||
``` bash
|
||
{
|
||
"name": "mynet",
|
||
"type": "bridge",
|
||
"mtu": 1472,
|
||
"ipMasq": false,
|
||
"isGateway": true,
|
||
"ipam": {
|
||
"type": "host-local",
|
||
"subnet": "10.1.17.0/24"
|
||
}
|
||
}
|
||
```
|
||
- 更多相关介绍请阅读：
|
||
- [flannel kubernetes 集成](https://github.com/coreos/flannel/blob/master/Documentation/kubernetes.md)
|
||
- [flannel cni 插件](https://github.com/containernetworking/plugins/tree/master/plugins/meta/flannel)
|
||
- [更多 cni 插件](https://github.com/containernetworking/plugins)
|
||
|
||
### 准备`Flannel DaemonSet` yaml配置文件
|
||
|
||
请阅读 `roles/flannel/templates/kube-flannel.yaml.j2` 内容，注意：
|
||
|
||
+ 注意：本安装方式，flannel 通过 apiserver 接口读取 podCidr 信息，详见 https://github.com/coreos/flannel/issues/847；因此想要修改节点pod网段掩码，请在`clusters/xxxx/config.yml` 中修改`NODE_CIDR_LEN`配置项
|
||
+ 配置相关RBAC 权限和 `service account`
|
||
+ 配置`ConfigMap`包含 CNI配置和 flannel配置(指定backend等)，在文件中相关设置对应
|
||
|
||
### 安装 flannel网络
|
||
|
||
+ 安装之前必须确保kube_master和kube_node节点已经成功部署
|
||
+ 轮询等待flannel 网络插件安装完成，删除之前kube_node安装时默认cni网络配置
|
||
|
||
### 验证flannel网络
|
||
|
||
执行flannel安装成功后可以验证如下：(需要等待镜像下载完成，有时候即便上一步已经配置了docker国内加速，还是可能比较慢，请确认以下容器运行起来以后，再执行后续验证步骤)
|
||
|
||
``` bash
|
||
# kubectl get pod --all-namespaces
|
||
NAMESPACE NAME READY STATUS RESTARTS AGE
|
||
kube-system kube-flannel-ds-m8mzm 1/1 Running 0 3m
|
||
kube-system kube-flannel-ds-mnj6j 1/1 Running 0 3m
|
||
kube-system kube-flannel-ds-mxn6k 1/1 Running 0 3m
|
||
```
|
||
在集群创建几个测试pod: `kubectl run test --image=busybox --replicas=3 sleep 30000`
|
||
|
||
``` bash
|
||
# kubectl get pod --all-namespaces -o wide|head -n 4
|
||
NAMESPACE NAME READY STATUS RESTARTS AGE IP NODE
|
||
default busy-5956b54c8b-ld4gb 1/1 Running 0 9m 172.20.2.7 192.168.1.1
|
||
default busy-5956b54c8b-lj9l9 1/1 Running 0 9m 172.20.1.5 192.168.1.2
|
||
default busy-5956b54c8b-wwpkz 1/1 Running 0 9m 172.20.0.6 192.168.1.3
|
||
|
||
# 查看路由
|
||
# ip route
|
||
default via 192.168.1.254 dev ens3 onlink
|
||
192.168.1.0/24 dev ens3 proto kernel scope link src 192.168.1.1
|
||
172.17.0.0/16 dev docker0 proto kernel scope link src 172.17.0.1 linkdown
|
||
172.20.0.0/24 via 192.168.1.3 dev ens3
|
||
172.20.1.0/24 via 192.168.1.2 dev ens3
|
||
172.20.2.0/24 dev cni0 proto kernel scope link src 172.20.2.1
|
||
```
|
||
在各节点上分别 ping 这三个POD IP地址，确保能通：
|
||
|
||
``` bash
|
||
ping 172.20.2.7
|
||
ping 172.20.1.5
|
||
ping 172.20.0.6
|
||
```
|
||
|