2.7. 定義ファイルの内容の内訳

galaxy エントリーには、有効な要件ファイルへの参照か、ansible-galaxy collection install -r … コマンドのインラインコンテンツを含めます。

requirements.yml エントリーは、自動化実行環境定義のフォルダーのディレクトリーからの相対パスか、絶対パスにすることができます。

内容は次のようになります。

collections:
  - community.aws
  - kubernetes.core

collections:
  - community.aws
  - kubernetes.core

定義ファイル内の python エントリーでは、有効な要件ファイル、または PEP508 形式で pip install -r … コマンドの Python 要件のインラインリストを指定します。

requirements.txt エントリーは、コレクションですでに Python 依存関係としてリストされているものに加えて、追加の Python 要件をインストールするファイルです。このエントリーは、自動化実行環境定義のフォルダーのディレクトリーを基準とした相対パス、または絶対パスの形で指定できます。requirements.txt ファイルの内容は、pip freeze コマンドの標準出力と同様に、次の例のような形式にする必要があります。

内容は次のようになります。

boto>=2.49.0
botocore>=1.12.249
pytz
python-dateutil>=2.7.0
awxkit
packaging
requests>=2.4.2
xmltodict
azure-cli-core==2.11.1
openshift>=0.6.2
requests-oauthlib
openstacksdk>=0.13
ovirt-engine-sdk-python>=4.4.10

boto>=2.49.0
botocore>=1.12.249
pytz
python-dateutil>=2.7.0
awxkit
packaging
requests>=2.4.2
xmltodict
azure-cli-core==2.11.1
openshift>=0.6.2
requests-oauthlib
openstacksdk>=0.13
ovirt-engine-sdk-python>=4.4.10

定義内の system エントリーでは、bindep 要件ファイルまたは bindep エントリーのインラインリストを指定します。これにより、コレクションに依存関係として含まれていないシステムレベルの依存関係がインストールされます。

system エントリーは、自動化実行環境定義のフォルダーのディレクトリーを基準とした相対パス、または絶対パスの形で指定できます。コレクションでは、少なくとも [platform:rpm] に対する必須要件を指定する必要があります。

これを説明するために、libxml2 および subversion パッケージをコンテナーに追加する bindep.txt ファイルの例を次に示します。

内容は次のようになります。

libxml2-devel [platform:rpm]
subversion [platform:rpm]

libxml2-devel [platform:rpm]
subversion [platform:rpm]

複数のコレクションからのエントリーは、1 つのファイルに統合されます。これは bindep により処理され、dnf に渡されます。プロファイルのない要件や、ランタイム要件がイメージにインストールされません。

定義ファイルの images セクションでは、ベースイメージを指定します。署名付きコンテナーイメージの検証は、podman コンテナーランタイムでサポートされています。

次の表は、images で使用できる値のリストを示しています。