CentOS 7 使用kubeadm 部署 Kubernetes

关闭swap

执行swapoff临时关闭swap。

重启后会失效，若要永久关闭，能够编辑/etc/fstab文件，将其中swap分区一行注释掉

#/dev/mapper/centos-swap swap                    swap    defaults        0 0

安装配置docker

能够参考官方安装文档

1. 安装docker

$ yum install yum-utils device-mapper-persistent-data lvm2
$ yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo
$ yum update && yum install docker-ce-18.06.2.ce

2. docker配置

建立文件/etc/docker/daemon.json, 写入下面的内容。

{
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m"
  },
  "storage-driver": "overlay2",
  "storage-opts": [
    "overlay2.override_kernel_check=true"
  ]
}

若在国内部署，可使用国内的docker源加快拉取速度，/etc/docker/daemon.json中加入国内源。

{
  "exec-opts": ["native.cgroupdriver=systemd"],
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m"
  },
  "storage-driver": "overlay2",
  "storage-opts": [
    "overlay2.override_kernel_check=true"
  ],
  "registry-mirrors": [
    "https://registry.docker-cn.com"
  ]
}

3. 重启docker

mkdir -p /etc/systemd/system/docker.service.d
systemctl daemon-reload
systemctl restart docker

安装kubeadm, kubelet和kubectl

1. 添加yum仓库

若是节点在国内，可使用国内镜像仓库，这里使用了阿里云的，建立/etc/yum.repos.d/kubernetes.repo，文件以下内容

[kubernetes]
name=Kubernetes
baseurl=https://mirrors.aliyun.com/kubernetes/yum/repos/kubernetes-el7-x86_64/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://mirrors.aliyun.com/kubernetes/yum/doc/yum-key.gpg https://mirrors.aliyun.com/kubernetes/yum/doc/rpm-package-key.gpg

若是在国外，可使用谷歌官方镜像仓库，文件内容以下

