digitalocean/digitalocean-cloud-controller-manager

DigitalOcean Kubernetes Cloud Controller Manager 镜像文档

镜像概述和主要用途

该镜像提供Kubernetes cloud-controller-manager的DigitalOcean实现，用于将Kubernetes集群与DigitalOcean云服务深度集成。通过与DigitalOcean API交互，自动化管理云资源（如节点、负载均衡器）的生命周期，并同步Kubernetes集群状态与云服务实际状态，确保集群在DigitalOcean环境中稳定高效运行。

核心功能和特性

• 节点生命周期管理：自动注册DigitalOcean Droplet为Kubernetes节点，监控节点健康状态，在Droplet删除时清理Kubernetes节点资源。
• 负载均衡器自动化：根据Kubernetes Service（类型为Load***）自动创建、配置和删除DigitalOcean Load ***，支持通过注解自定义负载均衡属性（如转发规则、健康检查、SSL终止）。
• 云资源状态同步：实时同步Kubernetes集群资源与DigitalOcean云资源状态，确保配置一致性（如节点标签、负载均衡器后端节点）。
• API兼容性：遵循Kubernetes cloud-controller-manager接口规范，兼容Kubernetes 1.24+版本，支持主流集群部署模式。
• 安全认证：通过DigitalOcean API令牌进行身份验证，支持最小权限配置，保障API访问安全性。

使用场景和适用范围

• 自管理Kubernetes集群：部署在DigitalOcean Droplet上的自建Kubernetes集群，需自动化管理云资源时使用。
• DigitalOcean Kubernetes (DOKS) 增强：作为DOKS集群的补充组件，扩展自定义云资源管理能力。
• 生产环境集群：需自动创建负载均衡器、管理节点生命周期的生产级集群，减少手动运维操作。
• 多团队协作：通过标准化云资源配置（如负载均衡器规格、SSL策略），确保团队间资源管理一致性。

使用方法和配置说明

前置条件

• 运行中的Kubernetes集群（版本1.24+）。
• 具有droplets:read/write、load_balancers:read/write权限的DigitalOcean API令牌。
• 已配置Kubernetes RBAC权限，允许cloud-controller-manager访问nodes、services、endpoints等资源。

部署方式

1. 创建API令牌Secret

bash
kubectl create secret generic digitalocean-api-token -n kube-system \
  --from-literal=access-token="YOUR_DIGITALOCEAN_API_TOKEN"

2. 部署Cloud Controller Manager

创建cloud-controller-manager.yaml部署文件：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: digitalocean-cloud-controller-manager
  namespace: kube-system
spec:
  replicas: 1
  selector:
    matchLabels:
      k8s-app: digitalocean-cloud-controller-manager
  template:
    metadata:
      labels:
        k8s-app: digitalocean-cloud-controller-manager
    spec:
      tolerations:
      - key: node-role.kubernetes.io/master
        effect: NoSchedule
      - key: node.cloudprovider.kubernetes.io/uninitialized
        value: "true"
        effect: NoSchedule
      containers:
      - name: digitalocean-cloud-controller-manager
        image: digitalocean/cloud-controller-manager:vX.Y.Z  # 替换为实际版本标签
        command:
        - /digitalocean-cloud-controller-manager
        - --cloud-provider=digitalocean
        - --cluster-name=my-digitalocean-cluster  # 替换为集群名称
        - --leader-elect=true
        - --v=2  # 日志verbosity级别
        env:
        - name: DIGITALOCEAN_ACCESS_TOKEN
          valueFrom:
            secretKeyRef:
              name: digitalocean-api-token
              key: access-token
        - name: DIGITALOCEAN_REGION
          value: "nyc3"  # 替换为集群所在DigitalOcean区域
        resources:
          requests:
            cpu: 100m
            memory: 512Mi

应用部署配置：

bash
kubectl apply -f cloud-controller-manager.yaml

配置参数说明

环境变量

• DIGITALOCEAN_ACCESS_TOKEN（必填）：DigitalOcean API访问令牌，用于认证API请求。
• DIGITALOCEAN_REGION（可选）：指定DigitalOcean区域，未指定时从节点metadata推断。

命令行参数

• --cloud-provider=digitalocean（必填）：指定云服务提供商为DigitalOcean。
• --cluster-name（必填）：Kubernetes集群名称，用于标识DigitalOcean资源归属。
• --leader-elect（默认true）：启用领导者选举，确保单实例运行，避免资源冲突。
• --v（默认2）：日志详细程度，取值范围1-10，数值越高日志越详细。

Service注解配置

通过Service注解自定义DigitalOcean Load ***，示例：

yaml
apiVersion: v1
kind: Service
metadata:
  name: example-service
  annotations:
    service.beta.kubernetes.io/do-loadbalancer-name: "example-lb"  # 负载均衡器名称
    service.beta.kubernetes.io/do-loadbalancer-size: "lb-small"    # 规格（lb-small/lb-medium/lb-large）
    service.beta.kubernetes.io/do-loadbalancer-ssl-certificate: "cert-id-123"  # 关联SSL证书
spec:
  type: LoadBalancer
  selector:
    app: example-app
  ports:
  - port: 80
    targetPort: 8080

验证与故障排查

• 验证部署状态：kubectl get pods -n kube-system | grep digitalocean-cloud-controller-manager
• 查看日志：kubectl logs -n kube-system <pod-name> -f
• 检查负载均衡器创建：登录DigitalOcean控制台，查看是否生成与Service对应的Load ***资源。