6.2. 컬렉션 생성

Ansible Galaxy CLI 툴을 사용하여 고유한 컬렉션을 로컬로 생성할 수 있습니다. collection 하위 명령을 사용하여 모든 컬렉션 관련 명령을 활성화할 수 있습니다.

사전 요구 사항

  • Ansible 버전 2.9 이상이 개발 환경에 설치되어 있습니다.

절차

  1. 터미널에서 네임스페이스 루트 디렉터리가 될 위치로 이동합니다. 단순화를 위해 COLLECTIONS_PATH 의 경로 여야 하지만 필수는 아닙니다.

  2. 다음 명령을 실행하여 my_namespace 및 my_collection_name 을 선택한 값으로 교체합니다. 

    $ ansible-galaxy collection init <my_namespace>.<my_collection_name>
    참고

    galvncy.ansible.com 또는 cloud.redhat.com/ansible/automation-hub의 "My Content" 탭에서 네임스페이스에서 업로드해야 하는 적절한 권한이 있는지 확인합니다.

위의 명령은 위의 네임스페이스 인수에서 이름이 지정된 디렉터리를 생성한 다음(아직 없는 경우) 컬렉션 이름이 있는 디렉터리를 생성합니다. 해당 디렉터리의 내부는 default 또는 "skeleton" Collection이 됩니다. 여기에서 역할 또는 플러그인을 추가하고 자체 컬렉션 개발을 시작할 수 있습니다.

실행 환경과 관련하여 컬렉션 개발자는 Ansible Builder를 통해 적절한 메타데이터를 제공하여 콘텐츠에 대한 요구 사항을 선언할 수 있습니다.

컬렉션의 요구 사항은 다음과 같은 방법으로 인식할 수 있습니다.

  • meta/execution-environment.yml 파일은 Python 및/또는 bindep 요구 사항 파일을 참조합니다.
  • requirements.txt 라는 파일. Python 종속 항목에 대한 정보가 포함되어 있으며 컬렉션의 루트 수준에서 찾을 수 있습니다.
  • bindep.txt 라는 파일(시스템 수준 종속 항목을 포함하며 컬렉션의 루트 수준에서 찾을 수 있음)
  • 이러한 파일 중 하나라도 컬렉션의 build_ignore 에 있는 경우 Ansible Builder는 이 섹션이 빌드 아티팩트에 포함되지 않아야 하는 파일 또는 디렉터리를 필터링하는 데 사용되므로 이러한 파일을 선택하지 않습니다.

컬렉션 유지 관리자는 introspect 명령을 사용하여 ansible-builder가 예상 요구 사항을 인식하는지 확인할 수 있습니다. 

$ ansible-builder introspect --sanitize ~/.ansible/collections/

추가 리소스

  • 컬렉션 생성에 대한 자세한 내용은 Ansible 개발자 가이드 의 컬렉션 생성을 참조하십시오.