# 解决 AWX-EE 自定义镜像构建中的依赖冲突

在构建 AWX-EE 自定义镜像时，可能会遇到依赖冲突，特别是当使用的集合对 Python 包的版本有特定要求，并且与 AWX-EE 基础镜像中预装的包产生冲突时。以下将介绍一种解决方案，通过移除冲突集合，并在项目级别安装该集合，从而绕过镜像构建时的依赖冲突。 ### 问题分析 使用 `ansible-builder` 构建 AWX-EE 自定义镜像时，`execution-environment.yml` 文件用于指定基础镜像、依赖的 Ansible 集合和 Python 包。如果 `requirements.yml` 中指定的集合依赖于特定版本的 Python 包，而该版本与 AWX-EE 基础镜像中已安装的包版本不兼容，则会导致构建失败。 例如，`nutanix.ncp` 集合可能依赖于 `requests~=2.26.0`，而 AWX-EE 基础镜像可能包含与此版本不兼容的 `requests` 版本。 ### 解决方案 一种有效的解决方案是，先从 `requirements.yml` 中移除导致冲突的集合（例如 `nutanix.ncp`），构建自定义镜像，然后在 Ansible 项目级别安装该集合。 **步骤 1：修改 `requirements.yml`** 从 `requirements.yml` 文件中移除导致冲突的集合。例如，如果 `nutanix.ncp` 导致冲突，则移除该行： “`yaml — collections: – name: community.hashi_vault – name: arubanetworks.aos_switch – name: community.general

步骤 2：构建自定义镜像

使用修改后的 requirements.yml 文件构建 AWX-EE 自定义镜像。这将创建一个不包含冲突集合的镜像。

步骤 3：在 Ansible 项目级别安装集合

在 Ansible 项目的根目录下创建一个 requirements.yml 文件（如果不存在），并将之前移除的集合添加到该文件中：

--- collections: -  name: nutanix.ncp

步骤 4：在项目中使用集合

在 Ansible playbook 中使用该集合。当 playbook 执行时，Ansible 将自动安装项目级别的 requirements.yml 文件中指定的集合。

示例

假设 execution-environment.yml 文件如下：

--- version: 1  build_arg_defaults:   EE_BASE_IMAGE: 'quay.io/ansible/awx-ee:latest'  dependencies:   galaxy: requirements.yml   python: requirements.txt  additional_build_steps:   prepend: |     RUN cat /etc/os-release    append:    RUN whoami

requirements.txt 文件如下：

hvac

按照上述步骤，首先修改 requirements.yml 文件，移除 nutanix.ncp 集合。然后，构建自定义镜像。最后，在 Ansible 项目的 requirements.yml 文件中添加 nutanix.ncp 集合。

注意事项

• 这种方法将集合的安装推迟到项目执行时，可能会增加 playbook 的首次执行时间。
• 确保项目级别的 requirements.yml 文件与 AWX-EE 自定义镜像中的其他依赖项兼容。
• 可以尝试其他解决方案，例如使用 constraints.txt 文件来约束 Python 包的版本，但这可能需要更多的调试和测试。

总结

通过从 AWX-EE 自定义镜像中移除冲突集合，并在项目级别安装该集合，可以有效地解决依赖冲突问题。这种方法允许开发者构建自定义镜像，同时仍然可以使用所需的集合，而无需处理复杂的依赖关系。