第 20 章 执行环境

要构建镜像，您必须安装 Podman 或 Docker，以及 ansible-builder Python 软件包。

--container-runtime 选项必须与您要使用的 Podman 或 Docker 可执行文件对应。

在构建执行环境镜像时，它必须支持部署 Ansible Automation Platform 的架构。

如需更多信息，请参阅 Ansible Builder 的 Quickstart，或 创建和使用执行环境。

ansible-builder 用于创建执行环境。

执行环境必须包含：

构建新的执行环境涉及定义，该定义指定要包含在执行环境中的内容，如集合、Python 要求和系统级软件包。定义必须是 .yml 文件

从迁移到执行环境生成的输出中的内容有一些需要的数据，这些数据可以传送到文件或粘贴到此定义文件中。

集合开发人员可以通过提供适当的元数据来声明其内容要求。

如需更多信息，请参阅 依赖项。

ansible-builder build 命令将执行环境定义用作输入。它输出构建执行环境镜像所需的构建上下文，然后构建该镜像。镜像可以使用其他构建上下文重新构建，并生成相同的结果。默认情况下，构建器在当前目录中搜索名为 execution-environment.yml 的文件。

以下示例 execution-environment.yml 文件可用作起点：

---
version: 3
dependencies:
  galaxy: requirements.yml

requirements.yml 的内容：

---
collections:
  - name: awx.awx

要使用前面的文件构建执行环境，并运行以下命令：

ansible-builder build
...
STEP 7: COMMIT my-awx-ee
--> 09c930f5f6a
09c930f5f6ac329b7ddb321b144a029dbbfcc83bdfc77103968b7f6cdfc7bea2
Complete! The build context can be found at: context

除了生成随时可用的容器镜像外，构建上下文也会保留。这可以通过您选择的工具（如 docker build 或 podman build ）在不同时间或位置进行重建。

重建执行环境是添加证书的一种方式，但从主机继承证书提供了一种更方便的解决方案。对于基于虚拟机的安装，自动化控制器会在作业运行时会在执行环境中自动挂载系统信任存储。

您可以在 Paths 中自定义执行环境挂载选项和挂载路径，以公开给 Job Settings 页面的 isolated jobs 字段，其中支持 Podman 风格的卷挂载语法。

[
  "/mnt2:/mnt2",
  "/mnt3",
  "/mnt4:/mnt4:0"
]