Agent のインストール時または実行時に、以下の環境変数を設定します。ホスト上では、プライベートアクションランナーの設定に DD_PRIVATE_ACTION_RUNNER_* プレフィックスを使用します。

DD_API_KEY=<API_KEY> \
DD_APP_KEY=<APP_KEY> \
DD_SITE="<span class="js-region-param region-param" data-region-param="dd_site"></span>" \
DD_PRIVATE_ACTION_RUNNER_ENABLED=true \
DD_PRIVATE_ACTION_RUNNER_ACTIONS_ALLOWLIST=com.datadoghq.kubernetes.*,com.datadoghq.remoteaction.* \
bash -c "$(curl -L https://install.datadoghq.com/scripts/install_script_agent7.sh)"

DD_APP_KEY は、Fleet Automation と同様、ランナーを所有者付きとして登録します。アプリケーションキーには on_prem_runner_write スコープが必要です。DD_PRIVATE_ACTION_RUNNER_ACTIONS_ALLOWLIST はカンマ区切りのリストを受け取ります。バンドルのワイルドカードを使用して、Datadog Agent のランナーが実行できるアクションを許可します。com.datadoghq.kubernetes.* および com.datadoghq.remoteaction.*。代わりにランナーの組み込みデフォルトアクション (読み取り専用の Remote Action アクションと、Cluster Agent 上の読み取り専用 Kubernetes アクションのセット) に依存する場合は、許可リストを未設定のままにします。

インストール後、プライベートアクションランナー に移動し、ランナーがリストにあることを確認します。

Datadog Agent 7.81.0 以降をインストールまたはアップグレードし、C:\ProgramData\Datadog\datadog.yaml を編集します。

app_key: <YOUR_APP_KEY>

private_action_runner:
  enabled: true
  self_enroll: true
  actions_allowlist:
    - "com.datadoghq.kubernetes.*"
    - "com.datadoghq.remoteaction.*"

app_key は、上記の Fleet Automation と同様、ランナーを所有者付きとして登録します。アプリケーションキーには on_prem_runner_write スコープが必要です。

Agent を再起動して、構成を適用します。

Restart-Service -Force datadogagent

Agent の再起動後、プライベートアクションランナー に移動して、ランナーがリストにあることを確認します。

ホストプロセスはノード Agent ランナーを実行します。Cluster Agent でランナーを実行するには、Kubernetes (Helm) または Kubernetes (Operator) タブを使用します。

Datadog Helm チャートでは、以下の 2 か所でランナーを有効にできます。

• サイドカーコンテナとしてのノード Agent ランナー。ノード Agent ランナーは Linux 専用です。
• プロセス内での Cluster Agent ランナー。Cluster Agent ランナーは Helm または Operator を通じてのみ利用可能であり (スタンドアロンバイナリはありません)、Cluster Agent レプリカ間で ID が調整されるようにリーダー選出が必要です。

組織の設定 でプライベートアクションランナー機能を持つ API キーを作成し、チャートが apiKeyExistingSecret を通じて読み取る Kubernetes シークレットに保存します。

kubectl create secret generic datadog-secret \
  --from-literal api-key=<DD_API_KEY>

この例では、ランナーを所有者なし (apiKeyOnlyEnrollment: true、API キーのみを使用) として登録します。これにより、実行ポリシーで認証されます。その他の登録オプションや所有権の仕組みについては、登録と所有権 を参照してください。

Helm 設定では、privateActionRunner.* キーを camelCase で使用します。values.yaml を作成します。

datadog:
  apiKeyExistingSecret: datadog-secret
  site: <span class="js-region-param region-param" data-region-param="dd_site"></span>
  clusterName: <YOUR_CLUSTER_NAME>
  remoteConfiguration:
    enabled: true
  privateActionRunner:
    enabled: true
    apiKeyOnlyEnrollment: true
    actionsAllowlist:
      - "com.datadoghq.remoteaction.*"
      - "com.datadoghq.script.*"
clusterAgent:
  enabled: true
  privateActionRunner:
    enabled: true
    apiKeyOnlyEnrollment: true
    actionsAllowlist:
      - "com.datadoghq.kubernetes.*"
      - "com.datadoghq.script.*"

利用可能なすべてのランナーコンフィギュレーションオプションについては、Helm チャートの datadog.privateActionRunner および clusterAgent.privateActionRunner を参照してください。チャートのインストール:

helm repo add datadog https://helm.datadoghq.com
helm repo update
helm install datadog-agent datadog/datadog -f values.yaml

インストール後、プライベートアクションランナー に移動して、ランナーがリストにあることを確認します。

Datadog Operator は、DatadogAgent リソースのアノテーションを通じてランナーを有効にします。-configdata アノテーション内のランナー構成では、snake_case の private_action_runner.* キーを使用します。Operator は、ノード Agent ランナーとインプロセス Cluster Agent ランナーの両方を有効にできます。

組織の設定 でプライベートアクションランナー機能を持つ API キーを作成し、DatadogAgent リソースがその credentials を通じて読み取る Kubernetes シークレットに保存します。

kubectl create secret generic datadog-secret \
  --from-literal api-key=<DD_API_KEY>

