Signadot In-Cluster Agent 镜像文档

镜像概述和主要用途

Signadot In-Cluster Agent 是一个运行在 Kubernetes 集群内的代理组件，用于与 Signadot 服务建立安全通信，实现集群与 Signadot 服务之间的数据交互和功能集成。该镜像作为集群与 Signadot 服务的桥梁，负责中继信息、处理通信逻辑，是集成 Signadot 服务的核心组件。

核心功能和特性

• 安全通信：与 Signadot 服务建立加密连接，支持 TLS 协议，确保数据传输安全。
• 数据中继：转发 Kubernetes 集群内资源信息（如 Pod、Service 状态）与 Signadot 服务之间的数据。
• 认证授权：集成 Signadot 服务的认证机制，通过 API 令牌验证身份，确保仅授权集群可接入。
• 高可用性：实时监控连接状态，支持自动重连，保障服务持续可用。

使用场景和适用范围

适用场景

• Kubernetes 集群与 Signadot 服务集成，实现开发、测试流程自动化。
• 需要通过 Signadot 服务管理集群资源、执行特定操作（如微服务测试、流量路由）的场景。
• 集群与 Signadot 服务间需建立稳定、安全通信通道的环境。

适用范围

• 运行 Kubernetes 集群的环境（版本 1.19+）。
• 支持云厂商托管集群（如 EKS、GKE、AKS）及本地自建集群。

使用方法和配置说明

部署前提

• 已获取 Signadot 服务的 API 令牌（通过 Signadot 控制台创建）。
• 集群网络可访问 Signadot 服务端点（默认：[***]）。

部署方式（Kubernetes）

推荐通过 Kubernetes Deployment 部署，示例配置如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: signadot-agent
  namespace: signadot
spec:
  replicas: 1
  selector:
    matchLabels:
      app: signadot-agent
  template:
    metadata:
      labels:
        app: signadot-agent
    spec:
      containers:
      - name: signadot-agent
        image: signadot/agent:latest  # 替换为实际镜像标签
        env:
        - name: SIGNADOT_API_TOKEN
          valueFrom:
            secretKeyRef:
              name: signadot-secrets
              key: api-token
        - name: SIGNADOT_SERVICE_URL
          value: "[***]"  # Signadot 服务地址
        - name: LOG_LEVEL
          value: "info"  # 日志级别：debug, info, warn, error
        resources:
          requests:
            cpu: 100m
            memory: 128Mi
          limits:
            cpu: 500m
            memory: 256Mi

配置参数说明

通过环境变量配置 Agent 行为，常用参数如下：

验证部署

部署后，通过查看 Pod 日志确认 Agent 状态：

kubectl logs -n signadot <signadot-agent-pod-name>

若日志显示 Successfully connected to Signadot service，则部署成功。

注意事项

• API 令牌需妥善保管，建议通过 Kubernetes Secret 挂载，避免明文暴露。
• 集群网络策略需允许 Agent 访问 Signadot 服务端点（默认端口 443）。
• 升级 Agent 时，建议先查阅 Signadot 官方文档，确认兼容性。