ansible/ansible

来源：https://github.com/ansible/ansible

PyPI 版本 (https://pypi.org/project/ansible-core) 文档徽章 (https://docs.ansible.com/ansible/latest/) 聊天徽章 (https://docs.ansible.com/ansible/devel/community/communication.html#real-time-chat) Ansible 论坛 (https://docs.ansible.com/ansible/devel/community/communication.html#forum) 构建状态 (https://dev.azure.com/ansible/ansible/_build/latest?definitionId=20&branchName=devel) Ansible 行为准则 (https://docs.ansible.com/ansible/devel/community/code_of_conduct.html) 仓库许可证 Ansible CII 最佳实践认证 (https://bestpractices.coreinfrastructure.org/projects/2372)

Ansible

Ansible 是一个极其简单的 IT 自动化系统。它处理配置管理、应用程序部署、云资源调配、临时任务执行、网络自动化和多节点编排。Ansible 让复杂的变更，如带负载均衡器的零停机滚动更新，变得简单。更多信息请访问 Ansible 网站 (https://ansible.com/)。

设计原则

• 拥有极其简单的设置过程，学习曲线最小化。
• 快速并行管理机器。
• 避免使用自定义代理和额外开放端口，通过利用现有的 SSH 守护进程实现无代理。
• 用既对机器友好也对人类友好的语言描述基础设施。
• 注重安全以及内容的易审计、易审查和易重写。
• 即时管理新远程机器，无需引导任何软件。
• 允许使用任何动态语言（不仅仅是 Python）开发模块。
• 支持非 root 用户使用。
• 成为有史以来最易用的 IT 自动化系统。

使用 Ansible

你可以通过 pip 或包管理器安装已发布的 Ansible 版本。有关在各种平台上安装 Ansible 的详细信息，请参阅我们的安装指南 (https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html)。

高级用户和开发者可以直接运行 devel 分支，该分支包含最新的功能和修复。虽然它相当稳定，但运行 devel 分支更可能遇到突破性变更。如果你想运行 devel 分支，我们建议你参与 Ansible 社区。

沟通

加入 Ansible 论坛提问、获取帮助并与社区互动。

• 获取帮助 (https://forum.ansible.com/c/help/6)：寻找帮助或分享你的 Ansible 知识以帮助他人。使用标签过滤和订阅帖子，例如：
  • 标记为 ansible (https://forum.ansible.com/tag/ansible) 的帖子
  • 标记为 ansible-core (https://forum.ansible.com/tag/ansible-core) 的帖子
  • 标记为 playbook (https://forum.ansible.com/tag/playbook) 的帖子
• 社交空间 (https://forum.ansible.com/c/chat/4)：结识并与同行爱好者互动。
• 新闻与公告 (https://forum.ansible.com/c/news/5)：关注包括社交活动在内的项目范围公告。
• Bullhorn 通讯 (https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn)：获取发布公告和重要变更。

更多联系方式，请参见与 Ansible 社区沟通 (https://docs.ansible.com/ansible/devel/community/communication.html)。

为 Ansible 做贡献

• 查看贡献者指南 (https://github.com/ansible/ansible/blob/devel/.github/CONTRIBUTING.md)。
• 阅读社区信息 (https://docs.ansible.com/ansible/devel/community)，了解各种为项目做贡献和互动的方式，包括如何向 Ansible 提交错误报告和代码。
• 通过向 devel 分支提交拉取请求来提交建议的代码更新。
• 在进行较大更改前先与我们沟通，以避免重复工作。这不仅有助于每个人了解进展，而且在决定需要一些更改时也能节省时间和精力。

编码指南

有关 ansible-core 的开发上下文可在 context 目录中找到。

我们还在开发者指南 (https://docs.ansible.com/ansible/devel/dev_guide/) 中记录了编码指南。我们特别建议你查看：

• 向 Ansible 贡献你的模块 (https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_checklist.html)
• 约定、技巧和陷阱 (https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_best_practices.html)

分支信息

• devel 分支对应正在积极开发中的版本。
• stable-2.X 分支对应稳定发布版本。
• 如果你想打开拉取请求，请基于 devel 创建分支并设置开发环境 (https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_general.html#common-environment-setup)。
• 请参阅 Ansible 发布与维护 (https://docs.ansible.com/ansible/devel/reference_appendices/release_and_maintenance.html) 页面了解活动分支信息。

路线图

根据团队和社区反馈，主要或次要版本（例如 2.7, 2.8）的初步路线图将会发布。Ansible 路线图页面 (https://docs.ansible.com/ansible/devel/roadmap/) 详细说明了计划内容以及如何影响路线图。

作者

Ansible 由 Michael DeHaan (https://github.com/mpdehaan) 创建，并拥有来自超过 5000 名用户（且还在增长）的贡献。感谢大家！

本项目主要由人类编写代码。

Ansible (https://www.ansible.com) 由 Red Hat, Inc. (https://www.redhat.com) 赞助。

许可证

GNU 通用公共许可证 v3.0 或更高版本

参见 COPYING 以查看完整文本。