1. 程式人生 > >K8S部署步驟:8-部署Master節點

K8S部署步驟:8-部署Master節點

kubernetes master節點包含的元件:

  • etcd
  • flannel
  • docker
  • kube-apiserver
  • kube-scheduler
  • kube-controller-manager

目前這三個元件需要部署在同一臺機器上:
- kube-scheduler、kube-controller-manager和kube-apiserver三者的功能緊密相關;
- 同時只能有一個kube-scheduler、kube-controller-manager程序處於工作狀態,如果執行多個,則需要通過選舉產生一個leader;
- 本文件介紹部署單kubernetes master節點的步驟,沒有實現高可用master叢集。

匯入環境變數

$ source /root/local/bin/environment.sh

下載二進位制檔案

CHANGELOG頁面下載server tarball檔案

$ wget https://dl.k8s.io/v1.10.0/kubernetes-server-linux-amd64.tar.gz
$ tar -xzvf kubernetes-server-linux-amd64.tar.gz
$ sudo cp -r kubernetes/server/bin/{kube-apiserver,kube-controller-manager,kube-scheduler,kubectl} /root/local
/bin/

建立 admin 證書

kubectl 與 kube-apiserver 的安全埠通訊,需要為安全通訊提供 TLS 證書和祕鑰。

建立 admin 證書籤名請求

$ cat admin-csr.json
{
  "CN": "admin",
  "hosts": [],
  "key": {
    "algo": "rsa",
    "size": 2048
  },
  "names": [
    {
      "C": "CN",
      "ST": "BeiJing",
      "L": "BeiJing",
      "O": "system:masters"
, "OU": "System" } ] }
  • 後續 kube-apiserver 使用 RBAC 對客戶端(如 kubelet、kube-proxy、Pod)請求進行授權;
  • kube-apiserver 預定義了一些 RBAC 使用的 RoleBindings,如 cluster-admin 將 Group system:masters 與 Role cluster-admin 繫結,該 Role 授予了呼叫kube-apiserver 所有 API的許可權;
  • O 指定該證書的 Group 為 system:masters,kubelet 使用該證書訪問 kube-apiserver 時 ,由於證書被 CA 簽名,所以認證通過,同時由於證書使用者組為經過預授權的 system:masters,所以被授予訪問所有 API 的許可權;
  • hosts 屬性值為空列表;

生成 admin 證書和私鑰:

 cfssl gencert -ca=/etc/kubernetes/ssl/ca.pem \
  -ca-key=/etc/kubernetes/ssl/ca-key.pem \
  -config=/etc/kubernetes/ssl/ca-config.json \
  -profile=kubernetes admin-csr.json | cfssljson -bare admin
$ ls admin*
admin.csr  admin-csr.json  admin-key.pem  admin.pem
$ sudo mv admin*.pem /etc/kubernetes/ssl/
$ rm admin.csr admin-csr.json

建立 kubectl kubeconfig 檔案

$ # 設定叢集引數
$ kubectl config set-cluster kubernetes \
  --certificate-authority=/etc/kubernetes/ssl/ca.pem \
  --embed-certs=true \
  --server=${KUBE_APISERVER}
$ # 設定客戶端認證引數
$ kubectl config set-credentials admin \
  --client-certificate=/etc/kubernetes/ssl/admin.pem \
  --embed-certs=true \
  --client-key=/etc/kubernetes/ssl/admin-key.pem
$ # 設定上下文引數
$ kubectl config set-context kubernetes \
  --cluster=kubernetes \
  --user=admin
$ # 設定預設上下文
$ kubectl config use-context kubernetes
  • admin.pem 證書 O 欄位值為 system:masters,kube-apiserver 預定義的 RoleBinding cluster-admin 將 Group system:masters 與 Role cluster-admin 繫結,該 Role 授予了呼叫kube-apiserver 相關 API 的許可權;
  • 生成的 kubeconfig 被儲存到 ~/.kube/config 檔案;

分發 kubeconfig 檔案

將 ~/.kube/config 檔案拷貝到執行 kubelet 命令的機器的 ~/.kube/ 目錄下。

建立kubernetes證書

建立kubernetes證書籤名請求

$ cat > kubernetes-csr.json << EOF
{
  "CN": "kubernetes",
  "hosts": [
    "127.0.0.1",
    "${MASTER_IP}",
    "${CLUSTER_KUBERNETES_SVC_IP}",
    "kubernetes",
    "kubernetes.default",
    "kubernetes.default.svc",
    "kubernetes.default.svc.cluster",
    "kubernetes.default.svc.cluster.local"
  ],
  "key": {
    "algo": "rsa",
    "size": 2048
  },
  "names": [
    {
      "C": "CN",
      "ST": "BeiJing",
      "L": "BeiJing",
      "O": "k8s",
      "OU": "System"
    }
  ]
}
EOF
  • 如果hosts欄位不為空則需要指定授權使用該證書的IP或域名列表,所以上面分別指定了當前部署的master節點主機IP和域名;
  • 還需要新增kube-apiserver註冊的名為kubernetes的服務IP (Service Cluster IP),一般是kube-apiserver –service-cluster-ip-range選項值指定的網段的第一個IP,如10.254.0.1;

