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 액션)을 사용하려면 허용 목록을 설정하지 마세요.

설치 후 Private Action Runners로 이동하여 러너가 목록에 나타나는지 확인하세요.

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를 재시작한 후 Private Action Runners로 이동하여 러너가 목록에 나타나는지 확인하세요.

호스트 프로세스는 노드 Agent 러너를 실행합니다. Cluster Agent에서 러너를 실행하려면 Kubernetes(Helm) 또는 Kubernetes(Operator) 탭을 사용하세요.

Datadog Helm 차트는 다음 두 위치에서 러너를 활성화할 수 있습니다.

• 노드 Agent 러너는 사이드카 컨테이너로 실행됩니다. 노드 Agent 러너는 Linux 전용입니다.
• Cluster Agent 러너는 프로세스 내에서 실행됩니다. Cluster Agent 러너는 Helm 또는 Operator를 통해서만 사용할 수 있으며(독립형 바이너리는 제공되지 않음), Cluster Agent 복제본 간에 ID가 조정되도록 리더를 선출해야 합니다.

Organization Settings에서 Private Action Runner 기능이 있는 API 키를 생성한 후 차트가 apiKeyExistingSecret을 통해 읽을 수 있도록 Kubernetes 시크릿에 저장하세요.

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

이 예시에서는 API 키만 사용하는 apiKeyOnlyEnrollment: true를 설정하여 러너를 소유자가 없는 상태로 등록하며, Execution Policies를 통해 권한을 부여합니다. 기타 등록 옵션 및 소유권 작동 방식은 등록 및 소유권을 참조하세요.

Helm 설정에서는 camelCase 형식의 privateActionRunner.* 키를 사용합니다. 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

설치 후 Private Action Runners로 이동하여 러너가 목록에 나타나는지 확인하세요.

Datadog Operator에서는 DatadogAgent 리소스의 주석을 통해 러너를 활성화합니다. -configdata 주석의 러너 구성은 snake_case 형식의 private_action_runner.* 키를 사용합니다. Operator에서는 노드 Agent 러너와 프로세스 내 Cluster Agent 러너를 모두 활성화할 수 있습니다.

Organization Settings에서 Private Action Runner 기능이 있는 API 키를 생성한 후 DatadogAgent 리소스가 credentials를 통해 읽을 수 있도록 Kubernetes 시크릿에 저장하세요.

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

이 예시에서는 API 키만 사용하는 api_key_only_enrollment: true를 설정하여 러너를 소유자가 없는 상태로 등록하며, Execution Policies를 통해 권한을 부여합니다. 기타 등록 옵션 및 소유권 작동 방식은 등록 및 소유권을 참조하세요.

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 전용입니다. 매니페스트를 적용한 후 Private Action Runners로 이동하여 러너가 목록에 나타나는지 확인하세요.

1. /etc/datadog-agent/datadog.yaml에서 private_action_runner.actions_allowlist 섹션을 편집합니다.
2. sudo systemctl restart datadog-agent를 실행하여 Agent를 재시작합니다.

1. C:\ProgramData\Datadog\datadog.yaml에서 private_action_runner.actions_allowlist 섹션을 편집합니다.
2. Restart-Service -Force datadogagent를 실행하여 Agent를 재시작합니다.

1. 두 DatadogAgent 매니페스트 주석 agent.datadoghq.com/private-action-runner-configdata 및 cluster-agent.datadoghq.com/private-action-runner-configdata에서 actions_allowlist를 업데이트합니다.
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 러너는 ID를 공유 Kubernetes 시크릿에 저장하므로 업데이트 후에도 동일한 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>"