gableroux/ansible

Docker ansible

用于在CI环境中使用 ansible 和 ssh 的Docker镜像 :+1:

![Requirements Status]([***]

镜像概述和主要用途

本镜像旨在提供一个轻量级环境，方便在CI（持续集成）流程中使用ansible和ssh工具。基于alpine Linux构建，确保体积小巧且资源占用低，适合作为CI/CD pipeline中的部署阶段执行环境，用于自动化服务器配置和应用部署任务。

核心功能和特性

• 集成ansible和ssh工具，满足自动化部署需求
• 基于alpine Linux，镜像体积小，拉取速度快
• 提供多种ansible版本标签，适配不同项目需求
• 通过GitHub Actions实现自动构建和部署，确保版本更新及时
• 支持GitLab CI等主流CI平台，配置简单

使用场景和适用范围

• CI/CD流程中的自动化部署阶段
• 需要通过ansible执行服务器配置或应用部署的场景
• GitLab CI、GitHub Actions等持续集成平台
• 对部署环境有轻量化要求的项目

使用方法和配置说明

命令行使用

直接运行镜像进入交互式环境：

bash
docker run --rm -it gableroux/ansible:5.0.1

GitLab CI配置示例

在.gitlab-ci.yml中配置部署阶段：

yaml
.ansible:5.0.1
  stage: deploy
  when: manual
  image: gableroux/ansible:5.0.1
  before_script:
    # https://docs.gitlab.com/ee/ci/ssh_keys/
    - eval $(ssh-agent -s)
    - mkdir ~/.ssh/
    - chmod 700 ~/.ssh
    - echo "$SSH_CONFIG" > ~/.ssh/config
    - echo "$SSH_KNOWN_HOSTS" > ~/.ssh/known_hosts
    - chmod 644 ~/.ssh/known_hosts
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add - > /dev/null

deploy-example-master:
  <<: *ansible
  script:
    - ansible --version
    - ansible-playbook -i host-example deploy.yml
  only:
    - master

FAQ

如何部署新的Docker镜像？

scripts目录中有一个脚本，它从versions.txt读取值并运行必要的命令，以带有标签的方式推送到仓库并触发Docker Hub。 :v:

为什么要使用Docker镜像？

使用pip安装ansible是可行的，但拉取此镜像速度更快。

为什么不使用官方ansible镜像？

正如官方镜像简短描述中所述：

用于ansible自动化测试的镜像。它们不包含ansible，不面向最终用户。

官方镜像用于运行ansible项目的测试。我们希望有一个官方镜像用于实际运行ansible。

我需要的版本不在列表中，该怎么办？

请查看https://hub.docker.com/r/gableroux/ansible/tags%EF%BC%8C%E5%A4%A7%E5%A4%9A%E6%95%B0%E7%89%88%E6%9C%AC%E9%83%BD%E5%8F%AF%E7%94%A8%E3%80%82%E9%A1%B9%E7%9B%AE%E5%B7%B2%E8%AE%BE%E7%BD%AE%E8%87%AA%E5%8A%A8PR%E7%94%A8%E4%BA%8E%E7%89%88%E6%9C%AC%E5%8D%87%E7%BA%A7%EF%BC%8C%E5%9B%A0%E6%AD%A4%E6%82%A8%E9%9C%80%E8%A6%81%E7%9A%84%E7%89%88%E6%9C%AC%E5%BA%94%E8%AF%A5%E5%B7%B2%E5%AD%98%E5%9C%A8%E3%80%82%E5%A6%82%E6%9E%9C%E7%94%B1%E4%BA%8E%E6%9F%90%E4%BA%9B%E5%8E%9F%E5%9B%A0%E4%BB%8D%E4%B8%8D%E5%AD%98%E5%9C%A8%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5 fork 项目，替换ENV并推送自己的镜像。镜像构建通过github-actions完成。

我可以贡献吗？

是的，当然可以。

已经有很多ansible Docker镜像了，为什么还要创建一个新的？

在运行针对基础设施的关键代码时，我不信任其他人的镜像。如果您想使用此镜像，建议您 fork 它并构建自己的版本。有许多不错的替代方案，特别是https://github.com/William-Yeh/docker-ansible%EF%BC%8C%E4%BD%86%E6%88%91%E5%8F%91%E7%8E%B0%E5%AE%83%E4%BD%93%E7%A7%AF%E8%BE%83%E5%A4%A7%E6%88%96%E5%8A%9F%E8%83%BD%E8%BF%87%E5%A4%9A%E3%80%82%E6%AD%A4Docker%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8Ealpine%EF%BC%8C%E9%9D%9E%E5%B8%B8%E7%B2%BE%E7%AE%80%E5%B0%8F%E5%B7%A7 :)

此镜像如何部署到Docker Hub？

我使用https://github.com/features/actions%E3%80%82%E8%AF%B7%E5%8F%82%E8%A7%81https://github.com/gableroux/docker-ansible/tree/main/.github/workflows/

许可证

MIT © Gabriel Le Breton