cytopia/ansible-lint

ansible-lint Docker镜像

镜像概述

本镜像为https://github.com/ansible/ansible-lint%E7%9A%84Docker%E5%8C%96%E7%89%88%E6%9C%AC%EF%BC%8C%E5%9F%BA%E4%BA%8EAlpine Linux构建，采用多阶段构建方式实现轻量级镜像。镜像每晚针对ansible-lint的最新稳定版本进行构建并推送到Dockerhub，确保用户能够获取最新功能和安全更新。

支持架构：amd64、i386、arm64

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多架构支持：兼容amd64、i386、arm64多种硬件架构
• 持续更新：每晚自动构建，确保与ansible-lint最新稳定版同步
• 灵活标签策略：提供滚动发布和时间点发布两种标签，满足不同使用场景需求

镜像标签说明

滚动发布标签

以下标签为滚动更新版本，每晚自动构建并更新：

时间点发布标签

以下标签为固定版本，构建后不再更新，适用于需要可重现构建的场景：

Docker挂载说明

容器内的工作目录为**/data/**，需将本地项目根目录（包含.ansible-lint配置文件）挂载到此路径。

使用方法

基本用法示例

检查单个剧本

bash
docker run --rm -v $(pwd):/data docker.xuanyuan.run/cytopia/ansible-lint playbook.yml

检查所有剧本（通配符）

bash
docker run --rm -v $(pwd):/data docker.xuanyuan.run/cytopia/ansible-lint *.yml

检查单个角色（从角色根目录运行）

bash
docker run --rm -v "$(pwd)":"/data/$(basename "$(pwd)" )" -e ANSIBLE_ROLES_PATH="/data" docker.xuanyuan.run/cytopia/ansible-lint "/data/$(basename "$(pwd)" )/tests/test.yml"

GitLabCI配置

GitLabCI需要指定shell入口点，配置示例如下：

yaml
default:
  image:
    name: cytopia/ansible-lint:latest
    entrypoint: ["/bin/sh", "-c"]

stages:
  - lint

ansible-linter:
  stage: lint
  script:
    - ansible-lint *.yaml
  only:
    - merge_requests
    - master

使用场景

• 本地开发：在不安装ansible-lint及其依赖的情况下，对Ansible剧本进行快速检查
• 持续集成：集成到CI/CD流水线（如GitLabCI、GitHub Actions等），在代码提交或合并请求时自动进行Ansible代码质量检查
• 多环境一致性：确保开发、测试和生产环境使用相同版本的ansible-lint，避免版本差异导致的检查结果不一致

许可协议

本项目采用https://opensource.org/licenses/MIT%EF%BC%8C%E7%89%88%E6%9D%83%E6%89%80%E6%9C%89(c) 2019 https://github.com/cytopia