portworx/px-tc-operator-manager Docker 镜像 - 轩辕镜像

Target Cluster Operator 镜像文档

1. 镜像概述

Target Cluster Operator 是一个 Kubernetes 自定义控制器（Operator），专为管理和操作目标 Kubernetes 集群设计。它通过自定义资源定义（CRD）扩展 Kubernetes API，提供对目标集群的资源管理、状态监控、配置同步及自动化运维能力，简化多集群环境下的管理复杂度。

2. 核心功能与特性

2.1 核心功能

• 集群资源管理：创建、更新、删除目标集群中的 Kubernetes 资源（如 Deployment、Service、ConfigMap 等）
• 状态监控：实时监控目标集群的健康状态、资源使用率及关键组件运行情况
• 自动化运维：支持基于预设规则的自动化操作，如资源扩缩容、故障自愈、配置同步
• 配置管理：集中管理目标集群的配置信息，支持配置版本控制与回滚

2.2 主要特性

• 基于 Kubernetes Operator SDK 构建，符合 Kubernetes 扩展最佳实践
• 支持多目标集群管理，可同时操作多个独立 Kubernetes 集群
• 提供自定义资源（CR）接口，通过 YAML 声明式配置管理目标集群
• 内置健康检查与故障恢复机制，确保操作可靠性
• 兼容 Kubernetes 1.19+ 版本

3. 使用场景与适用范围

3.1 典型使用场景

• 多集群统一管理：在管理集群中部署 Operator，集中管控多个目标业务集群
• 跨集群资源调度：根据目标集群负载情况，自动调度资源分配
• 集群运维自动化：实现跨集群的配置同步、版本升级、故障迁移等自动化操作
• 集群状态监控：汇总多集群监控数据，提供统一视图与告警能力

3.2 适用范围

• 企业级多 Kubernetes 集群环境
• 需要跨集群资源管理与调度的场景
• 追求集群运维自动化与标准化的团队
• Kubernetes 1.19 及以上版本集群

4. 使用方法与配置说明

4.1 前置条件

• Kubernetes 集群（管理集群）版本 ≥ 1.19
• kubectl 命令行工具配置完成并具有集群管理员权限
• 目标集群的 Kubeconfig 文件（用于 Operator 访问目标集群）

4.2 部署步骤

4.2.1 部署 CRD

首先部署 Operator 所需的自定义资源定义（CRD）：

bash
kubectl apply -f [***]

4.2.2 部署 Operator

通过 Kubernetes Deployment 部署 Operator：

yaml
# operator-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: target-cluster-operator
  namespace: target-cluster-system
spec:
  replicas: 1
  selector:
    matchLabels:
      name: target-cluster-operator
  template:
    metadata:
      labels:
        name: target-cluster-operator
    spec:
      serviceAccountName: target-cluster-operator
      containers:
        - name: target-cluster-operator
          image: [镜像仓库地址]/target-cluster-operator:latest
          env:
            - name: WATCH_NAMESPACE
              valueFrom:
                fieldRef:
                  fieldPath: metadata.namespace
            - name: POD_NAME
              valueFrom:
                fieldRef:
                  fieldPath: metadata.name
            - name: OPERATOR_NAME
              value: "target-cluster-operator"
            - name: TARGET_CLUSTER_DEFAULT_KUBECONFIG_SECRET
              value: "target-cluster-kubeconfig" # 存储目标集群 Kubeconfig 的 Secret 名称

应用部署配置：

bash
kubectl apply -f operator-deployment.yaml

4.2.3 创建目标集群资源

通过自定义资源（CR）定义目标集群：

yaml
# example-target-cluster.yaml
apiVersion: targetcluster.example.com/v1alpha1
kind: TargetCluster
metadata:
  name: example-cluster
spec:
  kubeconfigSecret: target-cluster-kubeconfig # 引用存储 Kubeconfig 的 Secret
  monitorInterval: 30s # 状态监控间隔
  resourceSyncPolicy:
    enabled: true
    syncInterval: 5m # 资源同步间隔
  autoHealing:
    enabled: true
    maxRetry: 3 # 故障自愈最大重试次数

应用目标集群配置：

bash
kubectl apply -f example-target-cluster.yaml

4.3 环境变量配置

4.4 自定义资源（CR）配置说明

TargetCluster CR 主要配置字段说明：

5. 验证与监控

5.1 验证部署状态

检查 Operator Pod 运行状态：

bash
kubectl get pods -n target-cluster-system

检查目标集群状态：

bash
kubectl get targetclusters.targetcluster.example.com example-cluster -o yaml

5.2 监控指标

Operator 暴露 Prometheus 指标接口，默认端口 8383，可通过 Service 暴露后接入 Prometheus：

yaml
# metrics-service.yaml
apiVersion: v1
kind: Service
metadata:
  name: target-cluster-operator-metrics
  namespace: target-cluster-system
spec:
  selector:
    name: target-cluster-operator
  ports:
  - port: 8383
    targetPort: 8383
    name: metrics

常见指标包括：target_cluster_health_status（集群健康状态）、target_cluster_resource_sync_count（资源同步次数）等。

6. 故障排查

6.1 常见问题及解决方法

• Operator 启动失败：检查 Kubeconfig Secret 是否正确配置，权限是否足够
• 目标集群连接失败：验证 Kubeconfig 有效性，网络是否通畅，目标集群 API Server 是否可达
• 资源同步失败：检查目标集群资源权限，同步策略配置是否正确，查看 Operator 日志获取详细错误信息

6.2 查看日志

bash
kubectl logs -n target-cluster-system deployment/target-cluster-operator -f