• --port=0：关闭监听 http /metrics 的请求，同时 --address 参数无效，--bind-address 参数有效；
• --secure-port=10252、--bind-address=0.0.0.0: 在所有网络接口监听 10252 端口的 https /metrics 请求；
• --kubeconfig：指定 kubeconfig 文件路径，kube-controller-manager 使用它连接和验证 kube-apiserver；
• --cluster-signing-*-file：签名 TLS Bootstrap 创建的证书；
• --experimental-cluster-signing-duration：指定 TLS Bootstrap 证书的有效期；
• --root-ca-file：放置到容器 ServiceAccount 中的 CA 证书，用来对 kube-apiserver 的证书进行校验；
• --service-account-private-key-file：签名 ServiceAccount 中 Token 的私钥文件，必须和 kube-apiserver 的 --service-account-key-file 指定的公钥文件配对使用；
• --service-cluster-ip-range ：指定 Service Cluster IP 网段，必须和 kube-apiserver 中的同名参数一致；
• --leader-elect=true：集群运行模式，启用选举功能；被选为 leader 的节点负责处理工作，其它节点为阻塞状态；
• --feature-gates=RotateKubeletServerCertificate=true：开启 kublet server 证书的自动更新特性；
• --controllers=*,bootstrapsigner,tokencleaner：启用的控制器列表，tokencleaner 用于自动清理过期的 Bootstrap token；
• --horizontal-pod-autoscaler-*：custom metrics 相关参数，支持 autoscaling/v2alpha1；
• --tls-cert-file、--tls-private-key-file：使用 https 输出 metrics 时使用的 Server 证书和秘钥；
• --use-service-account-credentials=true:
• User=k8s：使用 k8s 账户运行；

kube-controller-manager 不对请求 https metrics 的 Client 证书进行校验，故不需要指定 –tls-ca-file 参数，而且该参数已被淘汰。

分发 systemd unit 文件到所有 master 节点：

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    scp kube-controller-manager.service root@${node_ip}:/etc/systemd/system/
done
EOF

4，kube-controller-manager 的权限

ClusteRole: system:kube-controller-manager 的权限很小，只能创建 secret、serviceaccount 等资源对象，各 controller 的权限分散到 ClusterRole system:controller:XXX 中。

需要在 kube-controller-manager 的启动参数中添加 、–use-service-account-credentials=true 参数，这样 main controller 会为各 controller 创建对应的 ServiceAccount XXX-controller。

内置的 ClusterRoleBinding system:controller:XXX 将赋予各 XXX-controller ServiceAccount 对应的 ClusterRole system:controller:XXX 权限。

5，启动 kube-controller-manager 服务

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    ssh root@${node_ip} "mkdir -p /var/log/kubernetes && chown -R k8s /var/log/kubernetes"
    ssh root@${node_ip} "systemctl daemon-reload && systemctl enable kube-controller-manager && systemctl start kube-controller-manager"
done
EOF

6，检查服务运行状态

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    ssh k8s@${node_ip} "systemctl status kube-controller-manager|grep Active"
done
EOF

如果输出如下内容：

$bash magic.sh
>>> 192.168.106.3
   Active: active (running) since Fri 2018-11-23 18:23:11 CST; 6h ago
>>> 192.168.106.4
   Active: active (running) since Fri 2018-11-23 18:23:12 CST; 6h ago
>>> 192.168.106.5
   Active: active (running) since Fri 2018-11-23 18:23:12 CST; 6h ago

则为正常，否则，查看日志：

journalctl -xu kube-controller-manager

7，查看输出的 metric

注意：以下命令在 kube-controller-manager 节点上执行。

kube-controller-manager 监听 10252 端口，接收 https 请求：

$sudo netstat -lnpt|grep kube-controll
tcp        0      0 127.0.0.1:10252         0.0.0.0:*               LISTEN      14858/kube-controll

$curl -s --cacert /etc/kubernetes/cert/ca.pem https://127.0.0.1:10252/metrics |head
# HELP ClusterRoleAggregator_adds Total number of adds handled by workqueue: ClusterRoleAggregator
# TYPE ClusterRoleAggregator_adds counter
ClusterRoleAggregator_adds 17
# HELP ClusterRoleAggregator_depth Current depth of workqueue: ClusterRoleAggregator
# TYPE ClusterRoleAggregator_depth gauge
ClusterRoleAggregator_depth 0
# HELP ClusterRoleAggregator_queue_latency How long an item stays in workqueueClusterRoleAggregator before being requested.
# TYPE ClusterRoleAggregator_queue_latency summary
ClusterRoleAggregator_queue_latency{quantile="0.5"} NaN
ClusterRoleAggregator_queue_latency{quantile="0.9"} NaN

