如何配置Mega-Linter使ansible-lint自动检查全项目YAML文件

1. 排查配置文件的扫描范围限制 #

检查.mega-linter.yml中的路径规则：

• 确保ANSIBLE_LINT_FILTER_REGEX_INCLUDE设置为匹配所有YAML文件，避免仅限定特定文件名：

  ANSIBLE_LINT_FILTER_REGEX_INCLUDE: '.*\.ya?ml$'
  

• 确认EXCLUDED_DIRECTORIES未包含需要扫描的目标目录，防止合法文件被排除。

2. 验证容器挂载路径正确性 #

如果通过容器命令运行Mega-Linter，必须确保本地目录正确挂载到容器默认扫描目录/tmp/lint：

docker run -v "$(pwd):/tmp/lint" oxsecurity/megalinter:latest

挂载路径错误会导致容器无法读取本地YAML文件，直接跳过校验。

3. 检查Azure Pipeline的工作目录与挂载配置 #

在Azure Pipeline任务中，确保工作目录和容器挂载路径匹配：

- task: Docker@2
  inputs:
    command: 'run'
    arguments: '-v $(System.DefaultWorkingDirectory):/tmp/lint oxsecurity/megalinter:latest'
    workingDirectory: '$(System.DefaultWorkingDirectory)'

避免通过ENV SCAN_DIRECTORY覆盖默认扫描目录，除非明确指定了目标路径。

4. 开启调试日志定位问题 #

在配置文件中强制启用ANSIBLE_LINT并开启调试模式，查看执行细节：

ENABLED_LINTERS:
  - ANSIBLE_LINT
LOG_LEVEL: DEBUG

通过日志确认ANSIBLE_LINT是否初始化成功、是否识别到目标文件，或是因文件不符合Ansible标准结构被跳过。

5. 强制ansible-lint扫描所有YAML文件 #

ansible-lint默认仅识别含hosts/tasks等关键字的标准Ansible文件，若需扫描所有YAML，添加参数强制扫描：

ANSIBLE_LINT_ARGUMENTS: '--lintable all'

6. 升级Mega-Linter到最新版本 #

旧版本可能存在ANSIBLE_LINT集成bug，使用oxsecurity/megalinter:latest镜像确保兼容性。

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