入门

欢迎并感谢加入 Ansible 社区。以下是一些入门方法。

社区行为准则

Community Code of Conduct

观点、见解、意见、技能组合和技能水平的多样性，可以增强每个社区的实力。然而，多样性也带来了潜在的意见分歧和沟通不畅。此《行为准则》的目的，是确保分歧和意见分歧以尊重的态度，就事论事地处理，避免人身攻击或其他可能造成不安全，或不受欢迎环境的行为。

这些政策并不是对 咱们不能做的事情 的全面规定。我们要求咱们以尊重和礼貌的态度，对待社区成员，总之， 不要做混蛋 。此《行为准则》在精神上和文字上都应遵守，但并非详尽无遗。

所有 Ansible 活动及其参与者，均受此《行为准则》与反骚扰政策的管辖。我们希望组织者在所有活动中，都要执行这些准则，我们也希望参与者、演讲者、赞助者和志愿者，帮助确保咱们整个社区的安全环境。具体而言，本《行为准则》涵盖了所有 Ansible 相关论坛和邮件列表、代码和文档贡献、公共聊天（Matrix、IRC）、私人通信和公共会议等的参与。

Ansible 的社区成员要：

细心

各种贡献都会产生深远的影响。正如咱们的工作会依赖于他人的工作一样，咱们为咱们对 Ansible 社区所做贡献方方面面的决定，也会影响咱们的社区成员。强烈建议咱们在做出这些决定时，考虑到这些后果。

耐心

即使在响应最快的社区中，异步交流也有其自身的挫折。请记住，我们的社区在很大程度上是依靠志愿者的时间建立起来的，而问题、贡献和支持请求，就可能需要一些时间才能收到答复。接二连三地重复 “问候” 或 “提醒” 不是耐心的好表现。此外，向特定的人提出一般性问题，被认为是不礼貌的行为。请向整个社区提出咱们的问题，并耐心等待回复。

尊重

每个社区都不可避免地会有分歧，但请记住，以尊重和礼貌的方式表示不认同是可行的。分歧绝不是粗鲁、敌意、威胁行为、辱骂（口头或肢体的），或人身攻击的借口。

亲切善良

无论他们的背景如何，每个人都应在 Ansible 社区中感到受欢迎。请礼貌待人，尊重社区成员。请勿发表或发布与技能水平、性别、性别认同或表达、性取向、残疾、外貌、体型、种族或宗教有关的攻击性言论。色情图片或图像、真实或暗示的暴力、恐吓、压迫、跟踪、持续干扰活动、未经明确许可发布他人个人信息、不受欢迎的身体接触和不受欢迎的性关注等都是严格禁止的。此外，我们鼓励咱们，不要对社区成员的背景或身份做出假设。

好奇心

唯一愚蠢的问题，便是未被问及的问题。我们鼓励我们的使用者早提问、勤提问。与其询问是否可以提问（答案总是当然可以！），不如直接提出咱们的问题。我们鼓励咱们提供尽可能多的具体信息。几乎总是需要以 Gists 形式或其他粘贴网站链接形式的代码片段，以便获得最有用的答案。要避免直接在聊天频道中粘贴多行代码，而是使用 gist.github.com 或其他粘贴网站，提供代码片段。

乐于助人

Ansible 社区致力于成为所有用户的一个友好环境，无论他们的技术水平如何。我们曾经都是初学者，如果没有一个让新用户感到安全和舒适的提问环境，我们的社区就无法成长。重复回答同样的问题可能会让人感到沮丧；但是，社区成员应礼貌相待，平等地帮助所有用户，而无论其技能或知识水平如何。要避免在回答问题时，将冷嘲热讽放在有用信息之上。同时，每个人都应通读所提供的文档。我们很乐意回答问题、提供战略指导并建议有效的工作流程，但我们不是来替你工作的。

反骚扰政策

所谓骚扰，包括（但不限于）所有以下行为：

与性别（包括性别表达和性别认同）、年龄、性取向、残疾、外貌、体型、种族及宗教等有关的冒犯性评论；
贬损性用语，包括众所周知的侮辱性词汇；
在公共场所张贴色情图片或图像；
蓄意恐吓；
跟踪；
未经明确许可发布他人个人信息；
持续干扰会谈或其他活动；
不适当的身体接触；
不受欢迎的性关注。

被要求停止任何骚扰行为的参与者，应立即遵守。赞助方同样要遵守该反骚扰政策。特别是，赞助方不得使用色情图片、活动或其他材料。Meetup 的组织人员和其他志愿组织者，不应在社区活动中使用色情服装或以其他方式营造色情环境。