• curl --cacert CA 证书用来验证 kube-controller-manager https server 证书；

8，查看当前的 leader

$kubectl get endpoints kube-controller-manager --namespace=kube-system  -o yaml
apiVersion: v1
kind: Endpoints
metadata:
  annotations:
    control-plane.alpha.kubernetes.io/leader: '{"holderIdentity":"kube-node1_c79b4380-ef09-11e8-aa72-525400c7ba97","leaseDurationSeconds":15,"acquireTime":"2018-11-23T10:23:11Z","renewTime":"2018-11-23T16:50:16Z","leaderTransitions":0}'
  creationTimestamp: 2018-11-23T10:23:11Z
  name: kube-controller-manager
  namespace: kube-system
  resourceVersion: "29655"
  selfLink: /api/v1/namespaces/kube-system/endpoints/kube-controller-manager
  uid: c79fb0ff-ef09-11e8-9670-525400c7ba97

可见，当前的 leader 为 kube-node1 节点。

9，测试 kube-controller-manager 集群的高可用

停掉一个或两个节点的 kube-controller-manager 服务，观察其它节点的日志，看是否获取了 leader 权限。

现在停掉kube-node1上的kube-controller-manager。

$systemctl stop kube-controller-manager
$systemctl status kube-controller-manager |grep Active
   Active: inactive (dead) since Sat 2018-11-24 00:52:53 CST; 44s ago

再查看一下当前的leader：

$kubectl get endpoints kube-controller-manager --namespace=kube-system  -o yaml
apiVersion: v1
kind: Endpoints
metadata:
  annotations:
    control-plane.alpha.kubernetes.io/leader: '{"holderIdentity":"kube-node3_c809d2de-ef09-11e8-bfb1-525400b42484","leaseDurationSeconds":15,"acquireTime":"2018-11-23T16:53:10Z","renewTime":"2018-11-23T16:54:24Z","leaderTransitions":1}'
  creationTimestamp: 2018-11-23T10:23:11Z
  name: kube-controller-manager
  namespace: kube-system
  resourceVersion: "29971"
  selfLink: /api/v1/namespaces/kube-system/endpoints/kube-controller-manager
  uid: c79fb0ff-ef09-11e8-9670-525400c7ba97

可以看到已经自动漂移到kube-node3上去了。

10，参考

1. 关于 controller 权限和 use-service-account-credentials 参数：https://github.com/kubernetes/kubernetes/issues/48208
2. kublet 认证和授权：https://kubernetes.io/docs/admin/kubelet-authentication-authorization/#kubelet-authorization

为保证通信安全，本文档先生成 x509 证书和私钥，kube-controller-manager 在如下两种情况下使用该证书：

1. 与 kube-apiserver 的安全端口通信时;
2. 在安全端口(https，10252) 输出 prometheus 格式的 metrics；

配置之前需要先安装kubelet,flannel等组件，不过前边已经安装，现在直接进入配置。

1，创建 kube-controller-manager 证书和私钥

创建证书签名请求：

cat > kube-controller-manager-csr.json <

$cfssl gencert -ca=/etc/kubernetes/cert/ca.pem \
  -ca-key=/etc/kubernetes/cert/ca-key.pem \
  -config=/etc/kubernetes/cert/ca-config.json \
  -profile=kubernetes kube-controller-manager-csr.json | cfssljson -bare kube-controller-manager

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    scp kube-controller-manager*.pem k8s@${node_ip}:/etc/kubernetes/cert/
done
EOF

$source /opt/k8s/bin/environment.sh

$kubectl config set-cluster kubernetes \
  --certificate-authority=/etc/kubernetes/cert/ca.pem \
  --embed-certs=true \
  --server=${KUBE_APISERVER} \
  --kubeconfig=kube-controller-manager.kubeconfig

$kubectl config set-credentials system:kube-controller-manager \
  --client-certificate=kube-controller-manager.pem \
  --client-key=kube-controller-manager-key.pem \
  --embed-certs=true \
  --kubeconfig=kube-controller-manager.kubeconfig