[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
exclude=kube*

2. 关闭SELinux

kubelet不支持SELinux, 这里须要将SELinux设置为permissive模式

$ setenforce 0
$ sed -i 's/^SELINUX=enforcing$/SELINUX=permissive/' /etc/selinux/config

3. 安装 kubelet, kubectl和kubeadm

$ yum install -y kubelet kubeadm kubectl --disableexcludes=kubernetes
$ systemctl enable --now kubelet

4. 配置sysctl

在RHEL/CentOS 7上因为 iptables 被绕过致使网络请求被错误的路由。您得保证 在您的 sysctl 配置中 net.bridge.bridge-nf-call-iptables 被设为1。

建立文件/etc/sysctl.d/k8s.conf， 文件内容以下

net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1

执行sysctl --system使配置生效

5. 拉取镜像

若是节点在国外，能够跳过这一步。

执行kubeadm config images pull查看到gcr.io的链接，若是拉取成功能够进入下一步。

若是失败，说明没法访问gcr.io。这时须要手动拉取镜像，能够执行下面的脚本，从阿里云拉取相应镜像。

#!/bin/bash

images=(
    kube-apiserver:v1.13.4
    kube-controller-manager:v1.13.4
    kube-scheduler:v1.13.4
    kube-proxy:v1.13.4
    pause:3.1
    etcd:3.2.24
    coredns:1.2.6
)

for imageName in ${images[@]} ; do
    docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/$imageName
    docker tag registry.cn-hangzhou.aliyuncs.com/google_containers/$imageName k8s.gcr.io/$imageName
done

也能够在国外的vps上拉取相应的镜像，执行docker save保存为tar文件，复制到须要的节点上，docker load加载，而后经过docker tag恢复镜像的tag。

执行kubeadm config images list能够查看所需镜像

安装pod网络插件

这里使用flannel

$ yum insatll flanneld

初始化集群的master

1. kubeadm init初始化

能够先经过kubeadm config images pull确认镜像拉取成功。

经过kubeadm init <args>初始化。因为这里使用了flannel做为网络插件，在初始化时须要加入--pod-network-cidr=10.244.0.0/16指定网络。若是不适用默认的

kubeadm init --pod-network-cidr=10.244.0.0/16

初始化成功后，会输出下面的信息

Your Kubernetes master has initialized successfully!

To start using your cluster, you need to run the following as a regular user:

  mkdir -p $HOME/.kube
  sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
  sudo chown $(id -u):$(id -g) $HOME/.kube/config

You should now deploy a pod network to the cluster.
Run "kubectl apply -f [podnetwork].yaml" with one of the options listed at:
  https://kubernetes.io/docs/concepts/cluster-administration/addons/

You can now join any number of machines by running the following on each node
as root:

  kubeadm join <master-ip>:<master-port> --token <token> --discovery-token-ca-cert-hash sha256:<hash>

注意这里最后一行的kubeadm join .....，在其余节点执行此行命令，使节点加入到集群中。

若是使用非root帐户操做kubectl，则需执行以下命令

mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config

2. 部署flannel

kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/a70459be0084506e4ec919aa1c114638878db11b/Documentation/kube-flannel.yml

经过kubectl get nodes查看节点，若是看到master节点表示安装成功。

$ kubectl get nodes
NAME       STATUS   ROLES    AGE   VERSION
host-168   Ready    master   41h   v1.13.4

将其余节点加入到集群中

只有master须要执行kubeadm init初始化，其余node节点经过执行kubeadm join加入到集群中

命令及参数采用kubeadm init时的输出，示例以下

kubeadm join --token <token> <master-ip>:<master-port> --discovery-token-ca-cert-hash sha256:<hash>

这里的toke有效期只有24小时，若是过时在master上执行kubeadm create token建立新的token。

执行kubectl get nodes查看node节点

$ kubectl get nodes
NAME       STATUS   ROLES    AGE   VERSION
host-167   Ready    <none>   41h   v1.13.4
host-168   Ready    master   41h   v1.13.4

集群中的master和node节点的hostname不能重复，不然会加入集群失败。 若是重复，能够经过hostnamectl set-hostname NAME修改节点的hostname

安装Web界面(可选)

安装kuberenets-dashboard后能够经过浏览器查看/更改集群

1. 拉取镜像

和前述相同，须要node节点拉取下面几个镜像。国内节点须要从阿里云拉取或者从国外节点拉取后传到节点再加载

k8s.gcr.io/kubernetes-dashboard-amd64:v1.10.1
gcr.io/google_containers/kube-proxy-amd64:v1.9.8 
k8s.gcr.io/pause:3.1
gcr.io/google_containers/pause-amd64:3.0

2. 部署dashboard

获取yaml配置文件

$ wget https://raw.githubusercontent.com/kubernetes/dashboard/v1.10.1/src/deploy/recommended/kubernetes-dashboard.yaml

kubernetes-dashboard默认须要经过kubectl proxy来访问，可是这时使用的是HTTP，在HTTP下访问dashboard时即便登陆成功,也会卡在登陆页面。能够选择让dashboard直接监听外部端口，不通过kubectl proxy的代理。

为此能够在kubernets-dashboard.yaml最后一栏，Dashboard Service中，增长了type: NodePort和nodePort: 30001，更改后的结果以下所示。（这里30001端口也能够更改）

# ------------------- Dashboard Service ------------------- #

kind: Service
apiVersion: v1
metadata:
  labels:
    k8s-app: kubernetes-dashboard
  name: kubernetes-dashboard
  namespace: kube-system
spec:
  type: NodePort
  ports:
    - port: 443
      targetPort: 8443
      nodePort: 30001
  selector:
    k8s-app: kubernetes-dashboard

部署dashboard

经过kubectl部署dashboard

$ kubectl apply -f kubernets-dashboard.yaml

访问https://nodeIP:30001，出现登陆界面表示成功。这里的证书不被浏览器信任，chrome没法访问的话，能够用firefox打开。

3. 建立admin用户来访问dashboard

这里为了简单，建立了一个admin帐户用来登陆

新建文件dashboard-adminuser.yaml，内容以下

apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin-user
  namespace: kube-system
  
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: admin-user
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
- kind: ServiceAccount
  name: admin-user
  namespace: kube-system

在master上执行kubectl apply -f dashboard-adminuser.yaml建立admin用户及role绑定。

获取token

kubectl -n kube-system describe secret $(kubectl -n kube-system get secret | grep admin-user | awk '{print $1}')

输出以下所示

Name:         admin-user-token-6gl6l
Namespace:    kube-system
Labels:       <none>
Annotations:  kubernetes.io/service-account.name=admin-user
              kubernetes.io/service-account.uid=b16afba9-dfec-11e7-bbb9-901b0e532516

Type:  kubernetes.io/service-account-token

Data
====
ca.crt:     1025 bytes
namespace:  11 bytes
token:      eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJhZG1pbi11c2VyLXRva2VuLTZnbDZsIiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6ImFkbWluLXVzZXIiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC51aWQiOiJiMTZhZmJhOS1kZmVjLTExZTctYmJiOS05MDFiMGU1MzI1MTYiLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6a3ViZS1zeXN0ZW06YWRtaW4tdXNlciJ9.M70CU3lbu3PP4OjhFms8PVL5pQKj-jj4RNSLA4YmQfTXpPUuxqXjiTf094_Rzr0fgN_IVX6gC4fiNUL5ynx9KU-lkPfk0HnX8scxfJNzypL039mpGt0bbe1IXKSIRaq_9VW59Xz-yBUhycYcKPO9RM2Qa1Ax29nqNVko4vLn1_1wPqJ6XSq3GYI8anTzV8Fku4jasUwjrws6Cn6_sPEGmL54sq5R4Z5afUtv-mItTmqZZdxnkRqcJLlg2Y8WbCPogErbsaCDJoABQ7ppaqHetwfM_0yMun6ABOQbIwwl8pspJhpplKwyo700OSpvTT9zlBsu-b35lzXGBRHzv5g_RA

在dashboard登陆界面，选择令牌，将上面输出的token粘贴到输入框，点击登陆就能够已admin登入。

常见问题

1. node节点kubeadm join成功，master上看不到

能够查看node节点的hostname是否于集群内其余节点重复，重复的话经过hostnamectl修改

2. node节点一直处于NotReady状态

查看节点是否安装了flannel，没有须要安装。

经过systemctl status kubelet查看运行日志中的错误信息。

cni.go:213] Unable to update cni config: No networks found in /etc/cni/net.d
3月 31 17:50:00 host-166 kubelet[19833]: E0331 17:50:00.085663   19833 kubelet.go:2170] Container runtime network not ready: NetworkReady=false reason:NetworkPluginNotReady message:docker: network plugin is not ready: cni config uninitialized

相似上面的报错，应该是flannel没有安装或者找不到flannel的配置，能够手动将master的/etc/cni/net.d/10-flannel.conflist文件手动复制到node节点相应目录下。若是拉取镜像失败，则能够手动拉取。

3. dashboard卡在登陆界面

确保浏览器经过https访问dashboard。

4. token过时致使kubeadm join时失败

执行kubeadm join时报错以下。

[preflight] Reading configuration from the cluster...
[preflight] FYI: You can look at this config file with 'kubectl -n kube-system get cm kubeadm-config -oyaml'
error execution phase preflight: unable to fetch the kubeadm-config ConfigMap: failed to get config map: Unauthorized

这是由于kubeadm生成的token默认24小时过时，在master上执行kubeadm token create建立新的token，替换kubeadm join --token XXX中的token便可