用途
agent-install 用于在 Kubernetes 集群上使用 Datadog Operator 安装 Datadog Agent。该步骤是启用单步插桩（Single Step Instrumentation，SSI）之前所必需的。
主要能力
- 在开始操作前，先解析所有上下文变量（CLUSTER_NAME、DD_SITE、AGENT_NAMESPACE、CHART_VERSION）。
- 加载凭据，检查 DD_API_KEY、DD_SITE 与 helm 是否可用。
- 检查集群中是否已存在 Datadog Agent 安装，如已存在则跳至健康确认。
- 通过 Helm 安装 Datadog Operator 并等待其就绪。
- 以命令式方式创建 API Key Secret（datadog-secret）。
- 部署 DatadogAgent 资源，并根据集群类型（自托管或托管）决定是否包含 kubelet.tlsVerify: false。
- 验证 API Key 是否被接受，如无效则给出替换与重启步骤。
- 完成安装后自动继续启用 SSI，不询问用户许可。
使用方式
技能会按阶段引导操作：
- Phase 0：加载凭据。若 helm 缺失则要求用户安装（macOS 可用 brew install helm，其它平台参见 https://helm.sh/docs/intro/install/）；若 DD_API_KEY 未设置，则要求用户在会话中执行
! export DD_API_KEY=your-api-key-here与! export DD_SITE=datadoghq.com。 - 前置条件：Kubernetes v1.20+、helm v3+、kubectl 已配置目标集群、pup-cli 已安装（缺失时提供安装命令）。
- 检查是否已有 Agent 安装。
- 安装 Datadog Operator。
- 创建 API Key Secret。
- 部署 DatadogAgent 资源。
- 验证 API Key。
适用场景
- 需要在 Kubernetes 集群上部署 Datadog Agent 并准备启用 SSI 的场景。
- 需要统一管理 Datadog Agent 安装流程、凭据与验证步骤的场景。
限制与安全约束
- 必须满足 Kubernetes v1.20+、helm v3+、kubectl 已配置目标集群、pup-cli 已安装等前置条件。
- 需要提供 Datadog API Key 与 Datadog Site。
- 安全约束：不得将原始 API Key 写入任何文件、YAML 块或聊天消息，始终使用 $DD_API_KEY；不得创建 Kubernetes Secret 清单文件，始终使用 kubectl create secret 命令式创建；不得在 DatadogAgent spec 中直接使用 apiKey:，始终使用 apiSecret: 引用；不得在任何 Helm 命令中使用 --set datadog.apiKey=...；不得使用 default 命名空间存放 Datadog Agent 资源；不得在未经用户确认的情况下运行 kubectl delete。
- 该技能是否收费、价格、具体版本号等未尽信息暂未提供。