$kubectl config set-context system:kube-controller-manager \
  --cluster=kubernetes \
  --user=system:kube-controller-manager \
  --kubeconfig=kube-controller-manager.kubeconfig

$kubectl config use-context system:kube-controller-manager --kubeconfig=kube-controller-manager.kubeconfig

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    scp kube-controller-manager.kubeconfig k8s@${node_ip}:/etc/kubernetes/
done
EOF

$source /opt/k8s/bin/environment.sh

$cat > kube-controller-manager.service <

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    scp kube-controller-manager.service root@${node_ip}:/etc/systemd/system/
done
EOF

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    ssh root@${node_ip} "mkdir -p /var/log/kubernetes && chown -R k8s /var/log/kubernetes"
    ssh root@${node_ip} "systemctl daemon-reload && systemctl enable kube-controller-manager && systemctl start kube-controller-manager"
done
EOF

cat > magic.sh << "EOF"
#!/bin/bash

source /opt/k8s/bin/environment.sh

for node_ip in ${NODE_IPS[@]}
do
    echo ">>> ${node_ip}" 
    ssh k8s@${node_ip} "systemctl status kube-controller-manager|grep Active"
done
EOF

$bash magic.sh
>>> 192.168.106.3
   Active: active (running) since Fri 2018-11-23 18:23:11 CST; 6h ago
>>> 192.168.106.4
   Active: active (running) since Fri 2018-11-23 18:23:12 CST; 6h ago
>>> 192.168.106.5
   Active: active (running) since Fri 2018-11-23 18:23:12 CST; 6h ago

journalctl -xu kube-controller-manager

$sudo netstat -lnpt|grep kube-controll
tcp        0      0 127.0.0.1:10252         0.0.0.0:*               LISTEN      14858/kube-controll

$curl -s --cacert /etc/kubernetes/cert/ca.pem https://127.0.0.1:10252/metrics |head
# HELP ClusterRoleAggregator_adds Total number of adds handled by workqueue: ClusterRoleAggregator
# TYPE ClusterRoleAggregator_adds counter
ClusterRoleAggregator_adds 17
# HELP ClusterRoleAggregator_depth Current depth of workqueue: ClusterRoleAggregator
# TYPE ClusterRoleAggregator_depth gauge
ClusterRoleAggregator_depth 0
# HELP ClusterRoleAggregator_queue_latency How long an item stays in workqueueClusterRoleAggregator before being requested.
# TYPE ClusterRoleAggregator_queue_latency summary
ClusterRoleAggregator_queue_latency{quantile="0.5"} NaN
ClusterRoleAggregator_queue_latency{quantile="0.9"} NaN

$kubectl get endpoints kube-controller-manager --namespace=kube-system  -o yaml
apiVersion: v1
kind: Endpoints
metadata:
  annotations:
    control-plane.alpha.kubernetes.io/leader: '{"holderIdentity":"kube-node1_c79b4380-ef09-11e8-aa72-525400c7ba97","leaseDurationSeconds":15,"acquireTime":"2018-11-23T10:23:11Z","renewTime":"2018-11-23T16:50:16Z","leaderTransitions":0}'
  creationTimestamp: 2018-11-23T10:23:11Z
  name: kube-controller-manager
  namespace: kube-system
  resourceVersion: "29655"
  selfLink: /api/v1/namespaces/kube-system/endpoints/kube-controller-manager
  uid: c79fb0ff-ef09-11e8-9670-525400c7ba97

$systemctl stop kube-controller-manager
$systemctl status kube-controller-manager |grep Active
   Active: inactive (dead) since Sat 2018-11-24 00:52:53 CST; 44s ago

$kubectl get endpoints kube-controller-manager --namespace=kube-system  -o yaml
apiVersion: v1
kind: Endpoints
metadata:
  annotations:
    control-plane.alpha.kubernetes.io/leader: '{"holderIdentity":"kube-node3_c809d2de-ef09-11e8-bfb1-525400b42484","leaseDurationSeconds":15,"acquireTime":"2018-11-23T16:53:10Z","renewTime":"2018-11-23T16:54:24Z","leaderTransitions":1}'
  creationTimestamp: 2018-11-23T10:23:11Z
  name: kube-controller-manager
  namespace: kube-system
  resourceVersion: "29971"
  selfLink: /api/v1/namespaces/kube-system/endpoints/kube-controller-manager
  uid: c79fb0ff-ef09-11e8-9670-525400c7ba97