集群API生命周期管理

技能简介

k8s-capi 提供 Cluster API 生命周期管理能力，支持 Kubernetes 集群的创建、扩缩容和版本升级。通过声明式 API 统一管理多集群基础设施，适用于需要标准化集群运维的场景。

能做什么

• 创建和删除 Kubernetes 集群
• 查看集群状态与网络配置
• 获取工作负载集群的 kubeconfig
• 列出和管理集群节点（Machine）
• 扩缩容工作节点（Machine Deployment）
• 配置机器健康检查自动修复
• 使用 ClusterClass 模板复用集群配置

使用说明

1. 安装检测

capi_detect_tool()

2. 创建新集群

kubectl_apply(manifest="""
apiVersion: cluster.x-k8s.io/v1beta1
kind: Cluster
metadata:
  name: my-cluster
  namespace: default
spec:
  clusterNetwork:
    pods:
      cidrBlocks:
      - 192.168.0.0/16
    services:
      cidrBlocks:
      - 10.96.0.0/12
  controlPlaneRef:
    apiVersion: controlplane.cluster.x-k8s.io/v1beta1
    kind: KubeadmControlPlane
    name: my-cluster-control-plane
  infrastructureRef:
    apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
    kind: AWSCluster
    name: my-cluster
""")

3. 等待集群就绪并获取访问凭证

capi_clusters_list_tool(namespace="default")
capi_cluster_kubeconfig_tool(name="my-cluster", namespace="default")

4. 扩容工作节点

capi_machinedeployment_scale_tool(
    name="my-cluster-md-0",
    namespace="default",
    replicas=5
)

输入与输出

见下方输入与输出表格。

风险提示

• 删除集群操作不可逆，会释放所有云资源
• 版本升级前需验证控制平面兼容性
• 扩缩容操作可能影响运行中的业务负载
• 基础设施提供商配置错误会导致集群无法创建
• kubeconfig 泄露可能导致未授权集群访问

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rohitg00/k8s-capi/SKILL.md
来源类型：GitHub 仓库