乐趣区

关于后端:Rancher无法管理集群怎么办RKE来接手

jiezi

前 言

大部分 Rancher 用户偏向于通过应用 Rancher Server 创立自定义集群。而创立实现之后，兴许会因为各种各样的起因导致 Rancher Server 无奈持续治理该集群，比方误删 Rancher Server 或备份数据无奈复原等。遇到此类问题，通常的解决方案是重新启动一个 Rancher Server 并将上游业务集群导入并纳管，但这样会导致一些“后遗症”，比方无奈持续扩大业务集群的节点。

为了打消这一“后遗症”的影响，咱们能够通过 RKE 纳管 Rancher Server 创立的“自定义”集群。

正如你所知，Rancher Server 通过 UI 创立的 ” 自定义 ” 集群，后端是通过 RKE 实现的，所以 RKE(https://docs.rancher.cn/rke/)… Server 创立的“自定义”集群。

通过 RKE 创立和治理 Kubernetes 集群，依赖 3 个文件：

  • cluster.yml：RKE 集群配置文件
  • kube_config_cluster.yml：该文件蕴含了获取该集群所有权限的认证凭据
  • cluster.rkestate：Kubernetes 集群状态文件，蕴含了获取该集群所有权限的认证凭据

所以，只有能从上游业务集群中取得这 3 个文件，就能够联合 RKE 二进制文件持续治理上游业务集群。上面将具体介绍如何通过 RKE 纳管 Rancher Server 创立的“自定义”集群，并通过 RKE 扩大集群的节点。

演示环境

本文只针对 Rancher v2.4.x 和 v2.5.x 版本做了测试，其余版本可能不实用。

为了更好的演示成果，本文将从 Rancher Server 创立“自定义”集群开始，而后通过 RKE 纳管 ” 自定义 ” 集群，最初为了确认 RKE 有能力纳管集群，将演示通过 RKE 增加一个节点。

Rancher Server（ip-172-31-2-203）能够采纳最简略的 docker run 形式启动，并通过 UI 创立一个 ” 自定义 ” 集群，集群中包含两个节点：ip-172-31-2-203 和 ip-172-31-1-111, 具体如下：

# kubectl get nodes
NAME              STATUS   ROLES                      AGE     VERSION
ip-172-31-1-111   Ready    worker                     2m2s    v1.18.14
ip-172-31-2-203   Ready    controlplane,etcd,worker   3m23s   v1.18.14

RKE 纳管“自定义”集群

1、将ip-172-31-8-56 关机，模仿 Rancher Server 故障，此时无奈通过 Rancher Server 持续治理上游集群。

2、复原上游业务集群的 kube_config_cluster.yml 文件，在 controlplane 节点上运行以下命令：

# docker run --rm --net=host \
  -v $(docker inspect kubelet --format '{{ range .Mounts}}{{if eq .Destination"/etc/kubernetes"}}{{.Source}}{{end}}{{end}}')/ssl:/etc/kubernetes/ssl:ro \
  --entrypoint bash $(docker inspect $(docker images -q --filter=label=io.cattle.agent=true) \
  --format='{{index .RepoTags 0}}' | tail -1) \
  -c 'kubectl --kubeconfig /etc/kubernetes/ssl/kubecfg-kube-node.yaml get configmap \
  -n kube-system full-cluster-state \
  -o json | jq -r .data.\"full-cluster-state\" | jq \
  -r .currentState.certificatesBundle.\"kube-admin\".config | sed \
  -e "/^[[:space:]]*server:/ s_:.*_: \"https://127.0.0.1:6443\"_"' \
  > kubeconfig_admin.yaml

胜利导出 kubeconfig_admin.yaml 之后，就能够应用 kubectl 持续操作上游业务集群：

# kubectl --kubeconfig kubeconfig_admin.yaml get nodes
NAME              STATUS   ROLES                      AGE   VERSION
ip-172-31-1-111   Ready    worker                     32m   v1.18.14
ip-172-31-2-203   Ready    controlplane,etcd,worker   34m   v1.18.14

3、复原上游业务集群的 cluster.rkestate 文件，在 controlplane 节点上运行以下命令：

# docker run --rm --net=host \
    -v $(docker inspect kubelet \
    --format '{{range .Mounts}}{{if eq .Destination"/etc/kubernetes"}}{{.Source}}{{end}}{{end}}')/ssl:/etc/kubernetes/ssl:ro \
    --entrypoint bash $(docker inspect $(docker images -q --filter=label=org.label-schema.vcs-url=https://github.com/rancher/hyperkube.git) \
    --format='{{index .RepoTags 0}}' | tail -1) \
    -c 'kubectl --kubeconfig /etc/kubernetes/ssl/kubecfg-kube-node.yaml \
    -n kube-system get configmap full-cluster-state \
    -o json | jq -r .data.\"full-cluster-state\" | jq -r .' \
    > cluster.rkestate

4、复原上游业务集群的 cluster.yml 文件

目前我没找到好办法能够主动复原该文件，但能够基于曾经复原的 cluster.rkestate 来手动复原 cluster.yml 文件，因为 cluster.yml 须要的配置根本都能够从 cluster.rkestate 取得。

从 cluster.rkestate 中取得集群节点的配置信息：

# cat cluster.rkestate | jq -r .desiredState.rkeConfig.nodes
[
  {
    "nodeName": "c-kfbjs:m-d3e75ad7a0ea",
    "address": "172.31.2.203",
    "port": "22",
    "internalAddress": "172.31.2.203",
    "role": [
      "etcd",
      "controlplane",
      "worker"
],
    "hostnameOverride": "ip-172-31-2-203",
    "user": "root",
    "sshKeyPath": "~/.ssh/id_rsa"
  }
]

依据 cluster.rkestate提供的节点信息，手动编写 cluster.yml

# cat cluster.yml
nodes:
  - address: 172.31.2.203
    hostname_override: ip-172-31-2-203
    user: ubuntu
    role:
      - controlplane
      - etcd
      - worker
  - address: 172.31.1.111
    hostname_override: ip-172-31-1-111
    user: ubuntu
    role:
      - worker
  - address: 172.31.5.186
    hostname_override: ip-172-31-5-186
    user: ubuntu
    role:
      - worker
kubernetes_version: v1.18.14-rancher1-1

以上手动编写的 cluster.yml 有几个中央须要留神：

只能从 cluster.rkestate 文件中取得 controlplane(ip-172-31-2-203) 节点的信息，因为本例集群中还有一个 worker(p-172-31-1-111) 节点，所以须要将 worker(p-172-31-1-111) 节点的信息手动补充残缺。

cluster.yaml中的 ip-172-31-5-186 是新增的 worker 节点，用于下一步演示 RKE 新增节点。

从 cluster.rkestate 取得的节点信息是 root 用户，须要依据理论需要，批改成 RKE 执行的用户，本例为 ubuntu 用户。

肯定要指定原始集群的 kubernetes_version 参数，否则会将集群降级到 RKE 默认的最新版 Kubernetes。

除了以上形式，还能够通过上面的脚本复原 cluster.yml。同样，你须要批改以上几点提到的中央。应用这种办法的益处是能够更残缺的复原 cluster.yml 文件，篇幅无限，就不做过多演示：

#!/bin/bash
echo "Building cluster.yml..."
echo "Working on Nodes..."
echo 'nodes:' > cluster.yml
cat cluster.rkestate | grep -v nodeName | jq -r .desiredState.rkeConfig.nodes | yq r - | sed 's/^/  /' | \
sed -e 's/internalAddress/internal_address/g' | \
sed -e 's/hostnameOverride/hostname_override/g' | \
sed -e 's/sshKeyPath/ssh_key_path/g' >> cluster.yml
echo "" >> cluster.yml

echo "Working on services..."
echo 'services:' >> cluster.yml
cat cluster.rkestate  | jq -r .desiredState.rkeConfig.services | yq r - | sed 's/^/  /' >> cluster.yml
echo "" >> cluster.yml

echo "Working on network..."
echo 'network:' >> cluster.yml
cat cluster.rkestate  | jq -r .desiredState.rkeConfig.network | yq r - | sed 's/^/  /' >> cluster.yml
echo "" >> cluster.yml

echo "Working on authentication..."
echo 'authentication:' >> cluster.yml
cat cluster.rkestate  | jq -r .desiredState.rkeConfig.authentication | yq r - | sed 's/^/  /' >> cluster.yml
echo "" >> cluster.yml

echo "Working on systemImages..."
echo 'system_images:' >> cluster.yml
cat cluster.rkestate  | jq -r .desiredState.rkeConfig.systemImages | yq r - | sed 's/^/  /' >> cluster.yml
echo "" >> cluster.yml

5、应用 RKE 在原有集群上新增节点。

到目前为止，RKE 须要的配置文件 cluster.yml、cluster.rkestate 都曾经复原实现，接下来就能够通过 rke up 来操作集群减少 worker(p-172-31-1-111) 节点。

# rke up
INFO[0000] Running RKE version: v1.2.4
INFO[0000] Initiating Kubernetes cluster
INFO[0000] [certificates] GenerateServingCertificate is disabled, checking if there are unused kubelet certificates
INFO[0000] [certificates] Generating admin certificates and kubeconfig
INFO[0000] Successfully Deployed state file at [./cluster.rkestate]
INFO[0000] Building Kubernetes cluster
INFO[0000] [dialer] Setup tunnel for host [172.31.2.203]
INFO[0000] [dialer] Setup tunnel for host [172.31.1.111]
INFO[0000] [dialer] Setup tunnel for host [172.31.5.186]
...
...
INFO[0090] [addons] no user addons defined
INFO[0090] Finished building Kubernetes cluster successfully

期待集群更新实现之后，再次获取节点信息：

# kubectl --kubeconfig kubeconfig_admin.yaml get nodes
NAME              STATUS   ROLES                      AGE     VERSION
ip-172-31-1-111   Ready    worker                     8m6s    v1.18.14
ip-172-31-2-203   Ready    controlplane,etcd,worker   9m27s   v1.18.14
ip-172-31-5-186   Ready    worker                     29s     v1.18.14

能够看到新增了一个 worker(ip-172-31-5-186) 节点，并且集群版本仍然是v1.18.14。

当前，能够通过 RKE 来持续治理通过 Rancher Server 创立的自定义集群，无论是新增节点、快照、复原均可。和间接通过 RKE 创立的集群简直无差别。

后 记

尽管本文介绍了如何通过 RKE 纳管 Rancher 自定义集群，但操作比较复杂，特地是 cluster.yml 的配置，如果呈现一点过错，可能就会导致整个集群的更新或出错，所以应用前请您肯定要多做测试。

作者简介
王海龙，Rancher 中国社区技术经理，负责 Rancher 中国技术社区的保护和经营。领有 6 年的云计算畛域教训，经验了 OpenStack 到 Kubernetes 的技术改革，无论底层操作系统 Linux，还是虚拟化 KVM 或是 Docker 容器技术都有丰盛的运维和实践经验。

退出移动版