diff --git a/cn/docs/getting-started-guides/centos/centos_manual_config.md b/cn/docs/getting-started-guides/centos/centos_manual_config.md new file mode 100644 index 0000000000..cfa79aa370 --- /dev/null +++ b/cn/docs/getting-started-guides/centos/centos_manual_config.md @@ -0,0 +1,238 @@ +--- +assignees: +- thockin +title: CentOS +--- + +* TOC +{:toc} + +## 警告 + +本文档适用于Kubernetes 1.1.0，目前已经被[废弃](https://github.com/kubernetes/kubernetes.github.io/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)。