4장. 플레이북 프로젝트 생성
4.1. 플레이북 프로젝트 요약
다음 단계에서는 Ansible VS Code 확장을 사용하여 새 플레이북 프로젝트를 스캐폴드하는 프로세스를 설명합니다.
사전 요구 사항
- Ansible 개발 툴을 설치했습니다.
- Ansible VS Code 확장을 설치하고 열었습니다.
- 프로젝트를 저장할 디렉터리를 식별했습니다.
프로세스
- VS Code를 엽니다.
- VS Code 활동 표시줄에서 Ansible 아이콘을 클릭하여 Ansible 확장을 엽니다.
Ansible 콘텐츠 작성자 섹션에서 시작하기 를 선택합니다.
Ansible 콘텐츠 작성자 탭이 열립니다.
생성 섹션에서 Ansible 플레이북 프로젝트를 클릭합니다.
Create Ansible project 탭이 열립니다.
Ansible 프로젝트 생성 탭의 양식에 다음을 입력합니다.
대상 디렉터리: 새 플레이북 프로젝트를 스캐폴드할 디렉터리의 경로를 입력합니다.
참고기존 디렉터리 이름을 입력하면 스캐폴드 프로세스가 해당 디렉터리의 콘텐츠를 덮어씁니다. 스캐폴드 프로세스를 사용하면
Force옵션을 활성화하는 경우에만 기존 디렉터리를 사용할 수 있습니다.-
컨테이너화된 버전의 Ansible Dev 툴을 사용하는 경우 대상 디렉터리 경로는 로컬 시스템의 경로가 아닌 컨테이너를 기준으로 합니다. 컨테이너에서 현재 디렉터리 이름을 검색하려면 VS Code의 터미널에서
pwd명령을 실행합니다. 컨테이너의 현재 디렉터리가 작업 공간인 경우workspaces/<destination_directory_name>을 입력합니다 -
로컬로 설치된 Ansible Dev 툴 버전을 사용하는 경우 디렉터리의 전체 경로(예:
/user/<username>/projects/<destination_directory_name>)를 입력합니다.
-
컨테이너화된 버전의 Ansible Dev 툴을 사용하는 경우 대상 디렉터리 경로는 로컬 시스템의 경로가 아닌 컨테이너를 기준으로 합니다. 컨테이너에서 현재 디렉터리 이름을 검색하려면 VS Code의 터미널에서
- SCM 조직 및 SCM 프로젝트: 플레이북에 생성하는 역할을 저장할 수 있는 디렉터리 및 하위 디렉터리의 이름을 입력합니다.
- 새 플레이북 프로젝트를 스캐폴드할 디렉터리의 이름을 입력합니다.
검증
프로젝트 디렉터리가 생성되면 Create Ansible Project 탭의 로그 창에 다음 메시지가 표시됩니다. 이 예에서 대상 디렉터리 이름은 destination_directory_name 입니다.
------------------ ansible-creator logs ------------------
Note: ansible project created at /Users/username/test_project프로젝트 디렉터리에 다음 디렉터리와 파일이 생성됩니다.
$ tree -a -L 5 . ├── .devcontainer │ ├── devcontainer.json │ ├── docker │ │ └── devcontainer.json │ └── podman │ └── devcontainer.json ├── .gitignore ├── README.md ├── ansible-navigator.yml ├── ansible.cfg ├── collections │ ├── ansible_collections │ │ └── scm_organization_name │ │ └── scm_project_name │ └── requirements.yml ├── devfile.yaml ├── inventory │ ├── group_vars │ │ ├── all.yml │ │ └── web_servers.yml │ ├── host_vars │ │ ├── server1.yml │ │ ├── server2.yml │ │ ├── server3.yml │ │ ├── switch1.yml │ │ └── switch2.yml │ └── hosts.yml ├── linux_playbook.yml ├── network_playbook.yml └── site.yml
