Ansible Variables / Secrets / Facts

Tue, 22 Apr 2025 09:00:00 +0900

1. Variable

변수 이름 지정
- 변수 이름은 문자, 숫자 ,밑줄 가능
- 변수 이름은 문자로 시작해야 한다.
변수 적용 볌위
- 변수 적용 범위는 좁은 범위가 넓은 범위보다 우선한다.

플레이북에서 변수 정의

변수 정의

플레이북내에 변수를 지정하는 경우

1
2
3
4
5
6


# $ cat site.yaml
-------------
- hosts: web1
 vars:
 user: user01
 home: /home/user01

별도의 파일로 변수를 설정하고 플레이북에서 지정하는 경우

1
2
3
4
5
6
7
8
9


# $ cat vars/users.yaml
-------------
user: user01
home: /home/user01
---------------
# $ cat site.yaml
- hosts: web1
 var_files:
 - vars/users.yaml

변수 사용
- 변수의 사용은 “{{ variable }}” 형식으로 사용한다.

변수의 종류
- 호스트 변수
- 그룹 변수
[참고] 변수의 우선 순위
- 1. 명령어 라인에서 지정하는 변수(ex: ansible -e ….)
- 1. 플레이북에서 정의하는 변수(play.yaml(vars, var_files))
- 1. 호스트 변수(host_vars/*)
- 1. 그룹 변수(group_vars/*)

배열 변수

1
2
3
4
5
6
7
8
9


# $ cat vars.yaml
----------------
users:
 user01:
 name: lee  # => users.user01.name
 shell: /bin/bash  # => users['user01']['name']
 user02:
 name: kim
 shell: /bin/tsch

register 구문
- register 구문을 사용하여 명령 출력을 캡쳐할 수 있다.
- register 구문은 일반적으로 디버깅 용도로 사용한다
  - ansible-playbook -v …
1 2 3 4 5 6 7

tasks: - yum: name: httpd state: present register: VAR - debug: var: VAR

2. Secret

ansible-vault
- 암호화된 새파일 만들기 $ ansible-vault create secret.yaml
- 암호화된 파일 보기 $ ansible-vault view secret.yaml
- 암호화된 파일 편집하기 $ ansible-vault edit secret.yaml
- 평문 파일 ↔ 암호화 $ ansible-vault encrypt secret.yaml $ ansible-vault decrypt secret.yaml
- 암호화 키 변경하기 $ ansible-vault rekey secret.yaml
ansible-vault와 playbook $ ansible-playbook –help | grep password $ ansible-playbook –ask-vault-password playbook.yaml $ ansible-playbook –vault-password-file-vault-pass playbook.yaml

3. Facts

앤서블 호스트에 대해 자동으로 모아지는 변수 내용

Facts
- ansible_hostname
- andible_fqdn
- ansible_default_ipv4.address
- …
Facts 조회 방법

setup 모듈을 사용한 ansible ad-hoc 명령어로 facts 조회

$ ansible localhost -m setup -a ‘filter=ansible_*’ $ ansible localhost -m setup -a ‘filter=ansible_interface’

⇒ Facts 사용 ”{{ansible_hostname}}”, “{{ansible_default_ipv4.address}}” ”{{ansible_facts[‘hostname’]}}”, “{{ansible_default[‘ipv4.address’]}}”

Facts 끄는 방법

1
2
3
4
5
6


# $ vi playbook.yaml
----------------
- hosts: large_farm
 gather_facts: no
 tasks:
 ...

사용자 정의 Facts
- /etc/ansible/facts.d/*.fact (INI 형식 or JSON 형식)
1 2 3 4 5 6 7 8 9 10

{ "packages": { "web_package": "httpd", "db_packages": "mariadb-server" }, "users": { "user1": "user01", "user2": "user02" } }
- 사용: playbook에서 사용하는 예
ansible localhost -m setup -a ‘filter=ansible_local’
⇒ ansible_local[’local’][’packages’][’web_package’] ⇒ ansible_local.local.packages.web_package
매직변수(Magic Variable)
- hostvars
- group_names
- groups
- inventory_hostname
- 매직변수 조회 방법
  - debug 모듈을 사용한 ad-hoc 명령어로 조회
  $ ansible localhost -m debug -a ‘var=hostvars’ $ ansible localhost -m debug -a ‘var=group_names’ $ ansible localhost -m debug -a ‘var=inventory_hostname’

4. include vars, include tasks 관리

include Overview

작업 포함: include_tasks, import_tasks 변수 포함: include_vars

include_tasks

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# $ cat tasks/main.yaml
------
- name: Task1
 yum:
 ...

# $ cat play.yaml
------
tasks:
- include_tasks: tasks/main.yaml

include_vars

1
2
3
4
5
6
7
8


# $ cat include_vars
------
web_pkg: httpd

# $ cat play.yaml
------
tasks:
- include_vars: vars/vars.yaml

Secrets on Joonlog

Ansible Variables / Secrets / Facts

1. Variable

2. Secret

3. Facts

ansible localhost -m setup -a ‘filter=ansible_local’

4. include vars, include tasks 관리