AWX部署于K3s环境下无法自动下载Ansible集合的问题咨询

以下是几个需要逐一验证的关键步骤，覆盖常见的配置遗漏点：

• 开启Job Template的集合自动安装选项
  AWX默认不会自动处理requirements.yml，必须手动启用。进入对应的Job Template，切换到「Advanced」标签页，勾选Install collections选项。开启后，AWX会在执行剧本前自动解析并下载requirements.yml中定义的集合。

• 确认requirements.yml的路径与AWX的读取规则匹配
  AWX默认会在项目根目录查找requirements.yml，如果你的文件放在collections/子目录下，需要显式指定路径。在Job Template的「Extra Variables」中添加：

  ansible_collections_requirements: ./collections/requirements.yml
  

• 验证requirements.yml的语法正确性
  确保VMware集合的配置格式符合要求，示例如下：

  collections:
    - name: community.vmware
      # 可选：指定版本范围，避免兼容性问题
      version: ">=3.0.0"
  

  YAML对缩进要求严格，格式错误会直接导致AWX无法解析文件。

• 检查AWX Runner Pod的网络连通性
  K3s集群内的AWX Runner Pod需要能访问Ansible Galaxy（galaxy.ansible.com）才能下载集合。执行以下命令进入Pod测试网络：

  kubectl exec -it <你的AWX Runner Pod名称> -- curl https://galaxy.ansible.com
  

  如果无法连通，需要配置集群的代理规则，或调整防火墙策略允许出站流量到Galaxy域名。

• 确保GitLab项目同步正常
  进入AWX的「Projects」页面，手动点击「Sync」按钮同步GitLab仓库，确认collections/requirements.yml已被正确拉取。若同步失败，检查GitLab的访问凭证（SSH密钥、个人访问令牌）是否配置正确，权限是否足够。

• 查看Job日志定位具体错误
  执行失败后，进入对应Job的日志详情页，搜索与集合安装相关的错误信息（比如Failed to install collection、module not found等），日志中的具体提示是定位问题的核心依据。

• 手动构建包含VMware集合的执行环境
  如果自动下载始终无法生效，可以创建自定义执行环境预安装集合：

  1. 编写Dockerfile基于AWX默认镜像扩展：

     FROM quay.io/ansible/awx-ee:latest
     RUN ansible-galaxy collection install community.vmware -p /usr/share/ansible/collections
     

  2. 构建镜像并推送到私有镜像仓库（如GitLab Registry）
  3. 在AWX中配置该自定义执行环境，然后在Job Template中选择使用。

内容的提问来源于stack exchange，提问作者SwiperNo