Descripción
La colección de Ansible en Datadog, datadog.dd
, es la colección oficial de contenidos de Datadog relacionados con Ansible. Contiene el rol Datadog Ansible, al que se puede acceder como datadog.dd.agent
, lo que te permite instalar y configurar el Datadog Agent y sus integraciones. El Agent versión 7 está instalado por defecto.
Requisitos
Ansible v2.10 o posterior.
Compatible con la mayoría de las distribuciones de Linux basadas en RHEL, SUSE y Debian, con macOS y Windows.
Para gestionar hosts de Windows, instala la colección ansible.windows
:
ansible-galaxy collection install ansible.windows
Cuando gestiones hosts openSUSE/SLES, instala la colección community.general
:
ansible-galaxy collection install community.general
Instalación
Para utilizar esta colección, debes instalarla utilizando la herramienta de línea de comandos Ansible Galaxy:
ansible-galaxy collection install datadog.dd
Como alternativa, inclúyela en un archivo requirements.yml
e instálala con ansible-galaxy collection install -r requirements.yml
. Incluye lo siguiente en requirments.yml
:
collections:
- name: datadog.dd
Nota: Si instalas la colección desde Ansible Galaxy, no se actualizará automáticamente cuando se actualice el paquete Ansible.
Para actualizar la colección a la última versión disponible, ejecuta el siguiente comando:
ansible-galaxy collection install datadog.dd --upgrade
Puedes instalar una versión específica de la colección, por ejemplo, si necesitas volver a una versión anterior cuando hay errores en la última versión (infórmanos cualquier problema en este repositorio). La siguiente sintaxis muestra cómo instalar la versión 5.0.0:
ansible-galaxy collection install datadog.dd:==5.0.0
Para obtener más detalles, consulta el uso de colecciones de Ansible.
La colección Ansible en Datadog también se encuentra disponible a través de Red Hat Automation Hub, donde está certificada oficialmente por Red Hat.
Casos de uso
Para desplegar el Datadog Agent en hosts, añade el rol de Datadog y tu clave de API a tu cuaderno de estrategias:
- hosts: servers
tasks:
- name: Import the Datadog Agent role from the Datadog collection
import_role:
name: datadog.dd.agent
vars:
datadog_api_key: "<YOUR_DD_API_KEY>"
Nota: Si instalas la colección a través del Ansible Automation Hub, la funcionalidad openSUSE/SLES dependerá de una colección de la comunidad community.general
. Red Hat no ofrece asistencia para problemas relacionados con contenidos de la comunidad. En caso de problemas de soporte para OpenSUSE/SLES, ponte en contacto con el servicio de asistencia de Datadog.
Tests
La colección de Datadog se ha probado en CentOS, Debian, Rocky Linux, openSUSE, Windows y macOS. Los tests se ejecutan con la última versión de ansible-lint
y los checks de estado con Python v3.9 a Python v3.12.
Soporte
Si necesitas ayuda, puedes crear un ticket en el repositorio GitHub de ansible-collections
o puedes ponerte en contacto con el servicio de asistencia de Datadog.
Notas sobre la versión
Puedes seguir los cambios en el archivo CHANGELOG.
Leer más
La colección de Ansible en Datadog se publica bajo Apache License 2.0.