Skip to main content

恢复 rkestate 状态文件

Kubernetes 集群状态由 Kubernetes 集群中的集群配置文件cluster.yml和组件证书组成。由 RKE 生成，但根据 RKE 版本不同，集群状态的保存方式不同。

  • 在 v0.2.0 之前，RKE 将 Kubernetes 集群状态保存为secret。更新状态时，RKE 会提取secret，更新/更改状态并保存新secret。
  • 从 v0.2.0 开始，RKE 在集群配置文件cluster.yml的同一目录中创建cluster.rkestate文件。该.rkestate文件包含集群的当前状态，包括RKE配置和证书。需要保留此文件以更新集群或通过 RKE 对集群执行任何操作。

1. 状态文件转换​

如果是通过rke v0.2.0之前版本创建的 Kubernetes 集群，那么建议升级 rke 版本到最新版本。

rke v0.2.0以前的版本，是通过pki.bundle.tar.gz来保存组件证书。而rke v0.2.0及以后的版本通过.rkestate来保存组件证书。

在 rke 升级到最新版本后，需要有一个过渡操作。通过原始是 rke 配置文件，重新运行rke up将会自动生成.rkestate文件。

2. 找回.rkestate​

假如.rkestate无意间丢失或者损坏，可以通过集群中的配置映射文件恢复.rkestate。

  • 通过本地 kubectl 找回

    如果只是.rkestate丢失，kubectl 还可以正常连接集群，运行以下命令找回

    kubectl --kubeconfig kube_config_cluster.yml get configmap -n kube-system \
    full-cluster-state -o json | jq -r .data.\"full-cluster-state\" | jq -r . > <rke-config-name>.rkestate

    注意: <rke-config-name>需要与 rke 配置文件名相同

  • 通过 master 节点找回

    如果本地的.rkestate和kubecfg文件一并丢失，则需要登录到 master 节点进行恢复

    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 \
    rancher/rancher-agent:v2.2.2 \
    -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 .' > <rke-config-name>.rkestate

    注意: <rke-config-name>需要与 rke 配置文件名相同