Ansible Documentation文档翻译

对于https://docs.ansible.com/ansible/latest/index.html网址的翻译，帮助自己更快上手，熟悉Ansible。

About Ansible

关于Ansible

Ansible is an IT automation tool. It can configure systems, deploy software, and orchestrate more advanced IT tasks such as continuous deployments or zero downtime rolling updates.
Ansible是IT自动化工具。它可以配置系统，部署软件，并且安排协调更多先进的IT任务，像持续部署或不停机滚动更新。

Ansible’s main goals are simplicity and ease-of-use. It also has a strong focus on security and reliability, featuring a minimum of moving parts, usage of OpenSSH for transport (with other transports and pull modes as alternatives), and a language that is designed around auditability by humans–even those not familiar with the program.
Ansible的主要目标是简明且易上手。同时也非常重视安全性和可靠性，特征有，最小化活动件，使用OpenSSH做传输（和其他传输工具与拉模式（当用户需要某些信息时，他们主动的提供者处获取）交替），并且用一种语言，这种语言被设计围绕于人们的可审计性，即使那些人们不熟悉程序

We believe simplicity is relevant to all sizes of environments, so we design for busy users of all types: developers, sysadmins, release engineers, IT managers, and everyone in between. Ansible is appropriate for managing all environments, from small setups with a handful of instances to enterprise environments with many thousands of instances.
我们坚信简单名了对所有规模的环境都有益，所以我们的设计面向于所有类型用户的：开发者，系统管理员，发布工程师，IT经理，和他们之间的每一个人。Ansible适用于管理所有环境，从带着一串实例的小公司到有上千个实例的企业环境。

Ansible manages machines in an agent-less manner. There is never a question of how to upgrade remote daemons or the problem of not being able to manage systems because daemons are uninstalled. Because OpenSSH is one of the most peer-reviewed open source components, security exposure is greatly reduced. Ansible is decentralized–it relies on your existing OS credentials to control access to remote machines. If needed, Ansible can easily connect with Kerberos, LDAP, and other centralized authentication management systems.
Ansible都是以无代理行为管理着机器。因为守护进程没有被安装，所以如何升级远程守护进程或者管理系统从来都不是问题所在。因为OpenSSH是最具经同行评议的开源组件，安全性爆光已大规模降低。Ansible是区中心化的，它依赖于你现存的操作系统凭证去控制远程机器的访问。如果有需要，Ansible可以轻易的与Kerberos，LDAP，以及其他去中心化认证的管理系统连接。

This documentation covers the version of Ansible noted in the upper left corner of this page. We maintain multiple versions of Ansible and of the documentation, so please be sure you are using the version of the documentation that covers the version of Ansible you’re using. For recent features, we note the version of Ansible where the feature was added.
这份文件涵括了本页面左上方提到的Ansible版本。我们会维护多种版本，所以请确认自己正在使用的文档涵盖了你正在使用的Ansible版本。在近期的专栏中，我们标出了我们新添加的Ansible版本。

Ansible releases a new major release of Ansible approximately three to four times per year. The core application evolves somewhat conservatively, valuing simplicity in language design and setup. However, the community around new modules and plugins being developed and contributed moves very quickly, adding many new modules in each release.
每年大概会发布3，4次Ansible的重大调试。核心应用的更新会比较谨慎，会比较重视语言设计和设置的简明性。然而，关于新模块和组件的社区发展更新很快，每次发布都会添加很多新模块。

Installation, Upgrade & Configuration

安装，更新和配置

• Installation Guide（安装向导）
  • Installing Ansible（Ansible安装）
  • Configuring Ansible（Ansible配置）
• Ansible Porting Guides（Ansible移植向导）
  • Ansible 2.9 Porting Guide
  • Ansible 2.8 Porting Guide
  • Ansible 2.7 Porting Guide
  • Ansible 2.5 Porting Guide
  • Ansible 2.4 Porting Guide
  • Ansible 2.3 Porting Guide
  • Ansible 2.0 Porting Guide

Using Ansible

使用

• User Guide（使用向导）
  • Ansible Quickstart Guide（Ansible快速开启向导）
  • Ansible concepts（Ansible概念）
  • Getting Started（开始）
  • How to build your inventory（如何建立你的库存）
  • Working with dynamic inventory（处理动态库存）
  • Patterns: targeting hosts and groups（模式：瞄准主机和组）
  • Introduction to ad-hoc commands（介绍ad-hoc命令）
  • Connection methods and details（连接方式和细节）
  • Working with command line tools（处理命令行工具）
  • Working With Playbooks（处理剧本）
  • Understanding privilege escalation: become（理解优先级升级：become）
  • Ansible Vault（Ansible电子仓库）
  • Working With Modules（处理组件）
  • Working With Plugins（处理插件）
  • Ansible and BSD（Ansible和BSD）
  • Windows Guides（窗口向导）
  • Using collections（使用集合）

