pipekit13/agent

Pipekit Agent Operator 镜像文档

镜像概述

Pipekit Agent Operator 镜像用于部署和运行 Pipekit Agent Operator 组件，其核心功能是在 Kubernetes 集群与 Pipekit 平台之间建立安全、稳定的连接通道，实现集群资源与 Pipekit 平台的集成管理和通信交互。

核心功能与特性

• 集群连接管理：提供 Kubernetes 集群与 Pipekit 平台的双向通信机制，确保数据传输安全可靠
• 状态同步：实时同步 Kubernetes 集群状态与 Pipekit 平台，包括资源信息、运行状态等
• 配置管理：支持通过环境变量或配置文件自定义连接参数，灵活适配不同集群环境
• 自动恢复：具备连接异常检测与自动重连能力，保障通信链路稳定性

使用场景

• DevOps 团队需将 Kubernetes 集群与 Pipekit 平台集成，实现集群资源的统一管理
• 需要通过 Pipekit 平台监控、调度或管理 Kubernetes 集群中资源的场景
• 多集群环境下，需通过统一入口（Pipekit 平台）管理各 Kubernetes 集群的场景

使用方法与配置说明

环境变量配置

运行镜像时需通过环境变量指定关键配置参数，常用参数如下：

部署示例

Docker Run 部署

通过 docker run 命令直接运行镜像，需挂载 Kubernetes 配置文件（如需要）并指定必要环境变量：

bash
docker run -d \
  --name pipekit-agent-operator \
  -e PIPEKIT_API_KEY="your-pipekit-api-key" \
  -e LOG_LEVEL="info" \
  -v /path/to/local/kubeconfig:/root/.kube/config \  # 挂载本地 Kubernetes 配置文件（如集群内运行可省略）
  pipekit/agent-operator:latest

Kubernetes 部署（推荐）

对于 Kubernetes 集群内部署，建议通过容器化方式直接运行，可配合 Deployment 资源实现高可用：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: pipekit-agent-operator
  namespace: pipekit
spec:
  replicas: 1
  selector:
    matchLabels:
      app: pipekit-agent-operator
  template:
    metadata:
      labels:
        app: pipekit-agent-operator
    spec:
      containers:
      - name: agent-operator
        image: pipekit/agent-operator:latest
        env:
        - name: PIPEKIT_API_KEY
          valueFrom:
            secretKeyRef:
              name: pipekit-secrets
              key: api-key
        - name: LOG_LEVEL
          value: "info"
        volumeMounts:
        - name: kubeconfig
          mountPath: /root/.kube/config
          readOnly: true
      volumes:
      - name: kubeconfig
        secret:
          secretName: kubeconfig-secret  # 包含 Kubernetes 集群配置的 Secret

验证部署

部署完成后，可通过查看容器日志验证连接状态：

bash
docker logs -f pipekit-agent-operator
# 预期日志输出示例：
# INFO[0000] Successfully connected to Pipekit platform 
# INFO[0001] Kubernetes cluster status synchronized with Pipekit 

注意事项

• 确保 PIPEKIT_API_KEY 具有足够权限，建议通过 Secret 管理敏感信息，避免明文暴露
• 若在 Kubernetes 集群内运行，可直接使用集群内服务账户（Service Account）获取 Kubernetes API 访问权限，无需挂载外部 kubeconfig
• 镜像版本建议使用固定标签（如 v1.0.0）而非 latest，以确保部署稳定性