jfxs/ansible

Docker alpine Ansible

一个用于运行Ansible剧本的Docker镜像，同时包含ansible-lint用于测试剧本。该镜像基于Alpine Linux构建，轻量级且支持多架构，适合在容器环境中执行Ansible自动化任务。

核心功能和特性

• 轻量级：基于Alpine Linux，镜像大小约150 MB
• 多架构支持：兼容amd64和arm64架构
• 非root容器用户：采用非root用户运行，增强安全性
• 自动更新：通过软件物料清单(SBOM)变化自动触发更新
• 镜像签名：使用https://github.com/sigstore/cosign%E8%BF%9B%E8%A1%8C%E6%95%B0%E5%AD%97%E7%AD%BE%E5%90%8D
• SBOM证明：使用https://github.com/anchore/syft%E7%94%9F%E6%88%90%E8%BD%AF%E4%BB%B6%E7%89%A9%E6%96%99%E6%B8%85%E5%8D%95%E8%AF%81%E6%98%8E
• 多平台托管：同时发布于Docker Hub和Quay.io容器仓库

![GitLab]([] 主仓库
Docker Hub registry
![Quay.io]([] Quay.io registry

自Ansible 2.10版本起，本镜像仅包含ansible-core（无额外集合），如需扩展功能需手动安装集合。镜像包含以下工具：

• ansible-core
• ansible-lint
• go-task
• https://github.com/hvac/hvac
• https://github.com/kellyjonbrazil/jc
• testinfra
• yamllint
• https://github.com/mikefarah/yq

使用场景

• 容器化运行Ansible剧本，实现配置管理和应用部署
• 在CI/CD流程中集成Ansible任务，自动化测试和部署流程
• 使用ansible-lint验证剧本质量和语法正确性
• 安装和管理Ansible集合，扩展自动化能力
• 在多架构环境中执行统一的Ansible自动化任务

使用方法

运行Ansible剧本

在当前目录中运行Ansible剧本：

shell
docker run -it --rm -v $(pwd):/ansible jfxs/ansible ansible-playbook playbook.yml

安装Ansible集合

如需安装额外集合：

shell
docker run -it --rm -v $(pwd):/ansible jfxs/ansible /bin/sh -c "ansible-galaxy collection install ansible.utils && ansible-playbook playbook.yml"

测试剧本

使用ansible-lint测试剧本：

shell
docker run -it --rm -v $(pwd):/ansible jfxs/ansible ansible-lint playbook.yml

内置组件

Docker最新标签为2.17.6-069, 2.17, 2，包含以下组件：

https://hub.docker.com/r/jfxs/ansible%E6%8F%90%E4%BE%9B%E6%9C%80%E6%96%B0%E9%95%9C%E5%83%8F%E7%9A%84%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%E3%80%82

版本控制

Docker标签格式：

text
<ansible_version>-<increment>

• <ansible_version>: Ansible版本
• <increment>: 从001开始的构建递增编号，用于区分相同Ansible版本的不同构建

示例：2.14.2-001

镜像签名与证明

Cosign公钥

shell
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEa3yV6+yd/l4zh/tfT6Tx+zn0dhy3
BhFqSad1norLeKSCN2MILv4fZ9GA6ODOlJOw+7vzUvzZVr9IXnxEdjoWJw==
-----END PUBLIC KEY-----

公钥在线地址：<[***]>

验证镜像

shell
cosign verify --key cosign.pub $IMAGE_URI

验证SBOM证明

shell
cosign verify-attestation --key cosign.pub --type spdxjson $IMAGE_URI | jq '.payload | @base64d | fromjson | .predicate'

许可证

本项目基于MIT许可证开源，详情参见LICENSE。

作者：FX Soubirou - GitLab仓库