GitHub Actions中ansible-lint报错缺失tmp/ansiblelint/data/.yamllint文件

问题原因 #

使用pip install --target安装ansible-lint时，pip可能未正确复制包的静态资源文件（如默认.yamllint配置）到指定目录。ansible-lint运行时会从安装路径下的ansiblelint/data目录读取该文件，而GitHub Actions是全新环境，无本地缓存资源，因此触发文件找不到的错误。

可行解决办法 #

1. 改用--user安装（推荐） #

放弃--target参数，改用用户目录安装，pip会自动处理资源文件路径：

# 安装到用户本地目录
python3 -m pip install -r requirements.txt --user
# 将用户bin目录加入PATH，确保能找到ansible-lint
export PATH="$HOME/.local/bin:$PATH"

2. 手动复制缺失的资源文件 #

若必须使用--target，安装后手动从pip包目录复制资源文件到tmp目录：

# 获取ansible-lint的安装位置
ANSIBLE_LINT_LOC=$(pip show ansible-lint | grep Location | awk '{print $2}')
# 复制data目录到target路径
cp -r "$ANSIBLE_LINT_LOC/ansiblelint/data" tmp/ansiblelint/

3. 使用虚拟环境隔离安装 #

创建虚拟环境后安装，既避免路径问题，又保证环境干净：

# 创建虚拟环境
python3 -m venv ansible-venv
# 激活虚拟环境
source ansible-venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 运行ansible-lint
ansible-lint your-playbook.yml

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