GitLab流水线安装Ansible Galaxy角色失败求助

1. 验证Ansible Galaxy API的可用性 #

• 在流水线运行的环境中，执行curl https://galaxy.ansible.com/api/，检查返回的JSON数据里是否包含current_version字段，确认API服务是否正常响应
• 排查GitLab Runner所在环境的网络规则，确认没有防火墙、代理拦截对Galaxy API的请求

2. 锁定角色版本 #

• 在Ansible的requirements.yml文件中，给geerlingguy.docker角色指定具体版本号，避免动态拉取最新版本时触发API兼容性问题，示例：

  - name: geerlingguy.docker
    version: 6.0.0 # 替换为之前能正常运行的稳定版本
  

• 手动执行ansible-galaxy install -r requirements.yml，测试指定版本的角色能否正常安装

3. 检查Ansible组件版本兼容性 #

• 确认流水线使用的Ansible、ansible-galaxy版本，部分旧版本的ansible-galaxy与新版Galaxy API存在兼容性问题
• 尝试升级到最新稳定版的Ansible，或者回退到之前流水线能正常运行的版本

4. 清理缓存后重试 #

• 删除Ansible Galaxy本地缓存（默认路径~/.ansible/galaxy_cache/），避免缓存的错误数据影响拉取
• 在GitLab流水线步骤中添加缓存清理命令，确保每次运行都是干净的环境

5. 核对角色源配置 #

• 检查requirements.yml或ansible.cfg配置，确认角色的拉取源是官方Galaxy，没有被误配置为私有仓库或其他镜像源

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