[Ansible] ansible_facts와 gather_facts 사용해보기

 

ansible_facts란?

ansible_facts는 Ansible이 원격 호스트에서 자동으로 수집하는 OS 관련 정보를 담고 있는 딕셔너리 형태의 데이터이다. 간단히 말하자면 Ansible은 playbook이 실행될 때 기본적으로 gather_facts를 통해 호스트의 여러 정보를 수집하고, 이를 ansible_facts에 딕셔너리로 저장한다.

 

1. Gather Facts 정보 출력 테스트

---
- name: Gather facts 테스트
  hosts: all

  tasks:
    - name: 수집 정보 출력
      debug:
        var: ansible_facts['distribution']
        var: ansible_facts['default_ipv4']['address']

 

처음에는 코드를 이렇게 짰는데 아래와 같은 결과가 출력됐다.

 

debug 모듈에서는 한 번에 두 개 이상의 변수를 var 옵션으로 출력할 수 없다. 두 개 이상의 변수를 출력하고 싶다면 각 변수를 별도의 debug 태스크로 나누어 사용해야 한다.
또한, 기본적으로 gather_facts는 yes로 설정되어 있기 때문에 명시적으로 설정하지 않아도 Ansible이 호스트의 정보를 자동으로 수집한다. 그러나 gather_facts: no로 설정하면, 정보가 수집되지 않아 ansible_facts를 사용할 수 없다.

따라서 각 변수를 별도의 태스크로 나눠 다시 출력해보았다.

---
- name: Gather Facts 테스트
  hosts: all
  tasks:
    - name: Distribution 정보 출력
      debug:
        var: ansible_facts['distribution']

    - name: IPv4 주소 출력
      debug:
        var: ansible_facts['default_ipv4']['address']

 

호스트에서 사용하는 리눅스 배포판 정보와 IP 정보가 출력되었다.

 

 

2. Gather Facts 결과를 JSON 파일로 저장하기

수집된 ansible_facts의 모든 정보를 json파일로 저장하고 뜯어보고 싶어 JSON 파일로 저장하는 법을 찾아보았다.

---
- name: ansible_facts test
  hosts: all
  gather_facts: yes

  tasks:
    - name: 파일 저장 변수
      set_fact:
        file_dest: "/home/ansible/projects/result.json"
        dir_dest: "/home/ansible/projects"

    - name: 디렉토리 생성
      file:
        path: "{{ dir_dest }}"
        state: directory
      delegate_to: localhost

    - name: 결과 저장
      copy:
        content: "{{ ansible_facts | to_json }}"
        dest: "{{ file_dest }}"
      delegate_to: localhost

 

• set_fact
  • set_fact는 Ansible에서 임시 변수를 설정하는 모듈이다. Playbook 내에서 특정 값을 변수로 저장하여 이후의 태스크에서 사용할 수 있다. set_fact로 설정된 변수는 playbook이 실행되는 동안만 참조 가능하다.
  • file_dest는 결과를 저장할 파일의 경로이다.
  • dir_dest는 결과 파일을 저장할 디렉토리의 경로이다.
• file
  • file 모듈은 파일 또는 디렉토리의 속성을 관리하는 데 사용된다.
  • path를 통해 관리할 파일이나 디렉토리의 경로를 확인할 수 있다.
  • state는 경로의 상태를 지정한다. 위와 같이 state를 directory로 설정하는 경우, 지정된 경로가 디렉토리로 생성된다.
• delegate_to
  • 특정 작업을 다른 host에서 실행할 수 있도록 하는 Ansible 기능
  • 보통 playbook은 hosts에 정의된 호스트에서 실행되지만, 특정 작업만 로컬에서 실행하거나 다른 호스트에서 실행할 때 사용된다.
  • 해당 코드는 파일을 로컬 서버에 저장해야 되므로 localhost로 설정했다.
• copy
  • copy 모듈은 원본 파일의 내용을 다른 위치에 복사하거나, 텍스트 내용을 지정된 파일에 저장할 때 사용된다.
  • content는 파일에 복사할 내용 혹은 파일 내용을 정의할 때 사용된다.
  • dest는 목적지 파일의 경로를 나타낸다.

 

결과가 정상적으로 출력되었고, 만들어진 json파일을 확인해보면 

 

잘 출력된 것을 확인할 수 있다.
그러나 사람이 읽기 쉬운 json파일로 변환하고 싶어 to_nice_json을 사용해서 다시 돌려봤다.

 

gather_facts를 통해 얻을 수 있는 모든 정보가 잘 담겨있는 것을 확인할 수 있다.