zhangxiaoyu-zidif
239 lines
7.7 KiB
Markdown
239 lines
7.7 KiB
Markdown
---
|
||
approvers:
|
||
- thockin
|
||
title: CentOS
|
||
---
|
||
|
||
* TOC
|
||
{:toc}
|
||
|
||
## 警告
|
||
|
||
本文档适用于Kubernetes 1.1.0，目前已经被[废弃](https://github.com/kubernetes/website/issues/1613)。相关内容请参阅最新版[指南](/docs/getting-started-guides/kubeadm/)。
|
||
|
||
## 前提条件
|
||
|
||
在CentOS上部署和配置Kubernetes，您需要在集群中拥有一台机器作为master节点，并拥有至少一台运行CentOS 7系统的主机作为集群节点（node）。
|
||
|
||
## 启动一个集群
|
||
|
||
本文档是一篇基于CentOS系统部署和配置Kubernetes的入门指南，内容涵盖一个手工的配置，以便于您了解所有的底层软件包、服务以及端口等信息。
|
||
|
||
Kubernetes由一系列服务构成，包括kube-apiserver、kube-scheduler、kube-controller-manager、kubelet以及kube-proxy等。这些服务由systemd管理，配置集中位于/etc/kubernetes。我们将在集群中的不同主机上部署不同的服务。其中，第一台主机，即centos-master，将被部署成为Kubernetes集群中的master节点。这台主机上将运行kube-apiserver、kube-controller-manager和kube-scheduler。 此外，master节点还将运行 _etcd_。集群中剩余的主机，即centos-minion-n节点，将运行kubelet、proxy、cadvisor和docker。
|
||
|
||
集群中的所有节点将运行flanneld来构建网络（networking overlay）。
|
||
|
||
**系统信息：**
|
||
|
||
主机：
|
||
|
||
请使用您真实环境中的信息替换以下配置中的各个主机IP
|
||
|
||
```conf
|
||
centos-master = 192.168.121.9
|
||
centos-minion-1 = 192.168.121.65
|
||
centos-minion-2 = 192.168.121.66
|
||
centos-minion-3 = 192.168.121.67
|
||
```
|
||
|
||
**配置主机环境：**
|
||
|
||
* 在集群所有节点上——centos-{master,minion-n}，创建包含以下配置信息的/etc/yum.repos.d/virt7-docker-common-release.repo文件。
|
||
|
||
```conf
|
||
[virt7-docker-common-release]
|
||
name=virt7-docker-common-release
|
||
baseurl=http://cbs.centos.org/repos/virt7-docker-common-release/x86_64/os/
|
||
gpgcheck=0
|
||
```
|
||
|
||
* 在集群所有节点上——centos-{master,minion-n}，安装Kubernetes、etcd和flanneld。这一过程也将同时在节点上安装docker和cadvisor。
|
||
|
||
```shell
|
||
yum -y install --enablerepo=virt7-docker-common-release kubernetes etcd flannel
|
||
```
|
||
|
||
* 将master节点和其他节点的主机名——IP映射添加到所有集群节点的/etc/hosts文件中（如果主机名已经在DNS中记录，则可略过此步）
|
||
|
||
```shell
|
||
echo "192.168.121.9 centos-master
|
||
192.168.121.65 centos-minion-1
|
||
192.168.121.66 centos-minion-2
|
||
192.168.121.67 centos-minion-3" >> /etc/hosts
|
||
```
|
||
|
||
* 编辑/etc/kubernetes/config文件以保证在集群所有主机上都包含以下内容：
|
||
|
||
```shell
|
||
# logging to stderr意为从systemd journal获取日志
|
||
KUBE_LOGTOSTDERR="--logtostderr=true"
|
||
|
||
# journal消息级别, 0代表debug
|
||
KUBE_LOG_LEVEL="--v=0"
|
||
|
||
# 是否允许集群运行privileged docker containers
|
||
KUBE_ALLOW_PRIV="--allow-privileged=false"
|
||
|
||
# 配置replication conrtoller和scheduler所需的kube-apiserver地址
|
||
KUBE_MASTER="--master=http://centos-master:8080"
|
||
```
|
||
|
||
* 由于docker与一些防火墙规则不兼容，需要在master节点及其他集群节点上禁用防火墙。在CentOS系统上，需要首先禁用SELinux，进而才能禁用防火墙。
|
||
|
||
```shell
|
||
setenforce 0
|
||
systemctl disable iptables-services firewalld
|
||
systemctl stop iptables-services firewalld
|
||
```
|
||
|
||
**配置master节点上的Kubernetes服务**
|
||
|
||
* 编辑/etc/etcd/etcd.conf文件内容如下：
|
||
|
||
```shell
|
||
# [member]
|
||
ETCD_NAME=default
|
||
ETCD_DATA_DIR="/var/lib/etcd/default.etcd"
|
||
ETCD_LISTEN_CLIENT_URLS="http://0.0.0.0:2379"
|
||
|
||
#[cluster]
|
||
ETCD_ADVERTISE_CLIENT_URLS="http://0.0.0.0:2379"
|
||
```
|
||
|
||
* 编辑/etc/kubernetes/apiserver文件内容如下：
|
||
|
||
```shell
|
||
# 本地服务器监听地址
|
||
KUBE_API_ADDRESS="--address=0.0.0.0"
|
||
|
||
# 本地服务器监听端口
|
||
KUBE_API_PORT="--port=8080"
|
||
|
||
# Kubelet监听端口
|
||
KUBELET_PORT="--kubelet-port=10250"
|
||
|
||
# 以逗号间隔的etcd集群中各个节点的地址
|
||
KUBE_ETCD_SERVERS="--etcd-servers=http://centos-master:2379"
|
||
|
||
# Kubernetes服务IP地址网段
|
||
KUBE_SERVICE_ADDRESSES="--service-cluster-ip-range=10.254.0.0/16"
|
||
|
||
# 请添加您需要的Kubernetes API Server启动参数
|
||
KUBE_API_ARGS=""
|
||
```
|
||
|
||
* 启动ETCD并保存master节点的网络设置（network overlay configuration）：
|
||
**警告** 请根据您的真实环境配置网络信息！在本文环境中，`172.30.0.0/16`网段是可用的。
|
||
|
||
```shell
|
||
systemctl start etcd
|
||
etcdctl mkdir /kube-centos/network
|
||
etcdctl mk /kube-centos/network/config "{ \"Network\": \"172.30.0.0/16\", \"SubnetLen\": 24, \"Backend\": { \"Type\": \"vxlan\" } }"
|
||
```
|
||
|
||
* 在master节点上配置/etc/sysconfig/flanneld文件使用flannel覆盖Docker网络 (需要在其他集群节点上完成相同配置，详见下文):
|
||
|
||
```shell
|
||
# Flanneld配置选项
|
||
|
||
# etcd url地址，指向运行etcd的服务器
|
||
FLANNEL_ETCD_ENDPOINTS="http://centos-master:2379"
|
||
|
||
# etcd配置秘钥，即flannel查询的配置秘钥
|
||
# 用于网段分配
|
||
FLANNEL_ETCD_PREFIX="/kube-centos/network"
|
||
|
||
# 其它需要的Flannel启动参数
|
||
#FLANNEL_OPTIONS=""
|
||
```
|
||
|
||
* 在master节点上启动相关服务：
|
||
|
||
```shell
|
||
for SERVICES in etcd kube-apiserver kube-controller-manager kube-scheduler flanneld; do
|
||
systemctl restart $SERVICES
|
||
systemctl enable $SERVICES
|
||
systemctl status $SERVICES
|
||
done
|
||
```
|
||
|
||
**在集群其他节点上配置Kubernetes服务**
|
||
|
||
***我们需要在集群其他节点上配置kubelet，启动kubelet和proxy服务***
|
||
|
||
* 编辑/etc/kubernetes/kubelet文件内容如下：
|
||
|
||
```shell
|
||
# info server的服务地址
|
||
KUBELET_ADDRESS="--address=0.0.0.0"
|
||
|
||
# info server的监听端口
|
||
KUBELET_PORT="--port=10250"
|
||
|
||
# 本字段可以设置空值以使用真实的主机名
|
||
# 注意节点序号（n）
|
||
KUBELET_HOSTNAME="--hostname-override=centos-minion-n"
|
||
|
||
# api-server地址
|
||
KUBELET_API_SERVER="--api-servers=http://centos-master:8080"
|
||
|
||
# 添加您所需要的Kubelet参数
|
||
KUBELET_ARGS=""
|
||
```
|
||
|
||
* 在所有节点上配置/etc/sysconfig/flanneld文件设置使用flannel覆盖Docker网络：
|
||
|
||
```shell
|
||
# Flanneld配置选项
|
||
|
||
# etcd url地址，指向运行etcd的服务器
|
||
FLANNEL_ETCD_ENDPOINTS="http://centos-master:2379"
|
||
|
||
# etcd配置秘钥，即flannel查询的配置秘钥
|
||
# 用于网段分配
|
||
FLANNEL_ETCD_PREFIX="/kube-centos/network"
|
||
|
||
# 其他需要配置的选项
|
||
#FLANNEL_OPTIONS=""
|
||
```
|
||
|
||
* 在节点上启动相关服务（centos-minion-n）
|
||
|
||
```shell
|
||
for SERVICES in kube-proxy kubelet flanneld docker; do
|
||
systemctl restart $SERVICES
|
||
systemctl enable $SERVICES
|
||
systemctl status $SERVICES
|
||
done
|
||
```
|
||
* 配置kubectl
|
||
|
||
```shell
|
||
kubectl config set-cluster default-cluster --server=http://centos-master:8080
|
||
kubectl config set-context default-context --cluster=default-cluster --user=default-admin
|
||
kubectl config use-context default-context
|
||
```
|
||
|
||
*至此，Kubernetes在CentOS集群中的部署已经完成 ！*
|
||
|
||
* 在centos-master节点上通过kubectl命令检查所有的Kubernetes节点已经到位
|
||
|
||
```shell
|
||
$ kubectl get nodes
|
||
NAME STATUS AGE VERSION
|
||
centos-minion-1 Ready 3d v1.6.0+fff5156
|
||
centos-minion-2 Ready 3d v1.6.0+fff5156
|
||
centos-minion-3 Ready 3d v1.6.0+fff5156
|
||
```
|
||
|
||
**现在，Kubernetes集群已经正常运行！可以创建测试pod验证集群了！**
|
||
|
||
## 支持级别
|
||
|
||
|
||
IaaS Provider | Config. Mgmt | OS | Networking | Docs | Conforms | Support Level
|
||
-------------------- | ------------ | ------ | ---------- | --------------------------------------------- | ---------| ----------------------------
|
||
Bare-metal | custom | CentOS | flannel | [docs](/docs/getting-started-guides/centos/centos_manual_config) | | Community ([@coolsvap](https://github.com/coolsvap))
|
||
|
||
有关所有解决方案的支持级别信息，请参阅[解决方案列表](/docs/getting-started-guides/#table-of-solutions)。
|