开发集合

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

您可以创建集合并将其发布到 Ansible Galaxy 或私有的 Automation Hub 实例中。您还可以将经过认证的集合发布到 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 通信指南