kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
website/cn/docs/getting-started-guides/centos/centos_manual_config.md

7.7 KiB
Raw Blame History

approvers title
thockin
CentOS
  • TOC {:toc}

警告

本文档适用于Kubernetes 1.1.0，目前已经被废弃。相关内容请参阅最新版指南。

前提条件

在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

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文件。
[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。
yum -y install --enablerepo=virt7-docker-common-release kubernetes etcd flannel
  • 将master节点和其他节点的主机名——IP映射添加到所有集群节点的/etc/hosts文件中（如果主机名已经在DNS中记录，则可略过此步）
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文件以保证在集群所有主机上都包含以下内容：
# 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，进而才能禁用防火墙。
setenforce 0
systemctl disable iptables-services firewalld
systemctl stop iptables-services firewalld

配置master节点上的Kubernetes服务

  • 编辑/etc/etcd/etcd.conf文件内容如下：
# [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文件内容如下：
# 本地服务器监听地址
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网段是可用的。
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网络 (需要在其他集群节点上完成相同配置，详见下文):
# Flanneld配置选项

# etcd url地址，指向运行etcd的服务器
FLANNEL_ETCD_ENDPOINTS="http://centos-master:2379"

# etcd配置秘钥，即flannel查询的配置秘钥
# 用于网段分配
FLANNEL_ETCD_PREFIX="/kube-centos/network"

# 其它需要的Flannel启动参数
#FLANNEL_OPTIONS=""
  • 在master节点上启动相关服务：
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文件内容如下：
# 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网络：
# Flanneld配置选项

# etcd url地址，指向运行etcd的服务器
FLANNEL_ETCD_ENDPOINTS="http://centos-master:2379"

# etcd配置秘钥，即flannel查询的配置秘钥
# 用于网段分配
FLANNEL_ETCD_PREFIX="/kube-centos/network"

# 其他需要配置的选项
#FLANNEL_OPTIONS=""
  • 在节点上启动相关服务（centos-minion-n）
for SERVICES in kube-proxy kubelet flanneld docker; do
    systemctl restart $SERVICES
    systemctl enable $SERVICES
    systemctl status $SERVICES
done
  • 配置kubectl
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节点已经到位
$ 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 Community (@coolsvap)

有关所有解决方案的支持级别信息，请参阅解决方案列表。