除上面提及的行为外，在被要求停止后继续以某种方式行事，也构成骚扰，即使该行为在本政策中没有具体规定。在被要求停止行为后，停止行为是一种体贴和尊重，所有社区成员都应立即遵守此类要求。

违反政策

对于辱骂、骚扰或其他不可接受的行为，可以联系 codeofconduct@ansible.com、社区聊天室中任何有管理权限的人（Matrix 上的管理员或版主、IRC 上的操作员等），或活动的当地组织者进行报告。我们鼓励 Meetup 组织者在当地活动的显著位置，公布举报不可接受行为的联系方式。

如果某名参与者有骚扰行为，Meetup 组织者可以采取他们认为适当的任何行动。这些措施可能包括但不限于警告违规者、将违规者驱离活动现场，以及禁止违规者参加今后的社区活动。

组织者将很乐意帮助参与者，联系保安或当地执法部门，护送他们到其他地点，或以其他方式帮助那些受到骚扰的人，在 Meetup 期间感到安全。我们重视社区成员的安全和福祉，希望每个人都能在我们的活动中感受到欢迎，无论是在线还是离线。

我们希望所有参与者、组织者、演讲者和与会者，在所有活动场所及与活动相关的社交活动中，都遵守这些政策。

《Ansible 社区行为准则》采用 Creative Commons Attribute-Share Alike 3.0 许可协议进行许可。我们的行为准则改编自其他开源项目的行为准则，包括：

开发者溯源证书

Developer Certificate of Origin

为本项目做出贡献即表示您同意开发者溯源证书（the Developer Certificate of Origin，DCO）。该档由 Linux 内核社区创建，是一份简单的声明，表明作为贡献者，您拥有做出贡献的合法权利。详情请参见 DCO 文件。

与 Ansible 社区交流

行为准则

Ansible 社区中的所有交流和互动，都受咱们社区行为准则约束。请阅读并理解！

论坛

Ansible 论坛是个单一的起点，也是我们用于提问和帮助、开发讨论、活动等的默认交流平台。请注册加入社区。请按类别与标签检索，找到感兴趣的主题或开始一个新主题；只订阅咱们需要的主题！

请查看论坛群组，并加入符合咱们兴趣的群组。在大多数情况下，加入某个论坛群组就会自动给你订阅相关帖子。

Bullhorn 新闻通讯

Bullhorn 论坛上为 Ansible 贡献者社区发布的时事通讯，newsletter：

要订阅 Bullhorn，请单击 “Bullhorn” 类别描述下的 bell 按钮，然后单击 Watching；
要发布咱们新闻项目，请参阅 About the Newsletter category 帖子；
对时事通讯有疑问？请在 Matrix 上的 Ansible 社交会议室向我们提问。
区域及特定于语言的频道

若咱们觉得用英语以外的其他语言交流更方便，请参见国际社区论坛类别。目前有 Español（西班牙语）、Português（葡萄牙语）和 Norsk（挪威语）子类别。

有关如何申请某种语言的子类别等更多信息，请参阅 “关于国际社区类别” 帖子。

实时聊天

对于实时交互，Ansible 社区中的对话通过 Matrix 协议进行。

注意：论坛是我们默认的交流平台。在考虑 Matrix 等其他选项之前，请先加入论坛并与那里的社区取得联系。

随时加入某个频道，与其他爱好者聊天、参加工作组会议，或者只是打个招呼。要在 Matrix 上聊天，咱们需要：

一个 Matrix 账户（来自 Matrix.org 或任何其他 Matrix homeerver）；
一个 Matrix 客户端（推荐使用 Element Webchat）。

一般频道或工作组列表中的会议室链接，将直接将咱们带进相关会议室。

更多信息，请参阅社区托管 Matrix 常见问题。

使用 community-topics 软件源中的 Matrix 图标，Matrix shields，作模板，咱们可在咱们代码仓库的 README.md 中添加 Matrix 图标。

注意：IRC 频道不再当作官方交流通道。请使用论坛和 Matrix。

一般频道

以下这些可点击链接，可在浏览器中直接将你带进相关 Matrix 会议室；会议室/频道信息一并提供以其他客户端使用：

许多工作组都有专门的聊天频道。更多信息，请参阅工作组。

Matrix 上的会议

Ansible 社区会定期在 Matrix 上召开各种主题的会议，任何感兴趣的人都欢迎参加。有关 Ansible 会议的更多信息，请查看会议日程和议程页面。