この例では、ランナーを所有者なし (api_key_only_enrollment: true、API キーのみを使用) として登録します。これにより、実行ポリシーで認証されます。その他の登録オプションや所有権の仕組みについては、登録と所有権 を参照してください。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
  annotations:
    agent.datadoghq.com/private-action-runner-enabled: "true"
    agent.datadoghq.com/private-action-runner-configdata: |
      private_action_runner:
        enabled: true
        api_key_only_enrollment: true
        actions_allowlist:
          - "com.datadoghq.remoteaction.*"
          - "com.datadoghq.script.*"
    cluster-agent.datadoghq.com/private-action-runner-enabled: "true"
    cluster-agent.datadoghq.com/private-action-runner-configdata: |
      private_action_runner:
        enabled: true
        api_key_only_enrollment: true
        actions_allowlist:
          - "com.datadoghq.kubernetes.*"
          - "com.datadoghq.script.*"
spec:
  global:
    clusterName: <YOUR_CLUSTER_NAME>
    site: <span class="js-region-param region-param" data-region-param="dd_site"></span>
    credentials:
      apiSecret:
        secretName: datadog-secret
        keyName: api-key

マニフェストを適用します。

kubectl apply -f datadog-agent.yaml

Helm と同様、Cluster Agent ランナーにはリーダー選出が必要であり、ノード Agent ランナーは Linux 専用です。マニフェストを適用した後、プライベートアクションランナー に移動して、ランナーがリストにあることを確認します。

1. /etc/datadog-agent/datadog.yaml の private_action_runner.actions_allowlist セクションを編集します。
2. Agent を再起動します: sudo systemctl restart datadog-agent。

1. C:\ProgramData\Datadog\datadog.yaml の private_action_runner.actions_allowlist セクションを編集します。
2. Agent を再起動します: Restart-Service -Force datadogagent。

1. 両方の DatadogAgent マニフェストアノテーションの actions_allowlist を更新します。agent.datadoghq.com/private-action-runner-configdata および cluster-agent.datadoghq.com/private-action-runner-configdata。
2. 更新されたマニフェストを適用します。kubectl apply -f datadog-agent.yaml。

1. values.yaml で privateActionRunner.actionsAllowlist (ノード Agent) または clusterAgent.privateActionRunner.actionsAllowlist (Cluster Agent) を更新します。
2. 更新されたチャートを適用します。helm upgrade datadog-agent datadog/datadog -f values.yaml。

Datadog Agent を最新バージョンにアップグレードします。ランナーは Agent にバンドルされています。

sudo apt-get update && sudo apt-get install datadog-agent

または RHEL/CentOS の場合:

sudo yum update datadog-agent

アップグレード後に Agent を再起動します。

sudo systemctl restart datadog-agent

詳細なアップグレード手順については、Agent v7 へのアップグレード を参照してください。

Datadog Agent ダウンロードページ から最新の Agent MSI インストーラーをダウンロードして実行するか、PowerShell を使用します。

# Download the latest installer
Invoke-WebRequest -Uri "https://s3.amazonaws.com/ddagent-windows-stable/ddagent-cli-latest.msi" -OutFile ddagent-cli-latest.msi

# Run the installer
Start-Process -Wait -PassThru msiexec -ArgumentList '/qn /i ddagent-cli-latest.msi'

アップグレード後に Agent を再起動します。

Restart-Service -Force datadogagent

DatadogAgent マニフェスト内の Datadog Operator および Agent イメージバージョンを更新します。

1. Datadog Operator を更新します。

   helm repo update
   helm upgrade datadog-operator datadog/datadog-operator \
       --set image.repository=registry.datadoghq.com/operator \
       --set image.tag=latest
   

   特定のバージョンを固定できます。利用可能なタグを参照するには、Docker Hub を使用します。

2. datadog-agent.yamlマニフェスト内の Agent イメージバージョンを更新します。

   override:
     nodeAgent:
       image:
         name: registry.datadoghq.com/agent:<NEW_AGENT_VERSION>
     clusterAgent:
       image:
         name: registry.datadoghq.com/cluster-agent:<NEW_AGENT_VERSION>
   

3. 更新されたマニフェストを適用します。kubectl apply -f datadog-agent.yaml。

4. 更新を確認します。

   kubectl get pods
   kubectl logs -l app.kubernetes.io/component=cluster-agent --tail=100 | grep private
   

Cluster Agent ランナーは、共有 Kubernetes シークレットに ID を保存するため、更新後もその ID を保持します。ノード Agent ランナーは ID をファイルに保存します。そのパスが永続ボリュームによってバックアップされていない場合、更新によって ID が消去され、ランナーが再登録を強制される可能性があります。Kubernetes 上の ID ストレージ を参照してください。

ランナーの更新は、標準の Datadog Agent Helm チャートアップグレードプロセスの一部です。

helm repo update
helm upgrade datadog-agent datadog/datadog -f values.yaml

詳細なアップグレード手順については、Datadog Helm のアップグレード を参照してください。

Terraform 構成内のバージョン変数を更新します。

locals {
  helm_operator_version = "<NEW_OPERATOR_VERSION>"
  agent_version         = "<NEW_AGENT_VERSION>"
  # ...
}

変更を適用します。

terraform plan
terraform apply -var="datadog_api_key=<YOUR_API_KEY>" -var="datadog_app_key=<YOUR_APP_KEY>"