生成kubernetes證書和私鑰

$ cfssl gencert -ca=/etc/kubernetes/ssl/ca.pem \
  -ca-key=/etc/kubernetes/ssl/ca-key.pem \
  -config=/etc/kubernetes/ssl/ca-config.json \
  -profile=kubernetes kubernetes-csr.json | cfssljson -bare kubernetes
$ ls kubernetes*
# kubernetes.csr kubernetes-csr.json kubernetes-key.pem kubernetes.pem
$ sudo mkdir -p /etc/kubernetes/ssl/
$ sudo mv kubernetes*.pem /etc/kubernetes/ssl/
$ sudo rm -rf kubernetes.csr kubernetes-csr.json

配置和啟動kube-apiserver

建立kube-apiserver使用的客戶端token檔案

kubelet首次啟動時會向kube-apiserver傳送TLS Bootstrapping請求,kube-apiserver驗證kubelet請求中的token是否與它配置的token.csv一致,如果一致則自動為kubelet生成證書和祕鑰。

# 匯入的environment.sh檔案定義的BOOTSTRAP_TOKEN變數
$ cat > token.csv << EOF
${BOOTSTRAP_TOKEN},kubelet-bootstrap,10001,"system:kubelet-bootstrap"
EOF
$ mv token.csv /etc/kubernetes/

建立kube-apiserver的systemd unit檔案

$ cat > kube-apiserver.service << EOF
[Unit]
Description=Kubernetes API Server
Documentation=https://github.com/kubernetes/kubernetes
After=network.target
[Service]
ExecStart=/root/local/bin/kube-apiserver \\
  --admission-control=NamespaceLifecycle,LimitRanger,ServiceAccount,DefaultStorageClass,ResourceQuota \\
  --advertise-address=${MASTER_IP} \\
  --bind-address=${MASTER_IP} \\
  --insecure-bind-address=${MASTER_IP} \\
  --authorization-mode=Node,RBAC \\
  --runtime-config=rbac.authorization.k8s.io/v1 \\
  --kubelet-https=true \\
  --enable-bootstrap-token-auth \\
  --token-auth-file=/etc/kubernetes/token.csv \\
  --service-cluster-ip-range=${SERVICE_CIDR} \\
  --service-node-port-range=${NODE_PORT_RANGE} \\
  --tls-cert-file=/etc/kubernetes/ssl/kubernetes.pem \\
  --tls-private-key-file=/etc/kubernetes/ssl/kubernetes-key.pem \\
  --client-ca-file=/etc/kubernetes/ssl/ca.pem \\
  --service-account-key-file=/etc/kubernetes/ssl/ca-key.pem \\
  --etcd-cafile=/etc/kubernetes/ssl/ca.pem \\
  --etcd-certfile=/etc/kubernetes/ssl/kubernetes.pem \\
  --etcd-keyfile=/etc/kubernetes/ssl/kubernetes-key.pem \\
  --etcd-servers=${ETCD_ENDPOINTS} \\
  --enable-swagger-ui=true \\
  --allow-privileged=true \\
  --apiserver-count=3 \\
  --audit-log-maxage=30 \\
  --audit-log-maxbackup=3 \\
  --audit-log-maxsize=100 \\
  --audit-log-path=/var/lib/audit.log \\
  --event-ttl=1h \\
  --v=2
Restart=on-failure
RestartSec=5
Type=notify
LimitNOFILE=65536
[Install]
WantedBy=multi-user.target
EOF
  • kube-apiserver 1.6版本開始使用etcd v3 API和儲存格式;
  • –authorization-mode=RBAC指定在安全埠使用RBAC授權模式,拒絕未通過授權的請求;
  • kube-scheduler、kube-controller-manager一般和kube-apiserver部署在同一臺Master機器上,它們使用非安全埠和kube-apiserver通訊;
  • kubelet、kube-proxy部署在其它Node節點上,如果通過安全埠訪問kube-apiserver,則必須先通過TLS證書認證,再通過RBAC授權;
  • kube-proxy、kubectl通過在使用的證書裡指定相關的User、Group來達到通過RBAC 授權的目的;
  • 如果使用了kubelet TLS Boostrap機制,則不能再指定–kubelet-certificate-authority、–kubelet-client-certificate和–kubelet-client-key選項,否則後續kube-apiserver校驗kubelet證書時出現x509: certificate signed by unknown authority錯誤;
  • –admission-control值必須包含ServiceAccount,否則部署叢集外掛時會失敗;
  • –bind-address不能為127.0.0.1;
  • –service-cluster-ip-range指定Service Cluster IP地址段,該地址段不能路由可達;
  • –service-node-port-range=${NODE_PORT_RANGE}指定NodePort的埠範圍;
  • 預設情況下kubernetes物件儲存在etcd /registry 路徑下,可以通過–etcd-prefix引數進行調整;

