6.2. 컬렉션 생성
Ansible Galaxy CLI 툴을 사용하여 고유한 컬렉션을 로컬로 생성할 수 있습니다. collection 하위 명령을 사용하여 컬렉션별 명령을 활성화할 수 있습니다.
사전 요구 사항
- 개발 환경에 Ansible-core 버전 2.15 이상이 설치되어 있어야 합니다.
절차
- 터미널에서 네임스페이스 루트 디렉터리를 원하는 위치로 이동합니다. 단순화를 위해 COLLECTIONS_PATH 의 경로 여야 하지만 필수는 아닙니다.
my_namespace및my_collection_name을 고유한 값으로 교체하여 다음 명령을 실행합니다.$ ansible-galaxy collection init <my_namespace>.<my_collection_name>
참고galaxy.ansible.com 또는 console.redhat.com/ansible/automation-hub의 My Content 탭에서 네임스페이스에 업로드할 수 있는 적절한 권한이 있는지 확인합니다.
이전 명령은 네임스페이스 인수에서 라는 디렉터리를 만들고(아직 없는 경우) 컬렉션 이름으로 디렉터리를 생성합니다. 해당 디렉터리의 내부는 default 또는 "skeleton" Collection이 됩니다. 여기에서 역할 또는 플러그인을 추가하고 자체 컬렉션 개발을 시작할 수 있습니다.
컬렉션 개발자는 실행 환경과 관련하여 Ansible Builder에서 적절한 메타데이터를 제공하여 콘텐츠에 대한 요구 사항을 선언할 수 있습니다.
컬렉션의 요구 사항은 다음과 같은 방법으로 인식할 수 있습니다.
-
Python 또는
bindep요구 사항 파일을 참조하는 filemeta/execution-environment.yml. -
requirements.txt라는 파일은 Python 종속 항목에 대한 정보를 포함하며 경우에 따라 컬렉션의 루트 수준에서 찾을 수 있습니다. -
시스템 수준 종속성을 포함하는
bindep.txt라는 파일은 종종 컬렉션의 루트 수준에서 찾을 수 있습니다. -
이러한 파일 중 컬렉션
build_ignore에 있는 경우 Ansible Builder는 이러한 파일을 선택하지 않습니다.build_ignore섹션은 빌드 아티팩트에 포함되지 않아야 하는 모든 파일 또는 디렉터리를 필터링합니다.
컬렉션 유지 관리자는 introspect 명령을 사용하여 ansible-builder에서 예상 요구 사항을 인식하는지 확인할 수 있습니다.
$ ansible-builder introspect --sanitize ~/.ansible/collections/
추가 리소스
- 컬렉션 생성에 대한 자세한 내용은 Ansible 개발자 가이드에서 컬렉션 생성 을 참조하십시오.
