jfxs/ansible

Docker alpine Ansible

一个用于运行https://docs.ansible.com/ansible/latest/index.html%E5%89%A7%E6%9C%AC%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E5%90%8C%E6%97%B6%E5%8C%85%E5%90%ABhttps://docs.ansible.com/ansible-lint/%E7%94%A8%E4%BA%8E%E6%B5%8B%E8%AF%95%E5%89%A7%E6%9C%AC%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8EAlpine 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容器仓库

https://shields.io/badge/Gitlab-554488?logo=gitlab&style=for-the-badge](https://gitlab.com/op_so/docker/ansible) 主仓库
https://shields.io/badge/dockerhub-1D63ED?logo=docker&logoColor=white&style=for-the-badge](https://hub.docker.com/r/jfxs/ansible) Docker Hub registry
https://shields.io/badge/quay.io-E5141F?logo=redhat&logoColor=white&style=for-the-badge](https://quay.io/repository/ifxs/ansible) Quay.io registry

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

• https://docs.ansible.com/ansible/latest/index.html
• https://ansible-lint.readthedocs.io/
• https://taskfile.dev/
• https://github.com/hvac/hvac
• https://github.com/kellyjonbrazil/jc
• https://testinfra.readthedocs.io/en/latest/
• https://yamllint.readthedocs.io/en/stable/
• https://github.com/mikefarah/yq

使用场景

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

使用方法

运行Ansible剧本

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

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

安装Ansible集合

如需安装额外集合：

shell
docker run -it --rm -v $(pwd):/ansible docker.xuanyuan.run/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 docker.xuanyuan.run/jfxs/ansible ansible-lint playbook.yml

内置组件

Docker最新标签为https://gitlab.com/op_so/docker/ansible/-/blob/master/Dockerfile%EF%BC%8C%E5%8C%85%E5%90%AB%E4%BB%A5%E4%B8%8B%E7%BB%84%E4%BB%B6%EF%BC%9A

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-----

公钥在线地址：https://gitlab.com/op_so/docker/cosign-public-key/-/raw/main/cosign.pub

验证镜像

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许可证开源，详情参见https://opensource.org/licenses/MIT%E3%80%82

作者：FX Soubirou - https://gitlab.com/op_so