Ansible 은 인프라 관리 및 배포를 단순화하는 널리 사용되는 IT 자동화 도구입니다. 이 랩에서는 Ansible 을 사용하여 긴 형식으로 파일과 디렉토리를 나열하는 방법을 살펴봅니다. Ansible 을 설정하고, 플레이북 (playbook) 을 생성하며, 내장 모듈을 사용하여 원격 시스템에서 파일 정보를 나열하는 방법을 배우게 됩니다. 이 랩을 마치면 자동화 워크플로우를 향상시킬 수 있는 Ansible 명령어와 기술에 대한 실질적인 경험을 얻게 될 것입니다.
이 단계에서는 시스템에 Ansible 을 설치하고 로컬 환경을 관리하기 위한 기본 인벤토리 파일을 생성합니다.
먼저, 패키지 관리자를 사용하여 Ansible 을 설치해 보겠습니다.
sudo apt update
sudo apt install -y ansible설치가 완료된 후, Ansible 버전을 확인하여 Ansible 이 올바르게 설치되었는지 확인합니다.
ansible --version다음과 유사한 출력을 볼 수 있습니다.
ansible [core 2.12.0]
config file = /etc/ansible/ansible.cfg
configured module search path = ['/home/labex/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
ansible python module location = /usr/lib/python3/dist-packages/ansible
ansible collection location = /home/labex/.ansible/collections:/usr/share/ansible/collections
executable location = /usr/bin/ansible
python version = 3.10.x (default, Ubuntu 22.04)
jinja version = 3.0.3
libyaml = True인벤토리 파일은 Ansible 이 작업할 수 있는 관리 노드 목록입니다. 이 랩에서는 로컬 머신을 포함하는 간단한 인벤토리 파일을 생성합니다.
Ansible 프로젝트용 디렉토리를 생성합니다.
mkdir -p ~/project/ansible-lab
cd ~/project/ansible-lab이제 VS Code 편집기를 사용하여 인벤토리 파일을 생성합니다.
~/project/ansible-lab 디렉토리로 이동합니다.inventory.ini로 지정합니다.[local]
localhost ansible_connection=local이 인벤토리 파일은 로컬호스트만 포함하는 local이라는 그룹을 정의하고, Ansible 이 SSH 를 사용하는 대신 로컬로 연결하도록 지정합니다.
기본 설정을 지정하기 위해 기본 Ansible 구성 파일을 생성해 보겠습니다.
ansible-lab 디렉토리를 마우스 오른쪽 버튼으로 클릭하고 "New File"을 선택합니다.ansible.cfg로 지정합니다.[defaults]
inventory = inventory.ini
host_key_checking = False이 구성 파일은 Ansible 에게 기본적으로 inventory.ini 파일을 사용하도록 지시하고, 랩 환경에 유용한 SSH 호스트 키 확인을 비활성화합니다.
간단한 명령을 실행하여 Ansible 설정을 테스트해 보겠습니다.
cd ~/project/ansible-lab
ansible local -m ping다음과 유사한 출력을 볼 수 있습니다.
localhost | SUCCESS => {
"changed": false,
"ping": "pong"
}이는 Ansible 이 올바르게 구성되었고 로컬 머신과 통신할 수 있음을 확인합니다.
이 단계에서는 파일 및 디렉토리를 나열하는 기본 Ansible 플레이북을 생성합니다. 플레이북은 관리 노드에서 실행할 작업 집합을 정의하는 YAML 파일입니다.
플레이북을 생성하기 전에 플레이북이 무엇인지 이해해 보겠습니다.
/etc 디렉토리의 내용을 나열하는 간단한 플레이북을 생성해 보겠습니다.
~/project/ansible-lab 디렉토리로 이동합니다.list_files.yml로 지정합니다.---
- name: List files and directories
hosts: local
tasks:
- name: Get directory listing
command: ls -l /etc
register: directory_contents
- name: Display directory contents
debug:
var: directory_contents.stdout_lines이 플레이북이 수행하는 작업을 이해해 보겠습니다.
---) 은 YAML 문서의 시작을 나타냅니다.name: List files and directories는 플레이에 대한 설명적인 이름입니다.hosts: local은 이 플레이가 local 그룹 (인벤토리에서 정의됨) 의 호스트에서 실행됨을 지정합니다.tasks:는 실행할 작업 목록을 시작합니다.ls -l /etc 명령을 실행하고 결과를 directory_contents라는 변수에 저장합니다.directory_contents.stdout_lines 변수의 내용을 표시합니다.이제 플레이북을 실행해 보겠습니다.
cd ~/project/ansible-lab
ansible-playbook list_files.yml다음과 유사한 출력을 볼 수 있습니다.
PLAY [List files and directories] *****************************************************
TASK [Gathering Facts] ****************************************************************
ok: [localhost]
TASK [Get directory listing] **********************************************************
changed: [localhost]
TASK [Display directory contents] *****************************************************
ok: [localhost] => {
"directory_contents.stdout_lines": [
"total 1088",
"drwxr-xr-x 2 root root 4096 Apr 15 12:34 acpi",
"drwxr-xr-x 3 root root 4096 Apr 15 12:34 alternatives",
"-rw-r--r-- 1 root root 3028 Aug 1 2017 bash.bashrc",
"drwxr-xr-x 2 root root 4096 Apr 15 12:34 bash_completion.d",
"... [more files and directories] ..."
]
}
PLAY RECAP ***************************************************************************
localhost : ok=3 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0출력은 권한, 소유자, 그룹, 크기 및 수정 날짜를 포함하는 긴 형식으로 /etc 디렉토리의 내용을 보여줍니다.
이제 /home/labex 디렉토리의 내용을 나열하도록 플레이북을 수정해 보겠습니다.
list_files.yml 파일을 엽니다./etc에서 /home/labex로 변경합니다.---
- name: List files and directories
hosts: local
tasks:
- name: Get directory listing
command: ls -l /home/labex
register: directory_contents
- name: Display directory contents
debug:
var: directory_contents.stdout_lines플레이북을 다시 실행합니다.
ansible-playbook list_files.yml이제 출력은 /etc 대신 /home/labex 디렉토리의 내용을 표시합니다.
이전 단계에서는 ls -l 명령을 실행하기 위해 command 모듈을 사용했습니다. 이 방법도 작동하지만, Ansible 은 파일 및 디렉토리 작업을 위한 더 전용적인 모듈인 ansible.builtin.file 모듈을 제공합니다. 이 단계에서는 이 모듈과 ansible.builtin.find 모듈을 함께 사용하여 더 Ansible-native 방식으로 파일을 나열하는 방법을 배우겠습니다.
ansible.builtin.find 모듈은 특정 기준과 일치하는 파일을 찾도록 설계되었습니다. command 모듈에 비해 파일을 나열하는 더 강력하고 유연한 방법을 제공합니다.
find 모듈을 사용하는 새 플레이북을 생성해 보겠습니다.
~/project/ansible-lab 디렉토리로 이동합니다.find_files.yml로 지정합니다.---
- name: Find files with Ansible
hosts: local
tasks:
- name: Find all files in /etc
ansible.builtin.find:
paths: /etc
file_type: any
register: found_files
- name: Display the first 10 files
debug:
var: found_files.files[:10]이 플레이북은 find 모듈을 사용하여 /etc 디렉토리의 모든 파일과 디렉토리를 찾은 다음 처음 10 개 항목을 표시합니다.
플레이북을 실행해 보겠습니다.
cd ~/project/ansible-lab
ansible-playbook find_files.yml다음과 같은 각 파일에 대한 자세한 정보가 포함된 출력을 볼 수 있습니다.
이제 모든 세부 정보와 함께 장형식으로 파일을 표시하는 더 포괄적인 플레이북을 생성해 보겠습니다.
long_format.yml로 지정합니다.---
- name: List files in long format
hosts: local
tasks:
- name: Find files in /etc
ansible.builtin.find:
paths: /etc
file_type: any
recurse: no
register: found_files
- name: Create a formatted list of files
set_fact:
formatted_files: "{{ formatted_files | default([]) + [item] }}"
loop: "{{ found_files.files }}"
loop_control:
label: "{{ item.path }}"
vars:
item_info: >-
{{ item.mode }} {{ item.uid | string | ljust(5) }}
{{ item.gid | string | ljust(5) }} {{ item.size | string | ljust(10) }}
{{ item.mtime | string | ljust(11) }} {{ item.path }}
- name: Display files in long format
debug:
msg: "{{ formatted_files[:10] }}"이 플레이북은 다음을 수행합니다.
find 모듈을 사용하여 /etc 디렉토리에서 파일을 찾습니다.ls -l 명령의 출력과 유사한 형식화된 목록을 생성합니다.플레이북을 실행해 보겠습니다.
ansible-playbook long_format.yml출력은 ls -l 명령과 유사한 형식으로 파일 세부 정보를 표시합니다.
Ansible 모듈을 사용하는 한 가지 장점은 다양한 기준에 따라 파일을 필터링할 수 있다는 것입니다. .conf로 끝나는 구성 파일만 나열하는 플레이북을 생성해 보겠습니다.
filter_files.yml로 지정합니다.---
- name: List filtered files in long format
hosts: local
tasks:
- name: Find configuration files in /etc
ansible.builtin.find:
paths: /etc
patterns: "*.conf"
file_type: file
register: conf_files
- name: Display configuration files
debug:
msg: "{{ item.mode }} {{ item.uid }} {{ item.gid }} {{ item.size }} {{ item.mtime }} {{ item.path }}"
loop: "{{ conf_files.files }}"
loop_control:
label: "{{ item.path }}"이 플레이북은 다음을 수행합니다.
find 모듈을 사용하여 .conf로 끝나는 /etc 디렉토리의 파일을 찾습니다.플레이북을 실행해 보겠습니다.
ansible-playbook filter_files.yml출력은 /etc 디렉토리의 .conf 파일에 대한 세부 정보만 표시합니다.
find 모듈의 출력과 기존 ls -l 명령을 비교하기 위해 플레이북을 하나 더 생성해 보겠습니다.
compare_methods.yml로 지정합니다.---
- name: Compare listing methods
hosts: local
tasks:
- name: Get directory listing with ls command
command: ls -l /etc/passwd
register: ls_output
- name: Get file info with find module
ansible.builtin.find:
paths: /etc
patterns: "passwd"
file_type: file
register: find_output
- name: Display ls command output
debug:
var: ls_output.stdout_lines
- name: Display find module output
debug:
var: find_output.files[0]이 플레이북은 다음을 수행합니다.
command 모듈을 사용하여 /etc/passwd 파일에 대해 ls -l을 실행합니다.find 모듈을 사용하여 동일한 파일을 찾습니다.플레이북을 실행해 보겠습니다.
ansible-playbook compare_methods.yml이제 두 가지 방법의 차이점을 확인할 수 있습니다.
ls -l 명령은 기존 Unix 형식으로 한 줄의 텍스트를 제공합니다.find 모듈은 Ansible 에서 조작할 수 있는 구조화된 데이터 객체를 제공합니다.이 단계에서는 파일 목록을 위한 Ansible 롤을 생성하는 방법을 배우겠습니다. 롤은 플레이북을 구성하고 더 재사용 가능하게 만드는 방법입니다. 이는 여러 플레이북 또는 프로젝트에서 동일한 작업을 수행해야 할 때 특히 유용합니다.
Ansible 롤은 표준 디렉토리 구조로 함께 그룹화된 작업, 변수, 파일, 템플릿 및 기타 리소스 집합입니다. 롤을 사용하면 코드를 쉽게 재사용하고 다른 사람과 공유할 수 있습니다.
롤의 표준 디렉토리 구조는 다음과 같습니다.
roles/
rolename/
tasks/ ## 롤의 주요 작업
handlers/ ## 작업에 의해 트리거된 핸들러
defaults/ ## 기본 변수
vars/ ## 롤 변수
files/ ## 정적 파일
templates/ ## 템플릿
meta/ ## 롤에 대한 메타데이터장형식으로 파일을 나열하는 롤을 생성해 보겠습니다.
cd ~/project/ansible-lab
mkdir -p roles/file_lister/taskscd ~/project/ansible-lab~/project/ansible-lab/roles/file_lister/tasks로 이동합니다.main.yml로 지정합니다.---
## Tasks for file_lister role
- name: Find files in the specified directory
ansible.builtin.find:
paths: "{{ path | default('/etc') }}"
patterns: "{{ patterns | default('*') }}"
file_type: "{{ file_type | default('any') }}"
recurse: "{{ recurse | default(false) }}"
register: found_files
- name: Display files in long format
debug:
msg: "{{ item.mode }} {{ item.uid }} {{ item.gid }} {{ item.size }} {{ item.mtime }} {{ item.path }}"
loop: "{{ found_files.files | sort(attribute='path') }}"
loop_control:
label: "{{ item.path }}"
when: show_details | default(true)
- name: Display only file paths
debug:
msg: "{{ item.path }}"
loop: "{{ found_files.files | sort(attribute='path') }}"
loop_control:
label: "{{ item.path }}"
when: not (show_details | default(true))이 롤은 다음을 수행합니다.
이제 새 롤을 사용하는 플레이북을 생성해 보겠습니다.
~/project/ansible-lab 디렉토리로 이동합니다.use_role.yml로 지정합니다.---
- name: Use file listing role
hosts: local
roles:
- role: file_lister
vars:
path: "/etc"
patterns: "*.conf"
file_type: "file"
show_details: true이 플레이북은 다음을 수행합니다.
file_lister 롤을 사용합니다.플레이북을 실행해 보겠습니다.
cd ~/project/ansible-lab
ansible-playbook use_role.yml/etc 디렉토리의 모든 .conf 파일의 세부 정보를 보여주는 출력을 볼 수 있습니다.
롤의 장점 중 하나는 변수를 변경하여 동작을 쉽게 사용자 정의할 수 있다는 것입니다. 다른 매개변수를 사용하여 롤을 사용하는 다른 플레이북을 생성해 보겠습니다.
custom_listing.yml로 지정합니다.---
- name: Custom file listing
hosts: local
roles:
- role: file_lister
vars:
path: "/home/labex"
patterns: "*.yml"
file_type: "file"
show_details: false이 플레이북은 다음을 수행합니다.
file_lister 롤을 사용합니다./home/labex 디렉토리를 보도록 설정합니다.플레이북을 실행해 보겠습니다.
ansible-playbook custom_listing.yml/home/labex 디렉토리의 모든 YAML 파일 목록을 세부 정보 없이 볼 수 있습니다.
마지막으로, 롤을 사용하여 파일 보고서를 생성하는 더 고급 플레이북을 생성해 보겠습니다.
generate_report.yml로 지정합니다.---
- name: Generate file listing report
hosts: local
vars:
report_path: "~/project/ansible-lab/file_report.txt"
tasks:
- name: Find files in the specified directory
ansible.builtin.find:
paths: "/etc"
patterns: "*.conf"
file_type: "file"
register: found_files
- name: Create report header
copy:
dest: "{{ report_path }}"
content: |
File Listing Report
Generated on: {{ ansible_date_time.date }} at {{ ansible_date_time.time }}
-----------------------------------------------------------
Mode Owner Group Size Modified Path
-----------------------------------------------------------
force: yes
- name: Append file information to report
lineinfile:
path: "{{ report_path }}"
line: "{{ item.mode }} {{ item.uid }} {{ item.gid }} {{ item.size | string | ljust(10) }} {{ item.mtime }} {{ item.path }}"
loop: "{{ found_files.files | sort(attribute='path') }}"
loop_control:
label: "{{ item.path }}"
- name: Display report location
debug:
msg: "Report generated at {{ report_path }}"이 플레이북은 다음을 수행합니다.
/etc 디렉토리에서 .conf 파일을 찾습니다.플레이북을 실행해 보겠습니다.
ansible-playbook generate_report.yml플레이북을 실행한 후 보고서를 볼 수 있습니다.
cat ~/project/ansible-lab/file_report.txt/etc 디렉토리의 모든 .conf 파일을 나열하는 형식화된 보고서를 볼 수 있습니다.
이 Lab 에서는 Ansible 을 사용하여 장형식으로 파일 및 디렉토리를 나열하는 방법을 배웠습니다. 다음 사항에 대한 실질적인 경험을 얻었습니다.
ls -l 명령을 실행하기 위해 command 모듈을 사용하는 기본 플레이북을 생성합니다.이러한 기술은 인프라 전반에서 파일 관리 작업을 자동화하고 파일 목록을 더 큰 자동화 워크플로우에 통합하는 데 도움이 됩니다. Ansible 을 계속 사용하면서 이러한 개념을 기반으로 파일, 디렉토리 및 해당 권한을 전체 환경에서 관리하는 더 복잡한 자동화를 구축할 수 있습니다.
