21.2. 구성 옵션

src

빌드 컨텍스트 디렉터리에 복사할 소스 파일을 지정합니다.

이는 절대 경로(예: /home/user/.ansible.cfg ) 또는 파일과 관련된 경로일 수 있습니다. 상대 경로는 하나 이상의 파일(예: files/\*.cfg )과 일치하는 glob 표현식일 수 있습니다. 절대 경로는 정규식을 포함하지 않아야 합니다. src 가 디렉터리이면 해당 디렉토리의 전체 콘텐츠가 dest 로 복사됩니다.

dest

소스 파일이 포함된 빌드 컨텍스트 디렉터리의 _build 하위 디렉터리 아래에 있는 하위 디렉터리 경로를 지정합니다(예: files/configs ).

절대 경로이거나 경로 내에 포함할 수 없습니다. 이 디렉터리가 없는 경우 사용자를 위해 생성됩니다.

append_base

기본 이미지를 빌드한 후 삽입할 명령입니다.

append_builder

빌더 이미지를 빌드한 후 삽입할 명령입니다.

append_final

최종 이미지를 빌드한 후 삽입할 명령입니다.

append_galaxy

Galaxy 이미지를 빌드한 후 삽입할 명령입니다.

prepend_base

기본 이미지를 빌드하기 전에 삽입할 명령입니다.

prepend_builder

빌더 이미지를 빌드하기 전에 삽입할 명령입니다.

prepend_final

최종 이미지를 빌드하기 전에 삽입할 명령입니다.

prepend_galaxy

Galaxy 이미지를 빌드하기 전에 삽입할 명령입니다.

ANSIBLE_GALAXY_CLI_COLLECTION_OPTS

사용자가 -pre 플래그 및 기타 플래그를 전달하여 사전 릴리스 컬렉션을 설치할 수 있습니다.

ANSIBLE_GALAXY_CLI_ROLE_OPTS

이를 통해 사용자는 --no-deps 와 같은 플래그를 역할 설치에 전달할 수 있습니다.

PKGMGR_PRESERVE_CACHE

이렇게 하면 이미지 빌드 프로세스 중에 패키지 관리자 캐시가 지워지는 빈도가 제어됩니다.

기본값인 이 값을 설정하지 않으면 캐시가 자주 지워집니다. 값이 항상 이면 캐시가 지워지지 않습니다. 다른 모든 값은 시스템 종속 항목이 최종 빌드 단계에 설치된 경우에만 캐시를 지워야 합니다.

ansible_core

설치할 ansible-core Python 패키지의 버전입니다.

이 값은 단일 키 package_pip 가 있는 사전입니다. package_pip 값은 설치를 위해 pip로 직접 전달되며 pip가 지원하는 모든 형식으로 사용할 수 있습니다. 다음은 몇 가지 예제 값입니다.

ansible_core:
    package_pip: ansible-core
ansible_core:
    package_pip: ansible-core==2.14.3
ansible_core:
    package_pip: https://github.com/example_user/ansible/archive/refs/heads/ansible.tar.gz

ansible_runner

설치할 Ansible Runner Python 패키지의 버전입니다.

이 값은 단일 키 package_pip 가 있는 사전입니다. package_pip 값은 설치를 위해 pip로 직접 전달되며 pip가 지원하는 모든 형식으로 사용할 수 있습니다. 다음은 몇 가지 예제 값입니다.

ansible_runner:
    package_pip: ansible-runner
ansible_runner:
    package_pip: ansible-runner==2.3.2
ansible_runner:
    package_pip: https://github.com/example_user/ansible-runner/archive/refs/heads/ansible-runner.tar.gz

Galaxy

Ansible Galaxy에서 설치할 컬렉션입니다.

이는 Ansible Galaxy requirements.yml 파일의 파일 이름, 사전 또는 다중 줄 문자열 표현일 수 있습니다. 요구 사항 파일 형식에 대한 자세한 내용은 Galaxy 사용자 가이드를 참조하십시오.

python

Python 설치 요구 사항입니다.

파일 이름 또는 요구 사항 목록일 수 있습니다. Ansible Builder는 requirements-parser 라이브러리를 사용하여 모든 컬렉션의 모든 Python 요구 사항 파일을 단일 파일로 결합합니다.

이 라이브러리는 다른 파일에 대한 참조를 포함하여 복잡한 구문을 지원합니다. 많은 컬렉션에 동일한 패키지 이름이 필요한 경우 Ansible Builder는 이를 단일 항목에 결합하고 제약 조건을 결합합니다.

Ansible Builder는 컬렉션이 종속 항목으로 나열되는 경우에도 Python 종속 항목의 결합된 파일에서 일부 패키지를 제외합니다. 여기에는 Ansible 자체를 제공하는 패키지 및 테스트 패키지가 포함됩니다. 전체 목록은 src/ansible_builder/_target_scripts/introspect.py 의 EXCLUDE_REQUIREMENTS 에서 사용할 수 있습니다.

제외된 패키지 이름 중 하나를 포함해야 하는 경우 introspect 명령의 --user-pip 옵션을 사용하여 사용자 요구 사항 파일에 나열합니다.

이 방식으로 제공된 패키지는 제외된 Python 패키지 목록에 대해 처리되지 않습니다.

python_interpreter

dnf(package_system)에서 설치할 Python 시스템 패키지 이름을 정의하는 사전 또는 사용할 Python 인터프리터 경로(python_path) 입니다.

system

bindep 형식으로 설치할 시스템 패키지입니다. 파일 이름 또는 요구 사항 목록일 수 있습니다.

bindep에 대한 자세한 내용은 OpenDev 설명서 를 참조하십시오.

시스템 패키지의 경우 bindep 형식을 사용하여 플랫폼 간 요구 사항을 지정하므로 실행 환경에서 사용하는 패키지 관리 시스템에서 설치할 수 있습니다. 컬렉션은 [platform:rpm] 에 필요한 요구 사항을 지정해야 합니다. Ansible Builder는 여러 컬렉션의 시스템 패키지 항목을 단일 파일로 결합합니다. 프로필이 없는 요구 사항(런타임 요구 사항)만 이미지에 설치됩니다. 결합된 파일에 서로 중복되는 많은 컬렉션의 항목을 통합할 수 있습니다.

base_image

실행 환경에 대한 상위 이미지를 정의하는 사전입니다.

사용할 컨테이너 이미지와 함께 이름 키를 제공해야 합니다. 이미지가 저장소 내에 미러링되었지만 원본 이미지의 서명 키로 서명된 경우 signature_original_name 키를 사용합니다.