권장 디렉터리 배치
플레이북, 인벤토리, 변수가 저장되는 위치를 알아봅니다.
권장 디렉터리 배치은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
레이아웃이 중요한 이유
프로젝트가 커지면 흩어진 파일이 빠르게 혼란을 일으킵니다. 표준 디렉터리 구조가 있으면 팀에서 모든 항목의 위치를 정확히 알 수 있습니다. 📁
site.yml 진입점
관례상 site.yml은 전체 인프라를 연결하고 나머지 항목을 포함하는 최상위 플레이북입니다.
# site.yml
- import_playbook: webservers.yml
- import_playbook: dbservers.yml루트에 두는 인벤토리
인벤토리 파일 또는 디렉터리는 상위 위치에 두므로, 옆에 있는 플레이북이 자신이 관리하는 호스트를 항상 알 수 있습니다.
myproject/
inventory
site.yml기능별 플레이북
큰 플레이를 webservers.yml 및 dbservers.yml처럼 목적에 집중된 파일로 나눈 다음 site.yml에서 하나로 연결하세요.
group_vars 디렉터리
group_vars 디렉터리에는 전체 호스트 그룹에 적용되는 변수가 들어 있으며, 그룹 이름에 따라 자동으로 로드됩니다.
group_vars/
webservers.yml
dbservers.ymlhost_vars 디렉터리
host_vars 디렉터리는 개별 컴퓨터에 대해 같은 역할을 합니다. 각 호스트의 이름을 딴 파일을 하나씩 둡니다.
host_vars/
web01.example.com.ymlroles 디렉터리
재사용 가능한 자동화는 roles 디렉터리 아래에 둡니다. 플레이에서 이름으로 역할을 참조하면 Ansible이 먼저 이 위치를 확인합니다.
roles/
common/
nginx/사용자 지정 library와 플러그인
library 폴더에는 사용자 지정 모듈을 두고, module_utils 또는 filter_plugins에는 Ansible이 자동으로 찾는 공유 도우미 코드를 둡니다.
ansible.cfg를 가까이에 두세요
프로젝트 루트에 ansible.cfg를 배치하세요. Ansible은 현재 디렉터리의 설정을 사용하므로 설정이 프로젝트에 한정됩니다.
# ansible.cfg
[defaults]
inventory = ./inventory
roles_path = ./roles하나의 저장소에 전체 구성이 담깁니다
이 구조를 사용하면 git clone 한 번으로 팀원이 플레이북, 인벤토리, 변수, 역할을 모두 일관된 하나의 구조로 받을 수 있습니다. 🎯
전체 기본 구조
공식 문서에서 권장하는 기본 구조는 다음과 같습니다. 모든 파일을 외우기보다 구조를 익히세요.
myproject/
ansible.cfg
inventory
site.yml
group_vars/
host_vars/
roles/빠른 확인
전체 프로젝트에서 관례적으로 최상위 진입점이 되는 파일은 무엇인가요?
복습
표준 구조를 배웠습니다. 하나의 저장소에 site.yml과 인벤토리, group_vars, host_vars, roles를 함께 둡니다. 예측 가능한 구조는 팀과 함께 확장됩니다. ✅
자주 묻는 질문
“권장 디렉터리 배치” 강의는 무료인가요?
네 — “권장 디렉터리 배치” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
“권장 디렉터리 배치”에서 뭘 배우나요?
플레이북, 인벤토리, 변수가 저장되는 위치를 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“권장 디렉터리 배치” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.