digitalocean/do-operator

DigitalOcean Kubernetes Operator (do-operator)

镜像概述

DigitalOcean Kubernetes Operator（do-operator）是一个基于Kubernetes Operator模式构建的控制器，用于在Kubernetes集群中声明式管理DigitalOcean云资源。它通过Kubernetes API扩展（Custom Resource Definitions, CRDs）实现DigitalOcean资源（如Droplets、Load ***s、Spaces等）的定义、创建、更新和删除，简化云资源与Kubernetes集群的集成和自动化运维流程。

核心功能与特性

• 声明式资源管理：通过Kubernetes YAML配置文件声明DigitalOcean资源需求，支持基础设施即代码（IaC）实践。
• Kubernetes原生集成：与Kubernetes API深度整合，可通过kubectl等工具直接管理DigitalOcean资源。
• 自动化状态同步：实时监控DigitalOcean资源状态，自动修复与期望状态的偏差，确保资源一致性。
• 多资源类型支持：覆盖多种DigitalOcean核心资源，包括但不限于负载均衡器、虚拟机（Droplets）、存储桶（Spaces）等。
• 高可用性设计：支持多副本部署，具备故障自动恢复能力，保障控制器服务稳定性。

使用场景与适用范围

• 云资源与Kubernetes协同管理：适用于在Kubernetes环境中需要统一管理DigitalOcean云资源的用户，如开发者、SRE、DevOps团队。
• 自动化运维流程：替代手动操作，通过声明式配置实现DigitalOcean资源的全生命周期自动化管理。
• GitOps工作流适配：支持将资源配置纳入版本控制，配合GitOps工具（如ArgoCD、Flux）实现配置变更的自动化部署。
• 多团队协作场景：为跨团队提供统一的资源管理接口，简化云资源权限控制和协作流程。

使用方法与配置说明

安装前提

• 运行中的Kubernetes集群（推荐版本1.21+，具体兼容性参见官方文档）。
• 有效的DigitalOcean API令牌（需具备对应资源的操作权限）。
• kubectl命令行工具已配置并连接目标Kubernetes集群。

安装方式

详细安装步骤请参考官方GitHub仓库：https://github.com/digitalocean/do-operator%E3%80%82%E4%B8%BB%E8%A6%81%E5%AE%89%E8%A3%85%E6%96%B9%E5%BC%8F%E5%8C%85%E6%8B%AC%EF%BC%9A

1. 基于部署清单安装

通过官方提供的YAML清单直接部署：

bash
# 应用CRDs
kubectl apply -f https://raw.githubusercontent.com/digitalocean/do-operator/main/config/crd/bases/do.crossplane.io_digitaloceanresources.yaml
# 部署RBAC权限与控制器
kubectl apply -f https://raw.githubusercontent.com/digitalocean/do-operator/main/config/rbac/role.yaml
kubectl apply -f https://raw.githubusercontent.com/digitalocean/do-operator/main/config/manager/manager.yaml

2. Helm Chart安装

通过DigitalOcean Helm仓库安装（需先配置Helm）：

bash
# 添加Helm仓库
helm repo add digitalocean https://charts.digitalocean.com
helm repo update

# 安装Operator（需提前创建包含DigitalOcean API令牌的Secret）
helm install do-operator digitalocean/do-operator \
  --namespace do-operator \
  --create-namespace \
  --set config.digitaloceanAccessTokenSecret.name=do-operator-secret

配置说明

必要配置

需创建包含DigitalOcean API令牌的Secret，供Operator访问DigitalOcean API：

yaml
apiVersion: v1
kind: Secret
metadata:
  name: do-operator-secret
  namespace: do-operator
type: Opaque
data:
  access-token: <base64-encoded-digitalocean-api-token>  # 替换为Base64编码的API令牌

资源使用示例

创建DigitalOcean Load ***资源（CRD示例）：

yaml
apiVersion: do.crossplane.io/v1alpha1
kind: LoadBalancer
metadata:
  name: example-lb
spec:
  forProvider:
    region: nyc3  # 资源所在区域
    forwardingRules:
      - entryProtocol: tcp
        entryPort: 80
        targetProtocol: tcp
        targetPort: 80
    healthCheck:
      protocol: http
      path: /health
      port: 80
      checkIntervalSeconds: 10
      responseTimeoutSeconds: 5

更多信息

• 完整文档与更新日志：https://github.com/digitalocean/do-operator
• CRD定义与示例：参见仓库 config/crd/bases 目录
• 故障排查指南：参考仓库 docs/troubleshooting.md