解决Actions Runner Controller中CRD资源无法删除的问题

问题背景

在使用GitHub Actions Runner Controller（ARC）时，用户可能会遇到无法删除autoscalingrunnersets和ephemeralrunnersets这两个Custom Resource Definitions（CRD）的情况。这个问题通常发生在尝试升级或重新安装ARC时，导致系统处于不一致状态。

问题现象

当尝试删除这些CRD时，命令会挂起无法完成。通过kubectl get命令查看CRD状态，可以看到它们处于删除挂起状态，并且带有customresourcecleanup.apiextensions.k8s.io终结器。

根本原因

这种情况通常是由于：

1. 控制器被删除前未能完成资源清理
2. 存在使用这些CRD定义的资源实例
3. 资源实例上存在终结器阻碍了删除操作

解决方案

1. 检查并删除相关资源实例

首先检查是否存在使用这些CRD的资源实例：

kubectl get AutoscalingRunnerSet -n <namespace>
kubectl get ephemeralrunnersets.actions.github.com -n <namespace>

2. 手动移除终结器

对于挂起的资源实例，手动移除其终结器：

kubectl patch <resource_type> <resource_name> -n <namespace> \
  -p '{"metadata":{"finalizers":[]}, "spec":{"patchID":1}}' \
  --type=merge

例如：

kubectl patch ephemeralrunnersets.actions.github.com arc-runner-set-home-ops-xxkww \
  -n dev \
  -p '{"metadata":{"finalizers":[]}, "spec":{"patchID":1}}' \
  --type=merge

3. 完全清理CRD

确保删除所有四个CRD文件后再进行重新安装：

kubectl delete -f actions.github.com_autoscalinglisteners.yaml
kubectl delete -f actions.github.com_autoscalingrunnersets.yaml
kubectl delete -f actions.github.com_ephemeralrunners.yaml
kubectl delete -f actions.github.com_ephemeralrunnersets.yaml

最佳实践建议

1. 升级前准备：在升级ARC前，确保先删除所有RunnerSet资源
2. 删除顺序：先删除控制器，再删除CRD
3. 监控状态：操作后检查所有相关资源是否已完全清理
4. 命名空间隔离：避免在不同命名空间重复安装可能造成冲突

总结

ARC的CRD删除问题通常是由于资源清理不完整导致的。通过手动移除终结器和彻底清理相关资源，可以解决这一问题。在进行ARC的升级或重新安装时，建议按照上述步骤操作，确保系统处于干净状态后再进行新的部署。

对于更复杂的场景，如跨命名空间的残留问题，可能需要更深入的集群状态检查和清理。在极端情况下，重建集群可能是最彻底的解决方案。