datasaker-agent-ansible/README_ko.md

Ansible Datasaker Role

Ansible을 이용하여 Datasaker Agent를 설치할 수 있습니다.

Requirements

• Ansible v2.6+가 필요합니다.
• 대부분의 Debian Linux 배포판을 지원합니다.
• 대부분의 Redhat Linux 배포판을 지원합니다.
• Amazon Linux 2 배포판을 지원합니다.

Installation

Ansible Galaxy에서 Datasaker role을 설치합니다.

ansible-galaxy install dsk_bot.datasaker

에이전트를 배포하기 위하여 Ansible playbook을 작성합니다.

*dsk-log-agent 설치 시 fluent-bit 이 자동으로 설치됩니다.

아래는 기본 설치에 대한 예시입니다.

Host Agent Default Install Example

- hosts: servers
  become: true
  roles:
    - role: dsk_bot.datasaker
  vars:
    datasaker_api_key: "<YOUR_API_KEY>"
    datasaker_agents: ["dsk-node-agent","dsk-log-agent"] 

Docker Agent Default Install Example

- hosts: servers
  become: true
  roles:
    - role: dsk_bot.datasaker
  vars:
    datasaker_api_key: "<YOUR_API_KEY>"
    datasaker_docker_agents: ["dsk-docker-node-agent","dsk-docker-log-agent"]

필수 설정

변수명	설명	Default
datasaker_api_key	API Key를 입력합니다.
datasaker_agents	각 호스트에 설치하고자 하는 Host Agent 리스트입니다. dsk-node-agent dsk-trace-agent dsk-log-agent dsk-postgres-agent dsk-plan-postgres-agent	dsk-node-agent
datasaker_docker_agents	각 호스트에 설치하고자 하는 Docker Container Agent 리스트입니다. Docker Container Agents를 넣으면 Host Agent 설치는 자동으로 비활성화 됩니다. dsk-docker-node-agent dsk-docker-trace-agent dsk-docker-log-agent dsk-docker-postgres-agent	dsk-docker-node-agent

Docker Container Agent 설정

변수명	설명	Default
datasaker_docker_config_path	Datasaker Global Config 위치 설정.	~/.datasaker
datasaker_docker_global_config	Datasaker Global Config 이름 설정.	~/.datasaker/config.yml
docker_default_path	Datasaker Docker Log Agent에 마운트할 Docker Log 수집 위치 설정.	/var/lib/docker/containers/
datasaker_docker_path	Datasaker Docker Agent Container 위치 설정.	/var/datasaker
container_agent_restart_policy	dsk-container-agent Container Restart Policy 설정.	always
node_agent_restart_policy	dsk-node-agent Container Restart Policy 설정.	always
trace_agent_restart_policy	dsk-trace-agent Container Restart Policy 설정.	always
log_agent_restart_policy	dsk-log-agent Container Restart Policy 설정.	always
postgres_agent_restart_policy	dsk-postgres-agent Container Restart Policy 설정.	always
container_agent_log_level	dsk-container-agent Log Level 설정.	INFO
node_agent_log_level	dsk-node-agent Log Level 설정.	INFO
trace_agent_log_level	dsk-trace-agent Log Level 설정.	INFO
log_agent_log_level	dsk-log-agent Log Level 설정.	INFO
postgres_agent_log_level	dsk-postgres-agent Log Level 설정.	INFO