Ansible 社区文档

在没有发布分支的情况下发布集合

由于未使用发布分支，因此本节不区分发布主要版本、次要版本或修补程序版本。

发布计划和公告 

检查集合以确定是否有已合并的更改需要发布。
根据所做的更改，选择合适的发布版本号。请记住，集合必须遵循语义版本控制规则。有关详细信息，请参阅集合版本控制和弃用。
在集合的相应固定发布问题或社区公告板上以及在community Matrix/IRC 频道中宣布你的发布意图。

创建发布分支 

确保你在本地 fork 中的默认分支中。在以下示例中，我们使用main。

git status
git checkout main     # if needed

更新你的本地 fork

git pull --rebase upstream main

从默认分支检出一个新的发布分支

git checkout -b release_branch

确保galaxy.yml包含正确的发布版本号。

生成变更日志 

添加一个变更日志片段changelogs/fragments/X.Y.Z.yml，内容如下：

release_summary: |-
  Write some text here that should appear as the release summary for this version.
  The format is reStructuredText, but not a list as for regular changelog fragments.
  This text will be inserted into the changelog.

例如：

release_summary: |-
  This is the minor release of the ``community.mysql`` collection.
  This changelog contains all changes to the modules and plugins in this collection
  that have been made after the previous release.

如果内容最近从另一个集合中移动（例如，将模块从一个集合迁移到另一个集合），请确保你在changelogs/fragments目录中拥有所有相关的变更日志片段。如果没有，请先复制它们。
运行antsibull-changelog release --reload-plugins。此软件包应使用pip install antsibull-changelog安装。
验证CHANGELOG.rst是否符合预期。
提交并将更改推送到CHANGELOG.rst和changelogs/changelog.yaml，以及可能已删除/归档的片段到origin存储库的release_branch。

git commit -a -m "Release VERSION commit"
git push origin release_branch

在集合存储库中创建一个 pull request。如果 CI 测试通过，请合并它。
检出默认分支并拉取更改

git checkout main
git pull --rebase upstream main

发布集合 

向发布提交添加一个带注释的标签，其中包含集合版本。将此标签推送到upstream存储库将使 Zuul 在Ansible Galaxy上发布该集合。

git tag -n    # see current tags and their comments
git tag -a NEW_VERSION -m "comment here"    # the comment can be, for example,  "community.postgresql: 1.2.0"
git push upstream NEW_VERSION

等待集合的新版本在Ansible Galaxy页面上发布。它将出现在可供下载的 tarball 列表中。
将galaxy.yml文件中的版本更新到下一个**预期**版本。添加到upstream的默认分支中，提交并推送。
为新标签添加一个 GitHub 发布。标题应为版本，内容为See https://github.com/ansible-collections/community.xxx/blob/main/CHANGELOG.rst for all changes。
通过Bullhorn 新闻通讯宣布发布。
在步骤 3 中提到的集合的固定发布问题/社区公告板上以及在community Matrix/IRC 频道中宣布发布。