创建和恢复执行环境

1. 获取基础镜像
2. 在基础镜像的临时副本中，会下载集合，以及声明的 Python 和系统依赖项列表（若有）。
3. 在临时构建器镜像中，用于定义文件中列出的所有 Python 依赖关系的 Python wheels 将下载并构建（根据需要），包括由定义文件中列出的集合声明的所有 Python 依赖项。
4. 运行为来自定义文件的 additional_build_steps 的 prepend。
5. 在最后的自动化执行环境镜像中，会安装定义文件中列出的系统依赖项，包括由定义文件中列出的集合声明的所有系统依赖项。
6. 在最后的自动化执行环境镜像中，下载的集合会被复制，并安装了之前获取的 Python 依赖项。
7. 运行为来自定义文件的 additional_build_steps 的 prepend。

流程

1. 通过 Podman 登录到 registry.redhat.io：

   $ podman login -u="[username]" -p="[token/hash]" registry.redhat.io

2. 确保您可以拉取所需的自动化执行环境基础镜像

   podman pull registry.redhat.io/ansible-automation-platform-22/ee-minimal-rhel8:latest

3. 配置 Ansible Builder 文件，以指定所需的基础镜像以及添加到新执行环境镜像的任何其他内容。

   1. 例如，要将 来自 Galaxy 的 Kubernetes Core Collection 添加到镜像中，请按如下所示填写 requirements.yml 文件：

      collections:
        - kubernetes.core

   2. 如需有关定义文件及其内容的更多信息，请参阅定义文件分类部分。

4. 在执行环境定义文件中，在 EE_BASE_IMAGE 字段中指定原始 ee-minimal 容器 URL 和标签。在这样做时，您的最终 execute-environment.yml 文件将类似如下：

   例 3.1. 自定义 execution-environment.yml 文件

   version: 1
   
   build_arg_defaults:
     EE_BASE_IMAGE: 'registry.redhat.io/ansible-automation-platform-22/ee-minimal-rhel8:latest'
   
   dependencies:
     galaxy: requirements.yml

   注意

   由于本例使用 kubernetes.core 的社区版本，而不是来自自动化中心的认证集合，因此我们不需要创建 ansible.cfg，也不在定义文件中引用。

5. 使用以下命令构建新执行环境镜像：

   $ ansible-builder build -t registry.redhat.io/[username]/new-ee

   其中 [username] 指定您的用户名，new-ee 指定新容器镜像的名称。

1. 使用 podman images 命令确认您的新容器镜像在该列表中：

   例 3.2. 使用镜像 new-ee 的 podman images 命令的输出

   REPOSITORY          TAG     IMAGE ID      CREATED        SIZE
   localhost/new-ee    latest  f5509587efbb  3 minutes ago  769 MB

   1. 验证是否安装了集合：

      $ podman run registry.redhat.io/[username]/new-ee ansible-doc -l kubernetes.core

   2. 标记在自动化中心中使用的镜像：

      $ podman tag registry.redhat.io/[username]/new-ee [automation-hub-IP-address]/[username]/new-ee

   3. 使用 Podman 登录到您的自动化 hub:

      注意

      您必须具有 Automation hub 的 admin 或适当的容器存储库权限才能推送容器。如需更多信息，请参阅 Red Hat Ansible Automation Platform 文档中的在私有自动化中心管理容器。

      $ podman login -u="[username]" -p="[token/hash]" [automation-hub-IP-address]

   4. 将镜像推送到自动化 hub 中的容器 registry 中：

      $ podman push [automation-hub-IP-address]/[username]/new-ee

   5. 将新镜像拉取(pull)到自动化控制器实例中：
2. 进入自动化控制器。
3. 在侧面导航栏中，点 Administration → Execution Environments。
4. 点击 Add。

5. 输入适当的信息，然后点 Save 以拉取新镜像。

   注意

   如果您的自动化中心实例受密码或令牌保护，请确保设置了适当的容器 registry 凭证。

流程

1. 使用 registry.redhat.io 凭证登录到 Podman：

   $ podman login registry.redhat.io

2. 在提示符处输入您的用户名和密码。

3. 拉取容器镜像：

   $ podman pull registry.redhat.io/<container_image_name>:<tag>

验证

1. 列出本地存储中的镜像：

   $ podman images

2. 验证您最近拉取的镜像是否包含在列表中。
3. 验证该标签是否正确。

验证

1. 列出本地存储中的镜像：

   $ podman images

2. 验证您最近使用自动化中心信息标记的镜像是否包含在列表中。

流程

1. 使用您的自动化中心位置和凭证登录到 Podman：

   $ podman login -u=<username> -p=<password> <automation_hub_url>

2. 将容器镜像推送到自动化中心容器 registry：

   $ podman push <automation_hub_url>/<container_image_name>

   注意

   当 registry.redhat.io 的签名镜像被推送到自动化中心容器 registry 时，需要 --remove-signatures 标志。push 操作会在上传期间重新编译镜像层，无法保证可重复生成，依赖于客户端实施。这可能会导致镜像层摘要的变化，并导致推送操作失败，Error: Copying this image requires changing layer representation, which is not possible (image is signed or the destination specifies a digest)。

验证

1. 登录到您的自动化中心。
2. 进入 Container Registry。
3. 在 container 存储库列表中找到容器。

流程

1. 进入 Execution Environments。
2. 选择您的容器存储库。
3. 在 Details 标签页中，点 Add。
4. 在 Raw Markdown 文本字段中，使用 Markdown 格式输入您的 README 文本。
5. 完成后点 Save。

流程

1. 进入 Execution Environments。
2. 选择您的容器存储库。
3. 点击窗口右上角的 Edit。

4. 在 Groups with access 中选择要分配访问权限的一个或多个组。

   • 可选：使用该组名称下的下拉菜单为特定组添加或删除权限。
5. 点击 Save。

流程

1. 进入 Execution Environments。
2. 选择您的容器存储库。
3. 点 Images 选项卡。
4. 点 ，然后点 Manage tags。

5. 在文本字段中添加新标签，然后点 Add。

   • 可选：通过点该镜像的任何标签上的 x 来删除当前标签。
6. 点击 Save。

流程

1. 进入自动化控制器。
2. 在侧边栏中，点 Resources → Credentials。
3. 点 Add 以创建新凭据。
4. 输入授权 Name、Description 和 Organization。
5. 选择凭据类型。
6. 输入身份验证 URL。这是容器 registry 地址。
7. 输入登录到容器 registry 所需的 Username 和 Password or Token。
8. （可选）选择 Verify SSL 来启用 SSL 验证。
9. 点击 Save。

流程

1. 进入 Execution Environments。
2. 选择您的容器存储库。
3. 在 Pull this image 条目中，点 Copy to clipboard。
4. 在终端中粘贴并运行命令。

1. 进入到 Execution Environments → Remote Registries。
2. 将 https://registry.redhat.io 添加到 registry。
3. 添加所需的任何凭证进行验证。

1. 进入到 Execution Environments → Execution Environments。
2. 在页面标头中点 Add execution environment。
3. 选择您要从中拉取的 registry。"name"字段显示本地 registry 上显示的镜像的名称。