迁移前巡检清单设计

节点池配置迁移是高风险操作，迁移前的全面巡检是保障迁移成功的第一道防线。巡检清单覆盖集群健康、Flux 状态、资源配额与备份策略四个维度，任何一项不达标都应中止迁移流程。

4.1 集群健康检查

集群健康检查确保底层 Kubernetes 集群具备承载迁移操作的稳定性。检查项包括控制平面状态、节点状态、系统组件可用性及关键指标水位。

4.2 Flux 状态检查

Flux 自身的运行状态直接决定迁移能否被正确编排。检查重点包括 Flux 控制器 Pod 状态、GitRepository 与 Kustomization 对象的同步状态、以及 HelmRelease 的发布状态。

# 检查 Flux 控制器 Pod 状态
kubectl get pods -n flux-system

# 检查所有 GitRepository 对象的同步状态
kubectl get gitrepositories -A -o wide

# 检查所有 Kustomization 对象的应用状态
kubectl get kustomizations -A -o wide

# 检查所有 HelmRelease 的发布状态
kubectl get helmreleases -A -o wide

# 查看 Flux 控制器日志，确认无持续报错
kubectl logs -n flux-system deployment/source-controller --tail=50
kubectl logs -n flux-system deployment/kustomize-controller --tail=50

4.3 节点池资源配额检查

节点池资源配额检查确保目标节点池有足够的容量承接迁移后的工作负载。检查维度包括节点池的可用资源、Pod 密度上限、以及是否存在资源配额限制。

# 查看节点池资源总量与已分配量
kubectl describe node <node-name> | grep -A 5 "Capacity"
kubectl describe node <node-name> | grep -A 5 "Allocatable"

# 查看节点池当前 Pod 数量
kubectl get pods -A --field-selector spec.nodeName=<node-name> | wc -l

# 查看命名空间资源配额
kubectl get resourcequota -n <target-namespace> -o yaml

4.4 备份策略确认

备份是迁移失败后的最后一道防线。备份策略确认包括 Flux 对象配置备份、Kubernetes 资源备份、以及 etcd 数据备份三个层次。

# 备份 Flux 对象清单（YAML 格式）
flux export source git flux-system > flux-backup/flux-system-gitrepo.yaml
flux export kustomization flux-system > flux-backup/flux-system-kustomization.yaml
kubectl get gitrepositories -A -o yaml > flux-backup/all-gitrepositories.yaml
kubectl get kustomizations -A -o yaml > flux-backup/all-kustomizations.yaml
kubectl get helmreleases -A -o yaml > flux-backup/all-helmreleases.yaml

# 备份目标命名空间资源
kubectl get all -n <target-namespace> -o yaml > flux-backup/target-namespace-resources.yaml

# 验证备份文件完整性
tar -czf flux-backup-$(date +%Y%m%d%H%M).tar.gz flux-backup/
sha256sum flux-backup-*.tar.gz > flux-backup-checksum.txt

4.5 巡检清单总览流程

以下 SVG 流程图展示了迁移前巡检的完整执行顺序与决策逻辑。巡检按集群健康 → Flux 状态 → 资源配额 → 备份策略的顺序执行，任一环节未通过则进入阻断流程。

4.6 巡检报告模板

每次巡检完成后，需填写以下标准化报告模板，作为迁移审批的附件材料。