创建和使用执行环境

流程

1. 在终端中，运行以下命令来激活 Ansible Automation Platform 仓库：

   #  dnf install --enablerepo=ansible-automation-platform-2.4-for-rhel-9-x86_64-rpms ansible-builder

1. 在 基础 构建阶段，指定的基础镜像是（可选）由其他构建阶段自定义的组件，包括 Python、pip、ansible-core 和 ansible-runner。然后，生成的镜像会被验证以确保所需的组件可用（因为它们可能已在基础镜像中存在）。生成的 自定义基础镜像 的临时副本用作所有其他构建阶段的基础。
2. 在 galaxy 构建阶段，由定义文件指定的集合会在 最终 构建阶段下载并供以后安装。还会收集集合声明的 Python 和系统依赖项（若有），以便稍后进行分析。
3. 在 构建器 构建阶段，集合声明的 Python 依赖项与定义文件中列出的 Python 依赖项合并。最后的 Python 依赖项被下载并构建为 Python wheels，并在 最终 构建阶段存储下来。
4. 在 最终 构建阶段，会安装之前下载的集合，以及系统软件包以及之前由集合声明为依赖项或定义文件中列出的依赖项的、以前构建的 Python 软件包。

流程

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

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

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

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

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

   1. 例如，要将 来自 Galaxy 的 Kubernetes Core Collection 添加到镜像中，请使用 Galaxy 条目：

      collections:
        - kubernetes.core

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

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

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

   version: 3
   
   images:
     base_image: 'registry.redhat.io/ansible-automation-platform-24/ee-minimal-rhel9:latest'
   
   dependencies:
     galaxy:
       collections:
         - kubernetes.core

   注意

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

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

   $ ansible-builder build -t [username]/new-ee

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

   注意

   如果您在构建中没有使用 -t，则创建名为 ansible-execution-env' 的镜像，并加载到本地容器 registry 中。

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

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

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

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

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

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

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

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

   注意

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

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

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

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

10. 将新镜像拉取(pull)到自动化控制器实例中：

    1. 进入自动化控制器。
    2. 在导航面板中，选择 Administration → Execution Environments。
    3. 点Add。

    4. 输入适当的信息，然后点 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. 检查镜像名称，并验证标签是否正确。

验证

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>

验证

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

流程

1. 登录到自动化中心。
2. 在导航面板中，选择 Execution Environments → Execution Environments。
3. 选择您的容器存储库。
4. 在 Details 标签页中，点 Add。
5. 在 Raw Markdown 文本字段中，使用 Markdown 格式输入您的 README 文本。
6. 完成后点 Save。

流程

1. 登录到自动化中心。
2. 在导航面板中，选择 Execution Environments → Execution Environments。
3. 选择您的容器存储库。
4. 在 Access 选项卡中，点 Select a group。
5. 选择您要授予访问权限的组，然后点 Next。
6. 选择您要添加到此执行环境的角色，然后点 Next。
7. 点Add。

流程

1. 在导航面板中，选择 Execution Environments → Execution Environments。
2. 选择您的容器存储库。
3. 点 Images 选项卡。
4. 点 More Actions 图标 ⋮，点 Manage tags。
5. 在文本字段中添加新标签，然后点 Add。
6. 可选：通过点该镜像的任何标签上的 x 来删除当前标签。
7. 点击 Save。

流程

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

流程

1. 如果您要从密码保护的 registry 中拉取容器镜像，请在拉取镜像前 在自动化控制器中创建凭证。
2. 在导航面板中，选择 Execution Environments → Execution Environments。
3. 选择您的容器存储库。
4. 在 Pull this image 条目中，点 Copy to clipboard。
5. 在终端中粘贴并运行命令。

流程

1. 在导航面板中，选择 Execution Environments → Execution Environments。
2. 将 https://registry.redhat.io 添加到 registry。

3. 添加所需的任何凭证进行验证。

   注意

   有些容器 registry 有速率限制。在 Advanced Options 下设置速率限制。

4. 在导航面板中，选择 Execution Environments → Execution Environments。
5. 在页面标头中点 Add execution environment。

6. 选择您要从中拉取的 registry。Name 字段显示本地 registry 中显示的镜像名称。

   注意

   Upstream name 字段是远程服务器上的镜像名称。例如，如果上游名称被设置为 "alpine"，并且 Name 字段为 "local/alpine"，则 alpine 镜像会从远程下载，并重命名为 "local/alpine"。

7. 设置要包含或排除的标签列表。将镜像与大量标签同步会非常耗时，并且需要使用大量磁盘空间。