Establezca las siguientes variables de entorno cuando instale o ejecute el Agent. En el servidor, la configuración del ejecutor de acciones privadas utiliza el prefijo 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 inscribe al ejecutor como propiedad, igual que Fleet Automation. La clave de aplicación necesita el contexto on_prem_runner_write. DD_PRIVATE_ACTION_RUNNER_ACTIONS_ALLOWLIST acepta una lista separada por comas. Utilice comodines de bundle para permitir las acciones que puede ejecutar un ejecutor en el Datadog Agent: com.datadoghq.kubernetes.* y com.datadoghq.remoteaction.*. Para depender de las acciones predeterminadas integradas del ejecutor (acciones de Remote Action de solo lectura, además de un conjunto de acciones de Kubernetes de solo lectura en el Cluster Agent), deje la lista de permitidos sin configurar.

Después de la instalación, vaya a Private Action Runners para verificar que su ejecutor aparezca en la lista.

Instale o actualice a Datadog Agent 7.81.0 o posterior, luego edite 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 inscribe al ejecutor como propiedad, igual que Fleet Automation anteriormente; la clave de aplicación necesita el contexto on_prem_runner_write.

Reinicie el Agente para aplicar la configuración:

Restart-Service -Force datadogagent

Después de reiniciar el Agente, vaya a Private Action Runners para verificar que su ejecutor aparezca en la lista.

El proceso del servidor ejecuta el ejecutor de Agente de nodo. Para ejecutar un ejecutor en el Agente de clúster, utilice la pestaña de Kubernetes (Helm) o Kubernetes (Operator).

El chart de Helm de Datadog puede habilitar el ejecutor en dos lugares:

• El ejecutor de Agente de nodo, como contenedor sidecar. El ejecutor del Agente de nodo es solo para Linux.
• El ejecutor de Agente de clúster, en proceso. El ejecutor del Agente de clúster solo está disponible a través de Helm o del Operator (no existe un binario independiente) y requiere una elección de líder para que la identidad se coordine entre las réplicas del Agente de clúster.

Cree una clave de API con la capacidad de Private Action Runner en Organization Settings, luego guárdela en un secreto de Kubernetes que el chart lea a través de apiKeyExistingSecret:

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

Este ejemplo inscribe al ejecutor como sin propietario (apiKeyOnlyEnrollment: true, usando solo la clave de API), lo cual lo autoriza con Execution Policies. Para otras opciones de inscripción y cómo funciona la propiedad, consulte Enrollment and ownership.

La configuración de Helm utiliza la clave privateActionRunner.* en camelCase. Cree un 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.*"

Para conocer todas las opciones de configuración del ejecutor disponibles, consulte datadog.privateActionRunner y clusterAgent.privateActionRunner en el chart de Helm. Instale el chart:

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

Después de la instalación, vaya a Private Action Runners para verificar que su ejecutor aparezca en la lista.

El Datadog Operator habilita el ejecutor a través de anotaciones en el recurso DatadogAgent. La configuración del ejecutor en la anotación -configdata utiliza la clave private_action_runner.* en snake_case. El Operator puede habilitar tanto el ejecutor del Agente de nodo como el ejecutor del Agente de clúster en proceso.

Cree una clave de API con la capacidad de Private Action Runner en Organization Settings, luego guárdela en un secreto de Kubernetes que el recurso DatadogAgent lea a través de su credentials:

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

Este ejemplo inscribe al ejecutor como sin propietario (api_key_only_enrollment: true, usando solo la clave de API), lo cual lo autoriza con Execution Policies. Para otras opciones de inscripción y cómo funciona la propiedad, consulte Enrollment and ownership.

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

Aplique el manifiesto:

kubectl apply -f datadog-agent.yaml

Al igual que con Helm, el ejecutor del Cluster Agent requiere una elección de líder, y el ejecutor del Agente de nodo solo está disponible para Linux. Después de aplicar el manifiesto, vaya a Private Action Runners para verificar que su ejecutor aparezca en la lista.

1. Edite la sección private_action_runner.actions_allowlist en /etc/datadog-agent/datadog.yaml.
2. Reinicie el Agent: sudo systemctl restart datadog-agent.

1. Edite la sección private_action_runner.actions_allowlist en C:\ProgramData\Datadog\datadog.yaml.
2. Reinicie el Agent: Restart-Service -Force datadogagent.

1. Actualice actions_allowlist en ambas anotaciones del manifiesto DatadogAgent: agent.datadoghq.com/private-action-runner-configdata y cluster-agent.datadoghq.com/private-action-runner-configdata.
2. Aplique el manifiesto actualizado: kubectl apply -f datadog-agent.yaml.

1. Actualice privateActionRunner.actionsAllowlist (node Agent) o clusterAgent.privateActionRunner.actionsAllowlist (Cluster Agent) en values.yaml.
2. Aplique el chart actualizado: helm upgrade datadog-agent datadog/datadog -f values.yaml.

Actualice el Datadog Agent a la versión más reciente. El runner viene incluido con el Agent.

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

O para RHEL/CentOS:

sudo yum update datadog-agent

Reinicie el Agent después de la actualización:

sudo systemctl restart datadog-agent

Para obtener instrucciones detalladas de actualización, consulte Upgrade to Agent v7.

Descargue el instalador MSI del Agent más reciente desde la página de descarga del Datadog Agent y ejecute el instalador, o utilice 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'

Reinicie el Agent después de la actualización:

Restart-Service -Force datadogagent

Actualice las versiones de imagen del Datadog Operator y del Agent en su manifiesto DatadogAgent.

1. Actualice el Datadog Operator:

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

   Puede fijar una versión específica. Para explorar las etiquetas disponibles, utilice Docker Hub.

2. Actualice las versiones de imagen del Agent en su manifiesto datadog-agent.yaml:

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

3. Aplique el manifiesto actualizado: kubectl apply -f datadog-agent.yaml.

4. Verifique la actualización:

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

El runner del Cluster Agent mantiene su identidad durante la actualización, ya que la almacena en un secreto de Kubernetes compartido. El runner del Agent de nodo almacena su identidad en un archivo: si esa ruta no está respaldada por un volumen persistente, una actualización puede borrar la identidad y obligar al runner a volver a inscribirse. Consulte Identity storage on Kubernetes.

La actualización del runner es parte del proceso estándar de actualización del chart de Helm del Datadog Agent.

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

Para obtener instrucciones detalladas sobre la actualización, consulte Upgrading Datadog Helm.

Actualice las variables de versión en su configuración de Terraform:

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

Aplique los cambios:

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