开发集合

集合是 Ansible 内容的一种分发格式。您可以使用集合打包和分发剧本、角色、模块和插件。一个典型的集合解决一组相关的用例。例如，cisco.ios 集合自动化了 Cisco IOS 设备的管理。

您可以创建一个集合并将其发布到Ansible Galaxy或私有自动化中心实例。您可以将认证的集合发布到 Red Hat Automation Hub，它是 Red Hat Ansible Automation Platform 的一部分。

查看Ansible 集合创建者路径，了解如何从创建集合到将其包含在 Ansible 包分发中的过程。

开发新的集合

• 创建集合
  • 命名你的集合
  • 创建一个新的集合
  • 从自定义模板创建集合
  • 使用 ansible-creator 创建集合
• 在集合中使用共享资源
  • 在集合中使用文档片段
  • 在集合中利用可选的模块实用程序
  • 列出集合依赖项
• 测试集合
  • 测试工具
• 分发集合
  • 分发服务器的初始配置
  • 构建你的集合 tarball
  • 准备发布你的集合
  • 发布你的集合
• 记录集合文档
  • 记录模块和插件
  • 记录角色
  • 验证你的集合文档
  • 使用 antsibull-docs 构建文档站点

使用现有集合

• 将 Ansible 内容迁移到不同的集合
  • 迁移内容
• 为集合贡献代码
  • 为集合贡献代码：community.general
• 在集合中生成变更日志和移植指南条目
  • 理解 antsibull-changelog
  • 将集合变更日志包含到 Ansible 中

集合参考

• 集合结构
  • 集合目录和文件
• 集合 Galaxy 元数据结构
  • 结构
  • 示例

有关开发模块的说明，请参阅开发模块。

另请参阅

使用 Ansible 集合

了解如何在剧本和角色中安装和使用集合

为 Ansible 维护的集合贡献代码

为选定集合贡献代码的指南

沟通

有问题？需要帮助？想分享你的想法？访问 Ansible 沟通指南