21.2. 設定オプション

src

ビルドコンテキストディレクトリーにコピーするソースファイルを指定します。

これは、/home/user/.ansible.cfg などの絶対パス、またはファイルに対する相対パスで指定できます。相対パスは、1 つ以上のファイルに一致する glob 式にすることができます (files/\*.cfg など)。絶対パスには正規表現を含めることができない点に注意してください。src がディレクトリーの場合、そのディレクトリーの内容全体が dest にコピーされます。

dest

ソースファイル (例: files/configs) が含まれるビルドコンテキストディレクトリーの _build サブディレクトリーの下にあるサブディレクトリーパスを指定します。

この値を絶対パスで指定することや、パス内に .. を追加できません。このディレクトリーが存在しない場合は、自動的に作成されます。

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

これは、イメージのビルドプロセス中にパッケージマネージャーのキャッシュがクリアされる頻度を制御します。

この値が設定されていない場合 (デフォルト)、キャッシュは頻繁にクリアされます。値が always の場合、キャッシュはクリアされません。それ以外の値を指定すると、最終ビルド段階でシステムの依存関係がインストールされた後にのみキャッシュが強制的にクリアされます。

ansible_core

インストールされる ansible-core Python パッケージのバージョン。

この値は、キー (package_pip) が 1 つ含まれるディクショナリーです。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) が 1 つ含まれるディクショナリーです。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 要件ファイルを 1 つのファイルに結合します。

このライブラリーは、他のファイルへの参照を含む複雑な構文をサポートします。多数のコレクションに同じ パッケージ名 が必要な場合、Ansible Builder はそれらを 1 つのエントリーにまとめ、制約を結合します。

Ansible Builder は、コレクションにパッケージが依存関係としてリストされている場合でも、Python 依存関係の結合ファイル内の一部のパッケージを除外します。これには、テストパッケージと、Ansible 自体を提供するパッケージが含まれます。完全なリストは、src/ansible_builder/_target_scripts/introspect.py の EXCLUDE_REQUIREMENTS で確認できます。

このような除外されるパッケージ名のいずれかを含める必要がある場合は、introspect コマンドの --user-pip オプションを使用して、ユーザー要件ファイルにそのパッケージ名をリストします。

この方法で提供されたパッケージは、除外された Python パッケージのリストに対して処理されません。

python_interpreter

dnf によってインストールされる Python システムパッケージ名 (package_system) または使用される Python インタープリターへのパス (python_path) を定義するディクショナリー。

system

インストールされるシステムパッケージ (bindep 形式)。ファイル名または要件のリストを指定できます。

bindep の詳細は、OpenDev のドキュメント を参照してください。

システムパッケージの場合、bindep 形式を使用してクロスプラットフォーム要件を指定すると、実行環境が使用するパッケージ管理システムによってシステムパッケージをインストールできます。コレクションで、[platform:rpm] に必要な要件を指定する必要があります。Ansible Builder は、複数のコレクションのシステムパッケージエントリーを 1 つのファイルに結合します。プロファイルのない要件 (ランタイム要件) のみがイメージにインストールされます。互いに重複している多数のコレクションのエントリーを、結合ファイルに統合できます。

base_image

実行環境の親イメージを定義するディクショナリー。

使用するコンテナーイメージには name キーを指定する必要があります。イメージがリポジトリー内でミラーリングされているが、イメージの元の署名キーで署名されている場合は、signature_original_name キーを使用します。