工作组

工作组是 Ansible 社区成员，围绕感兴趣的特定主题自我组织的一种方式。

我们的社区工作组是以论坛群组形式表现的。请参阅这些链接，了解交流频道的完整列表。

申请论坛群组

要求成立新的工作组：

检视是否有咱们可以加入的合适论坛群组，而不是新建一个；
查看可以要求些什么，以表示对工作组的尊重；
在论坛话题区请求建立一个群组；
如果咱们还需要一个 Matrix 聊天频道，请参阅 Ansible Community Matrix FAQ。
申请建立社区专辑代码仓库

工作组通常是围绕某个 Ansible 社区专辑建立的。咱们可使用咱们组织下的某个代码仓库，或者通过在项目讨论类别与 coll-repo-request 标签下创建一个新话题，在论坛上申请一个 ansible-collections 下新的代码仓库。

Ansible 社区话题

Ansible 社区指导委员会使用论坛与社区进行异步讨论，并就社区主题进行投票。

更多信息，请参阅：

Ansible 自动化平台的支持问题

Red Hat 的 Ansible 自动化平台是一种订阅服务，包含 Ansible 的支持、认证内容和工具，包括内容管理、控制器、用户界面以及 REST API。

如果咱们有关于 Ansible 自动化平台的问题，请访问 Red Hat 支持页面，而不是使用社区交流平台。

我如何提供帮助？

感谢您有兴趣帮助 Ansible 项目！

有很多方法可以帮助 Ansible 项目...... 但首先，请阅读并理解社区行为准则。

成为一名资深用户

帮助 Ansible 项目的一个好方法，就是成为一名资深用户：

竭尽所能地在各处使用 Ansible；
参加辅导班和学习班；
阅读官方文档；
学习一些有关 Ansible 的优秀书籍；
获得认证。

咱们成为资深用户后，咱们以其他方式帮助 Ansible 项目的能力和机会，将迅速倍增。

在线提问及回答问题

有许多 Ansible 用户和贡献者在其上提问及回答问题的在线平台，包括论坛。请与咱们的 Ansible 爱好者交流吧。

咱们可以找到 Ansible 官方交流频道。

检查、修正和维护文档

即便在 Ansible 文档中，错别字也无处不在。我们（社区）努力更新文档，但咱们也可能发现一些过时的示例。我们提供了报告和/或修复文档错误的简便方法。

参与咱们当地的 Meetup

世界各地都有 Ansible Meetup。请加入咱们当地的 Meetup。定期参加。提出好问题。自愿介绍自己如何使用 Ansible。

如果你附近没有 Meetup，我们（社区）很乐意帮助您建立一个。

提交及验证问题

所有软件都有 bug，Ansible 也不例外。如果咱们发现了某个 bug，请告诉我们，这将对我们大有帮助：

提交 ansible-core 的 issue；
提交专辑的 issue。

若咱们发现的 bug 已经存在于某个 issue 中，咱们可通过以在该 issue 中添加注释，或报告任何额外信息，帮助验证该已报告 bug 的行为。

检查及提交拉取请求

当咱们逾加熟悉 Ansible 的原理时，咱们可能有能力自己修复问题或开发一些新功能。若咱们认为自己有办法修复 Ansible 中的某个 bug，或者咱们有新功能想与数百万 Ansible 用户分享，请阅读有关开发流程的全部内容，了解如何让 Ansible 接受咱们的代码。

咱们也可以从解决那些标有 easyfix 和 good_first_issue 标签的 GitHub issues 开始，包括：

Ansible 专辑；
全部其他 Ansible 项目。

当咱们选择某个要处理的 issue 时，请直接在该 GitHub issue 上添加评论，说明咱们正在处理该问题，让其他人知道，以避免工作冲突。如果有需要，咱们还可以在评论中寻求帮助。

对于专辑，请参阅 “创建您的第一个专辑拉取请求” 页面，了解如何快速设置本地环境、测试变更并提交可供审阅的拉取请求。

另一个提供帮助的好方法，是查看其他 Ansible 用户提交的拉取请求。Ansible Core 会按文件维护一个开放的拉取请求完整列表，因此如果咱们对某个模组或插件感兴趣，可以轻松跟踪所有相关的新拉取请求，并提供测试或反馈。或者，咱们也可以查看任何咱们感兴趣专辑的拉取请求。单击专辑文档页面上的 "Issue tracker"，即可找到该专辑的 issues 和 PR。

又一本 Ansible 教程

入门