본문 바로가기
WIKI 기술 지식 베이스

Ansible로 Datadog 에이전트 설치

원문 보기 위키 갱신

Datadog Ansible 컬렉션을 사용해 Datadog 에이전트와 통합을 자동으로 설치하고 구성해요.

출처: 문서

본문

개요

Datadog Ansible 컬렉션(datadog.dd)은 Ansible 관련 Datadog 콘텐츠의 공식 컬렉션이에요. 이 컬렉션에는 datadog.dd.agent로 접근할 수 있는 Ansible Datadog 역할이 포함되어 있어서 Datadog 에이전트와 통합을 설치하고 구성할 수 있어요.

사전 요구사항

  • Ansible v2.10 이상.

  • 대부분의 Debian, RHEL 기반 및 SUSE 기반 Linux 배포판, macOS, Windows를 지원해요.

  • Windows 호스트를 관리하려면 ansible.windows 컬렉션을 설치하세요.

    ansible-galaxy collection install ansible.windows

  • openSUSE/SLES 호스트를 관리할 때는 community.general 컬렉션을 설치하세요.

    ansible-galaxy collection install community.general

셋업

Ansible 컬렉션 설치

이 컬렉션을 사용하기 전에 Ansible Galaxy 명령줄 도구로 설치하세요.

ansible-galaxy collection install datadog.dd

또는 requirements.yml 파일에 포함하고 ansible-galaxy collection install -r requirements.yml 명령으로 설치할 수 있어요. requirements.yml에 다음을 포함하세요.

collections:
  - name: datadog.dd

참고: Ansible Galaxy에서 컬렉션을 설치하면 Ansible 패키지를 업그레이드해도 컬렉션이 자동으로 업그레이드되지 않아요. 컬렉션을 최신 버전으로 업그레이드하려면 다음 명령을 실행하세요.

ansible-galaxy collection install datadog.dd --upgrade

컬렉션의 특정 버전을 설치할 수도 있어요. 예를 들어, 최신 버전에 문제가 있어 다운그레이드가 필요할 때 그렇죠(이 경우 이 저장소에 이슈를 보고해 주세요). 다음 구문은 버전 5.0.0을 설치하는 방법을 보여 줘요.

ansible-galaxy collection install datadog.dd:==5.0.0

자세한 내용은 Ansible 컬렉션 사용하기를 참고하세요.

Datadog Ansible 컬렉션은 Red Hat이 공식 인증한 Red Hat Automation Hub에서도 사용할 수 있어요.

에이전트 설치

플랫폼(Linux, Windows 또는 macOS)에 맞는 Datadog Ansible 컬렉션을 설치하고 미리 채워진 플레이북 스니펫을 복사하려면 Fleet Automation의 인앱 안내를 따라 하세요. 참고: Ansible v2.10 이상을 실행해야 해요.

에이전트 배포

호스트에 Datadog 에이전트를 배포하려면 플레이북에 Datadog 역할과 API 키를 추가하세요.

- 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>"

참고: Ansible Automation Hub를 통해 컬렉션을 설치하면 OpenSUSE/SLES 기능이 커뮤니티 컬렉션 community.general에 의존해요. Red Hat 지원은 커뮤니티 콘텐츠 관련 문제에 대해 지원을 제공하지 않아요. OpenSUSE/SLES 관련 지원 요청은 전부 Datadog 지원으로 보내 주세요.

테스트

Datadog 컬렉션은 CentOS, Debian, Rocky Linux, OpenSUSE, Windows, macOS에서 테스트돼요. 테스트는 최신 ansible-lint 버전으로 실행되고 Python 3.9부터 Python 3.12까지의 샌드니티 체크가 실행돼요.

지원

지원이 필요하면 ansible-collections GitHub 저장소에 이슈를 만들거나 Datadog 지원에 문의하세요.

릴리스 노트

변경 사항은 CHANGELOG 파일에서 확인할 수 있어요.

라이선스 정보

Datadog Ansible 컬렉션은 Apache License 2.0으로 게시돼요.

더 알아보기 (Learn more)