역할 디렉터리 구조
tasks, handlers, templates, defaults, vars를 살펴봅니다.
역할 디렉터리 구조은(는) CoddyKit의 무료 Ansible Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Ansible Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Ansible Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
역할은 폴더 트리입니다
역할은 정해진 하위 폴더들로 이루어진 디렉터리일 뿐입니다. Ansible은 각 폴더를 이름으로 식별하고 그 내용을 자동으로 불러옵니다.
roles/
nginx/
tasks/
handlers/
templates/tasks/main.yml은 진입점입니다
tasks/main.yml 파일에는 역할의 주요 작업 목록이 들어 있습니다. 역할이 적용될 때 Ansible이 가장 먼저 실행하는 파일입니다.
tasks/main.yml:
- name: Install nginx
ansible.builtin.package:
name: nginxhandlers/에는 재시작 로직이 들어갑니다
handlers 폴더에는 서비스 재시작과 같은 동작을 정의합니다. 작업에서 이러한 핸들러에 알림을 보내므로 변경이 발생한 경우에만 재시작됩니다.
Jinja2 파일용 templates/
.j2 템플릿 파일은 templates/에 넣습니다. 템플릿 모듈은 전체 경로 없이도 이름으로 이 폴더에서 파일을 찾습니다.
templates/
nginx.conf.j2정적 파일용 files/
files 폴더에는 있는 그대로 복사할 일반 파일을 저장합니다. 복사 모듈은 templates와 마찬가지로 파일을 자동으로 찾습니다.
defaults/는 우선순위가 낮은 변수를 설정합니다
defaults/main.yml 파일에는 우선순위가 가장 낮은 변수가 들어 있으므로 사용자가 역할 외부에서 쉽게 덮어쓸 수 있습니다.
defaults/main.yml:
nginx_port: 80vars/는 우선순위가 높은 변수를 설정합니다
vars/main.yml 파일에는 우선순위가 더 높은 변수가 들어 있습니다. 역할이 의존하며 거의 변경되지 않아야 하는 값에 사용합니다.
meta/main.yml은 역할을 설명합니다
meta/main.yml 파일에는 역할의 작성자, 라이선스, 지원 플랫폼 및 역할 종속성이 나열됩니다.
main.yml은 특별한 이름입니다
tasks, handlers, vars, defaults 내부에서 Ansible은 main.yml이라는 이름의 파일을 자동으로 불러옵니다. 이러한 명명 규칙이 모든 요소를 연결합니다.
사용하는 것만 있으면 됩니다
역할에 모든 폴더가 필요한 것은 아닙니다. 템플릿이 없다면 templates 디렉터리를 생략하면 됩니다. Ansible은 없는 선택적 폴더를 무시합니다.
완성도를 높이는 tests/와 README
완성도 높은 역할에는 다른 사람들이 사용하기 전에 자동화를 이해하고 검증할 수 있도록 README와 tests 폴더가 포함됩니다.
빠른 확인
역할의 주요 작업 목록이 어디에 있는지 떠올려 보세요.
복습
역할은 폴더 트리이며, tasks, handlers, templates, files, defaults, vars, meta가 각각 정해진 위치를 갖습니다. 모든 위치는 main.yml을 기준으로 합니다. 📁
자주 묻는 질문
“역할 디렉터리 구조” 강의는 무료인가요?
네 — “역할 디렉터리 구조” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Ansible Academy 강의 전체를 잠금 해제할 수 있습니다. Ansible Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“역할 디렉터리 구조”에서 뭘 배우나요?
tasks, handlers, templates, defaults, vars를 살펴봅니다. 브라우저에서 직접 실행하는 실습 코드로 Ansible Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Ansible Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Ansible Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“역할 디렉터리 구조” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Ansible Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Ansible Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.