Basic on Joonlog

Ansible 조건문 / 반복문 / 핸들러 / 오류 처리

Sun, 18 May 2025 09:00:00 +0900

반복문과 조건문

반복문
- 단순 반복문: with_items
- 중첩 반복문: with_nested
- 기타 반복 지시문:
  - with_file
  - with_fileglob
  - with_sequence
  - with_random_choice
반복문에서 사용되는 변수는 List 형식으로 정의

각 항목은 key-value 형식으로 사용 가능
1 2 3 4 5 6

- name: 단순 반복 예시 debug: msg: "{{ item }}" with_items: - value1 - value2
조건문
- when 구문 사용
- 조건식은 Jinja2 문법을 사용하지만, 중괄호({})는 쓰지 않음
1 2 3 4

- name: 조건문 예시 debug: msg: "x86_64 시스템입니다." when: ansible_machine == "x86_64"
- 자주 사용하는 조건 예시:
  - ansible_machine == "x86_64"
  - max_memory == 512
  - min_memory != 512
  - min_memory < 120
  - min_memory is defined
  - min_memory is not defined
  - memory_available
  - not memory_available
  - "ny special user" in superusers

반복문+조건문

1
2
3
4
5


- name: 특정 조건에 맞는 마운트 포인트 처리
 debug:
 msg: "{{ item.mount }} 마운트에 여유 공간 있음"
 with_items: "{{ mount_list }}"
 when: item.mount == "/" and item.size_available > 300000000

핸들러 구현

notify는 해당 task가 changed 상태일 때만 트리거됨
handlers는 모든 task가 끝난 후 실행됨

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


tasks:
 - name: Task1
 file:
 src: httpd.conf.template
 dest: /etc/httpd/conf/httpd.conf
 notify:
 - restart httpd
handlers:
 - name: restart httpd
 service:
 name: httpd
 state: restarted

작업 오류 처리

실패 무시하기

1
2
3


- name: 실패해도 무시Z
 command: /bin/false
 ignore_errors: yes

실패 조건 지정

1
2
3
4


- name: 실패 조건 직접 지정
 shell: some_command
 register: result
 failed_when: "'error' in result.stderr"

Changed 상태 지정

1
2
3


- name: 강제로 Changed 처리
 shell: echo "Force change"
 changed_when: true

핸들러 강제 실행

1
2
3


- name: 전체 플레이북에 핸들러 강제 실행 설정
 hosts: all
 force_handlers: yes

Ansible 블록 및 오류 처리 - block ~ rescue ~ always

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


- name: block-rescue-always 예시
 hosts: all
 tasks:
 - name: 중요한 작업 실행
 block:
 - name: 작업 1
 shell: /bin/false

 - name: 작업 2
 shell: echo "이건 실행 안됨"
 rescue:
 - name: 에러 발생 시 대체 작업
 debug:
 msg: "문제가 발생했지만 복구 작업 실행"
 always:
 - name: 항상 실행되는 작업
 debug:
 msg: "이 작업은 성공/실패 여부와 무관하게 항상 실행됨"

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

Ansible 기본 개념

Wed, 16 Apr 2025 09:00:00 +0900

대량의 서버 인프라 관리를 자동화하는 IaC 도구
컨트롤 노드에서 앤서블 실행 시 스크립트에 작성된 내용에 따라 각 노드에 작업 자동화

Ansible 구조

ansible.cfg + inventory + playbook

ansible.cfg

ansible 기본 설정 파일

inventory 경로 지정
remote_user: 각 서버에 ssh 접근 시 어떤 계정으로 접근할 지 지정
- inventory에 각 서버마다 접근할 계정 지정할 수도 있지만 단일 계정으로 접근 권장
become = true: 리모트 노드에서 Ansible 동작 시 sudo 권한으로 동작하도록 설정
- become 설정은 ansible.cfg에서 명시하지 않아도 각 playbook마다 개별 설정 가능
host_key_checking = False: 처음 SSH 접속하는 서버는 fingerprint를 남겨야 하지만 이 옵션으로 무시하고 접속
remote_tmp = /tmp/.ansible-{USER}: Ansible은 명령어 실행 시 임시 파일을 접속 디렉토리에 작성하는데, 접속 서버에서 계정이 디렉토리에 대한 쓰기 권한이 없을때 경로를 임시 파일 작성 경로를 /tmp로 우회

1
2
3
4
5
6
7
8


[defaults]
inventory = /home/ncloud24/ansible/inventory
remote_user = <서버 계정>
host_key_checking = False
remote_tmp = /tmp/.ansible-{USER}

[privilege_escalation]
become = true

inventory

ansible 동작 시 대상 호스트 및 변수를 정의하는 파일

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


[prod]
prod1 ansible_host=192.168.0.1 ansible_user=user2
prod2 ansible_host=192.168.0.2 ansible_user=user3
prod3 ansible_host=192.168.0.3

[dev]
dev1 ansible_host=192.168.1.1
dev2 ansible_host=192.168.1.2
dev3 ansible_host=192.168.1.3
dev4 ansible_host=192.168.1.4
dev5 ansible_host=192.168.1.5

[all:vars]
ansible_ssh_private_key_file=/home/rocky/key.pem

이 설정에서는 각 리모트 노드들의 alias와 ip를 지정해서 동작
- ansible_host는 ansible 내부적으로 ip로 인식하는 예약 변수
- inventory에서 ansible_host을 명시하지 않는다면 /etc/hosts에서 도메인, IP 작성 ⇒ inventory에 도메인 명시하면 동일하게 동작 가능
- ansible_user 변수로 서버별 접속 계정을 다르게 설정 가능
각 그룹마다 변수를 다르게 설정 가능
- all:vars를 사용해서 전체 호스트에 대한 변수 설정
- ansible_ssh_private_key_file 변수로 키 파일 위치 지정 가능

playbook

어떤 서버, 어떤 명령어를 실행할지 정의하는 yaml 파일

모든 서버의 /home/ansible 경로에 0755의 권한을 가진 pkg 디렉토리 생성 yaml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


---
- name: Playbook 테스트
 hosts: all:!prod1

 tasks:
 - name: 디렉토리 생성
 file:
 path: /home/ansible/pkg
 state: directory
 mode: '0755'

host에 inventory에 정의한 alias, group 등등으로 대상 리모트 노드 지정
- 예시
  - prod ⇒ prod1, prod2, prod3 총 3개 서버 대상
  - prod1 ⇒ 개별 서버 지정 가능
  - all ⇒ inventory에 기록된 모든 서버 대상
  - all:!prod1 ⇒ prod1 서버를 제외한 모든 서버 대상
task에 어떤 모듈을 어떻게 동작시킬지 정의
- task에 여러 모듈 실행 가능
- 한 yaml에서 여러 task도 실행 가능
- 이 설정에서는 file 모듈 실행