Files
exemone_agent_installer/README.md
2025-04-04 13:54:47 +09:00

3.6 KiB

exemONE Agent Installer

[현재 적용된 에이전트 버전]
Static Badge
Static Badge

현재 공개된 exemONE의 host-agent , manager-agent 인스톨러 같은 경우
각각의 서버에서 인스톨러를 실행하여 설치를 하게 되어 있어, 소수의 서버일 경우에는 문제가 없지만
설치를 해야하는 서버의 대수가 많을 경우 번거로우며, 각 서버에 파일 반입, 실헹을 해야하는 등 시간 낭비가 발생함
이를 해결하기 위해 ansible을 통해 설치 과정을 자동으로 수행하도록 제작하였음.

주의 사항

리모트 서버(에이전트 배포 대상)의 기본 파이썬 버전이 3.5 이하 인 경우 정상 동작 하지 않을 수 있음 (RHEL 7 계열 이상은 동작 확인)
(현재 사용중인 Ansible 모듈이 최소 파이썬 3.7 요구 / 리모트 서버가 RHEL 8 이상일 경우 정상 동작)
내부적으로 사용하는 python과 ansible의 버전을 낮추어서 호환성을 높였으며, 내부 테스트 결과 centos 6.5 / rhel 7,8,9 계열에서 동작 확인

사용 방법

본 인스톨러를 사용하는 방법은 아래와 같음

inventory 작성 (inventory 파일)

byeonjunghun@JHMacMini exemone % vi inventory

[all:children]ㅈ
host_agent
manager_agent

[host_agent]
10.10.54.150 # host-agent를 설치할 서버 IP 입력
10.10.52.50 ansible_user=root ansible_ssh_pass=exem@23 ansible_become_pass=exem@23
10.10.52.51 ansible_user=root ansible_ssh_pass=exem@23 ansible_become_pass=exem@23
10.10.52.52 ansible_user=root ansible_ssh_pass=exem@23 ansible_become_pass=exem@23
# ansible_user : ssh 접속 유저
# ansible_ssh_pass : ssh 접속 패스워드
# ansible_become_pass : sudo 권한 사용시 패스워드

[manager_agent]
10.10.52.50 ansible_user=root ansible_ssh_pass=exem@23 ansible_become_pass=exem@23
10.10.52.51 ansible_user=root ansible_ssh_pass=exem@23 ansible_become_pass=exem@23
10.10.52.52 ansible_user=root ansible_ssh_pass=exem@23 ansible_become_pass=exem@23

host-agent와 manager-agent 둘 모두를 설치하고 싶을 경우 예시 서버 처럼 두군대 모두 입력

playbook 작성 (agent.yml 파일)

byeonjunghun@JHMacMini exemone % vi agent.yml

---
- hosts: all
  become: true
  gather_facts: true
  roles:
    - role: one_agent
  vars:
    EXEM_HOME: /tmp
    RECEIVER_ADDR: 10.10.52.56
    #RECEIVER_PORT: 9009
    #MANAGER_RECEIVER_PORT: 9010
    # port 설정이 필요할 경우 위 주석을 해제하고 설정
    # RECEIVER_PORT 와 MANGER_RECEIVER_PORT 같은 경우 변수를 설정하지 않을 경우 default 값으로 각각 9009 , 9010 으로 설정 됨
    host_agent_version: 3.0.21
    agent_list: ['host-agent', 'manager-agent']

agent_list 부분에 설치하고자 하는 agent 목록 작성
host-agent 와 manager-agent 지원

ssh key copy

ssh-keygen -t rsa # ansible을 실행하는 서버에 ssh key가 없을 경우 생성
ssh-copy-id user@ip # agent를 설치하고자 하는 서버에 key 등록 (ansible을 실행하는 서버도 등록)
# user 같은 경우 root 권한을 가지고 있어야 함
# inventory에 user와 pass를 입력하였을 경우 key 등록 불필요 생략 가능

playbook 실행

ansible-playbook -i inventory agent.yml 명령어로 실행

Docker를 통한 실행

docker run --rm --name installer -v ./inventory:/installer/inventory -v ./agent.yml:/installer/agent.yml {빌드한 이미지} 로 실행