haxorof/ansible-lint

Ansible-lint

https://img.shields.io/docker/pulls/haxorof/ansible-lint](https://hub.docker.com/r/haxorof/ansible-lint/) https://github.com/haxorof/docker-ansible-lint/workflows/CI/badge.svg](https://github.com/haxorof/docker-ansible-lint/actions?query=workflow%3ACI)

"ansible-lint 检查 playbooks 的实践和行为，识别潜在可改进的问题" https://github.com/willthames/ansible-lint

Ansible-lint Docker 镜像提供了 ansible-lint 工具的容器化版本，用于检查 Ansible playbooks 的实践和行为，识别潜在可改进的问题。该镜像支持多种标签版本，基于不同基础镜像（Almalinux 和 Alpine）构建，便于集成到本地开发环境或 CI/CD 流程中。

核心功能与特性

• 多版本支持：提供 v25、v24 等主要版本，满足不同兼容性需求
• 多基础镜像：基于 Almalinux 和 Alpine 构建，兼顾稳定性与轻量性
• 标签体系：包含特定版本标签（如 v25-almalinux）和共享标签（如 latest、v25）

标签说明

简单标签

• v25-almalinux
• v25-alpine
• v24-almalinux
• v24-alpine

共享标签

• v25、latest-alpine、latest
  • 指向 v25-alpine
• v24
  • 指向 v24-alpine
• latest-almalinux
  • 指向 v25-almalinux

使用方法

基本使用

在本地环境中直接运行容器，检查当前目录下的 Ansible 内容：

console
docker run -it --rm -v ${PWD}:/mnt:ro docker.xuanyuan.run/haxorof/ansible-lint

Bash 别名配置

为简化使用，可通过创建 ~/.bash_aliases 文件设置 bash 别名：

bash
alias ansible-lint='docker run -it --rm -v ${PWD}:/mnt:ro haxorof/ansible-lint'

配置后，可直接在终端使用 ansible-lint 命令调用容器。

在 Github Actions 中使用

将镜像集成到 CI/CD 流程，实现代码提交时自动 lint 检查：

yaml
name: Linting
on:
  push:
    branches:
      - master
  pull_request:
    branches:
      - master

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Ansible Linting
        run: docker run --rm -v ${GITHUB_WORKSPACE}:/mnt haxorof/ansible-lint -v --force-color .