啟動kube-apiserver

$ sudo cp kube-apiserver.service /etc/systemd/system/
$ sudo systemctl daemon-reload
$ sudo systemctl enable kube-apiserver
$ sudo systemctl start kube-apiserver
$ sudo systemctl status kube-apiserver

配置和啟動kube-controller-manager

建立kube-controller-manager的systemd unit檔案

$ cat > kube-controller-manager.service << EOF
[Unit]
Description=Kubernetes Controller Manager
Documentation=https://github.com/kubernetes/kubernetes
[Service]
ExecStart=/root/local/bin/kube-controller-manager \\
  --address=127.0.0.1 \\
  --master=http://${MASTER_IP}:8080 \\
  --allocate-node-cidrs=true \\
  --service-cluster-ip-range=${SERVICE_CIDR} \\
  --cluster-cidr=${CLUSTER_CIDR} \\
  --cluster-name=kubernetes \\
  --cluster-signing-cert-file=/etc/kubernetes/ssl/ca.pem \\
  --cluster-signing-key-file=/etc/kubernetes/ssl/ca-key.pem \\
  --service-account-private-key-file=/etc/kubernetes/ssl/ca-key.pem \\
  --root-ca-file=/etc/kubernetes/ssl/ca.pem \\
  --leader-elect=true \\
  --v=2
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF

–address值必須為127.0.0.1,因為當前kube-apiserver期望scheduler和controller-manager在同一臺機器,否則:

$ kubectl get componentstatuses
NAME                 STATUS      MESSAGE                                                                                        ERROR
controller-manager   Unhealthy   Get http://127.0.0.1:10252/healthz: dial tcp 127.0.0.1:10252: getsockopt: connection refused
scheduler            Unhealthy   Get http://127.0.0.1:10251/healthz: dial tcp 127.0.0.1:10251: getsockopt: connection refused
  • –master=http://{MASTER_IP}:8080:使用非安全8080埠與kube-apiserver通訊;
  • –cluster-cidr指定Cluster中Pod的CIDR範圍,該網段在各Node間必須路由可達(flannel保證);
  • –service-cluster-ip-range引數指定Cluster中Service的CIDR範圍,該網路在各Node間必須路由不可達,必須和kube-apiserver中的引數一致;
  • –cluster-signing-*指定的證書和私鑰檔案用來簽名為TLS BootStrap建立的證書和私鑰;
  • –root-ca-file用來對kube-apiserver證書進行校驗,指定該引數後,才會在Pod容器的ServiceAccount中放置該CA證書檔案;
  • –leader-elect=true部署多臺機器組成的master叢集時選舉產生一處於工作狀態的kube-controller-manager程序;

啟動kube-controller-manager

$ sudo cp kube-controller-manager.service /etc/systemd/system/
$ sudo systemctl daemon-reload
$ sudo systemctl enable kube-controller-manager
$ sudo systemctl start kube-controller-manager

配置和啟動kube-scheduler

建立kube-scheduler的systemd unit檔案

$ cat > kube-scheduler.service << EOF
[Unit]
Description=Kubernetes Scheduler
Documentation=https://github.com/kubernetes/kubernetes
[Service]
ExecStart=/root/local/bin/kube-scheduler \\
  --address=127.0.0.1 \\
  --master=http://${MASTER_IP}:8080 \\
  --leader-elect=true \\
  --v=2
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
EOF
  • –address值必須為127.0.0.1,因為當前kube-apiserver期望scheduler和controller-manager在同一臺機器;
  • –master=http://{MASTER_IP}:8080:使用非安全8080埠與kube-apiserver通訊;
  • –leader-elect=true部署多臺機器組成的master叢集時選舉產生一處於工作狀態的kube-controller-manager程序;

啟動kube-scheduler

$ sudo cp kube-scheduler.service /etc/systemd/system/
$ sudo systemctl daemon-reload
$ sudo systemctl enable kube-scheduler
$ sudo systemctl start kube-scheduler

驗證master節點功能

$ kubectl get componentstatuses
# NAME                 STATUS    MESSAGE              ERROR
# controller-manager   Healthy   ok
# scheduler            Healthy   ok
# etcd-0               Healthy   {"health": "true"}
# etcd-1               Healthy   {"health": "true"}
# etcd-2               Healthy   {"health": "true"}