Contributing to Ansible

贡献

• Ansible Community Guide（Ansible社区向导）
  • Getting started（开始）
  • Going deeper（深入了解）
  • Working with the Ansible repo（处理Ansible仓库）
  • Traditional Table of Contents（内容传统）

Extending Ansible

扩展

• Developer Guide（发展向导）
  • Adding modules and plugins locally（Ansible自行添加组建和插件）
  • Should you develop a module?（你应该发展一个组件吗）
  • Ansible module development: getting started（Ansible组件发展：开始）
  • Contributing your module to Ansible（贡献你的Ansible组件）
  • Conventions, tips, and pitfalls（惯例，要点，陷阱）
  • Ansible and Python 3（Ansible和python3）
  • Debugging modules（调试）
  • Module format and documentation（组件格式和文档）
  • Windows module development walkthrough（窗口组件发展历程）
  • Developing Cisco ACI modules（发展Cisco ACI 组件）
  • Guidelines for Ansible Amazon AWS module development（发展Amazon AWS组件Ansible手册）
  • OpenStack Ansible Modules（Ansible私有云组件）
  • oVirt Ansible Modules（Ansible组件oVirt）
  • Guidelines for VMware module development（虚拟机组件发展手册）
  • Information for submitting a group of modules（提交一组组件的信息）
  • Testing Ansible（Ansible测试）
  • The lifecycle of an Ansible module（Ansible组件的生命循环）
  • Developing plugins（发展插件）
  • Developing dynamic inventory（发展动态清单）
  • Developing the Ansible Core Engine（发展Ansible核心引擎）
  • Ansible module architecture（Ansible组件体系结构）
  • Python API（应用程序界面）
  • Rebasing a pull request（重设拉请求的基础）
  • Using and Developing Module Utilities（使用和发展组件实用程序）
  • Developing collections（发展集合）
  • Collection Galaxy metadata structure（收集元数据结构）
  • Ansible architecture（Ansible体系结构）

Common Ansible Scenarios

常见方案

• Public Cloud Guides（公有云向导）
• Network Technology Guides（网络技术向导）
• Virtualization and Containerization Guides（虚拟化和集装箱化向导）

Ansible for Network Automation

网络自动化

• Ansible for Network Automation（Ansible网络自动化）
  • Getting Started with Ansible for Network Automation（Ansible开始网络自动化）
  • Advanced Topics with Ansible for Network Automation（Ansible先进话题）
  • Developer Guide for Network Automation（发展向导）

Ansible Galaxy

星系

• Galaxy User Guide（星系用户向导）
  • Finding collections on Galaxy（寻找集合）
  • Installing collections（安装集合）
  • Finding roles on Galaxy（寻找角色）
  • Installing roles from Galaxy（安装角色）
• Galaxy Developer Guide（星系发展向导）
  • Creating collections for Galaxy（创造集合）
  • Creating roles for Galaxy（创造角色）

Reference & Appendices

参考和附录

• Module Index（组件指引）
• Playbook Keywords（剧本关键词）
• Return Values（返回值）
• Ansible Configuration Settings（Ansible配置设置）
• Controlling how Ansible behaves: precedence rules（Ansible控制行为：优先规则）
• YAML Syntax（YAML语法）
• Python 3 Support（Phyon3支持）
• Interpreter Discovery（解释器发现）
• Release and maintenance（发布和维护）
• Testing Strategies（测试策略）
• Sanity Tests（可用性测试）
• Frequently Asked Questions（常见问题）
• Glossary（术语）
• Ansible Reference: Module Utilities（Ansible参考：组件程序）
• Special Variables（特殊变量）
• Red Hat Ansible Tower（红帽Ansible塔）
• Logging Ansible output（记录Ansible输出）

Roadmaps

路线图

• Ansible Roadmap
  • Ansible 2.9
  • Ansible 2.8
  • Ansible 2.7
  • Ansible 2.6
  • Ansible 2.5
  • Ansible 2.4
  • Ansible 2.3
  • Ansible 2.2
  • Ansible 2.1