Ansible / Ansible

Ansible is a radically simple IT automation system. It handles configuration management, application deployment, cloud provisioning, ad-hoc task execution, network automation, and multi-node orchestration. Ansible makes complex changes like zero-downtime rolling updates with load balancers easy. More information on the Ansible website.

Ansible 是一个极其简单的 IT 自动化系统。它能够处理配置管理、应用部署、云资源配置、临时任务执行、网络自动化以及多节点编排。Ansible 让复杂的变更（如配合负载均衡器实现零停机滚动更新）变得轻而易举。更多信息请访问 Ansible 官网。

Design Principles

设计原则

• Have an extremely simple setup process with a minimal learning curve.

• 拥有极其简单的设置流程，学习曲线极低。

• Manage machines quickly and in parallel.

• 快速且并行地管理机器。

• Avoid custom-agents and additional open ports, be agentless by leveraging the existing SSH daemon.

• 避免使用自定义代理和额外的开放端口，通过利用现有的 SSH 守护进程实现无代理（agentless）架构。

• Describe infrastructure in a language that is both machine and human friendly.

• 使用一种既对机器友好又对人类可读的语言来描述基础设施。

• Focus on security and easy auditability/review/rewriting of content.

• 专注于安全性，并确保内容易于审计、审查和重写。

• Manage new remote machines instantly, without bootstrapping any software.

• 无需引导任何软件，即可立即管理新的远程机器。

• Allow module development in any dynamic language, not just Python.

• 允许使用任何动态语言（不仅限于 Python）进行模块开发。

• Be usable as non-root.

• 支持以非 root 用户身份使用。

• Be the easiest IT automation system to use, ever.

• 成为有史以来最易用的 IT 自动化系统。

Use Ansible

使用 Ansible

You can install a released version of Ansible with pip or a package manager. See our installation guide for details on installing Ansible on a variety of platforms. Power users and developers can run the devel branch, which has the latest features and fixes, directly. Although it is reasonably stable, you are more likely to encounter breaking changes when running the devel branch. We recommend getting involved in the Ansible community if you want to run the devel branch.

你可以通过 pip 或包管理器安装 Ansible 的发布版本。有关在各种平台上安装 Ansible 的详细信息，请参阅我们的安装指南。高级用户和开发者可以直接运行包含最新功能和修复的 devel 分支。虽然该分支相对稳定，但在运行 devel 分支时，你更有可能遇到破坏性变更。如果你希望使用 devel 分支，我们建议你积极参与 Ansible 社区。

Communication

交流

Join the Ansible forum to ask questions, get help, and interact with the community. Get Help: Find help or share your Ansible knowledge to help others. Use tags to filter and subscribe to posts, such as the following: Posts tagged with ansible, Posts tagged with ansible-core, Posts tagged with playbook. Social Spaces: Meet and interact with fellow enthusiasts. News & Announcements: Track project-wide announcements including social events. Bullhorn newsletter: Get release announcements and important changes. For more ways to get in touch, see Communicating with the Ansible community.

加入 Ansible 论坛以提问、获取帮助并与社区互动。获取帮助：寻找帮助或分享你的 Ansible 知识以帮助他人。使用标签来过滤和订阅帖子，例如：带有 ansible 标签的帖子、带有 ansible-core 标签的帖子、带有 playbook 标签的帖子。社交空间：结识并与志同道合的爱好者互动。新闻与公告：跟踪项目范围内的公告，包括社交活动。Bullhorn 时事通讯：获取发布公告和重要变更。如需了解更多联系方式，请参阅“与 Ansible 社区交流”。

Contribute to Ansible

为 Ansible 做出贡献

Check out the Contributor’s Guide. Read Community Information for all kinds of ways to contribute to and interact with the project, including how to submit bug reports and code to Ansible. Submit a proposed code update through a pull request to the devel branch. Talk to us before making larger changes to avoid duplicate efforts. This not only helps everyone know what is going on, but it also helps save time and effort if we decide some changes are needed.

查看《贡献者指南》。阅读《社区信息》以了解为项目做出贡献和互动的各种方式，包括如何提交错误报告和代码。通过向 devel 分支提交 Pull Request 来提议代码更新。在进行重大更改之前请先与我们沟通，以避免重复劳动。这不仅能让大家了解项目进展，还能在我们认为需要进行某些更改时节省时间和精力。

Coding Guidelines

编码规范

Development context for ansible-core can be found in the context directory. We also document our Coding Guidelines in the Developer Guide. We particularly suggest you review: Contributing your module to Ansible, Conventions, tips, and pitfalls.

ansible-core 的开发上下文可以在 context 目录中找到。我们还在《开发者指南》中记录了我们的编码规范。我们特别建议你查阅：向 Ansible 贡献模块、约定、技巧和陷阱。

Branch Info

分支信息

The devel branch corresponds to the release actively under development. The stable-2.X branches correspond to stable releases. Create a branch based on devel and set up a dev environment if you want to open a PR. See the Ansible release and maintenance page for information about active branches.

devel 分支对应于当前正在开发中的版本。stable-2.X 分支对应于稳定版本。如果你想提交 PR，请基于 devel 分支创建分支并设置开发环境。有关活跃分支的信息，请参阅 Ansible 发布与维护页面。

Roadmap

路线图

Based on team and community feedback, an initial roadmap will be published for a major or minor version (ex: 2.7, 2.8). The Ansible Roadmap page details what is planned and how to influence the roadmap.

根据团队和社区的反馈，我们将为主要或次要版本（例如：2.7, 2.8）发布初步路线图。Ansible 路线图页面详细说明了计划内容以及如何影响路线图。

Authors

作者

Ansible was created by Michael DeHaan and has contributions from over 5000 users (and growing). Thanks everyone! This project is substantially coded by humans. Ansible is sponsored by Red Hat, Inc.

Ansible 由 Michael DeHaan 创建，并拥有超过 5000 名用户的贡献（且人数还在增加）。感谢大家！本项目主要由人类编写代码。Ansible 由 Red Hat, Inc. 赞助。

License

许可证

GNU General Public License v3.0 or later. See COPYING to see the full text.

GNU 通用公共许可证 v3.0 或更高版本。请参阅 COPYING 查看全文。