发布新版本

当我们对 Keycloak 版本进行一个或多个破坏向后兼容性的更改时，我们将发布新版本的 Keycloak 基准测试。这些更改通常发生在“数据集”提供者中，但并不限于此。

发布步骤

确保所有必要内容已提交并推送到 https://github.com/keycloak/keycloak-benchmark 的 main 分支。在您本地机器上的 main 分支的 HEAD 上，创建一个新的发布分支，其签名为 0.XX-release，例如 0.13-release。在这个发布分支中，进行以下一系列更新以升级版本，这些更新是 Keycloak 基准测试的 SNAPSHOT 版本发布成功的必要条件。
在 Snapshot 发布 GitHub 工作流 YAML 的 --notes 'Latest version built from 中更新 Keycloak 的最新支持版本，使用类似于 <br>Use this with Keycloak 25.x 的行。这将被 Snapshot GitHub 工作流进一步使用，以创建快照版本并用特定的 Keycloak 版本标记工件。
现在，对整个项目进行搜索，查找以下关键字，并根据发布情况将它们替换为相应的关键字。
- 搜索 nightly 并将其替换为 25.0.1，如果发布针对的是 Keycloak 25.0.1 构建。
- 搜索 keycloak-999.0.0-SNAPSHOT 并将其替换为 keycloak-25.0.1，如果发布针对的是 Keycloak 25.0.1 构建。
现在将您的更改从本地 XX-release 分支推送到远程 XX-release 分支，这将生成 SNAPSHOT 发布所需的特定工件。

一旦 release 分支被切断，SNAPSHOT 版本成功生成了其工件，请在 main 分支上执行以下步骤，将新的更改传播到更新的 SNAPSHOT 版本。虽然这些发布后步骤必须手动执行，但我们希望在未来将其自动化到单点击发布工作流程中。
在以下文件中的所有位置升级到新的 SNAPSHOT 版本。例如，在执行 0.13-SNAPSHOT 发布后，在以下文件中的搜索 0.13-SNAPSHOT 关键字并将其替换为下一个逻辑版本号，在本例中为 0.14-SNAPSHOT。
- Keycloak 基准测试 ROOT
  - pom.xml.
- 基准测试模块
  - benchmark/pom.xml.
  - antora.yml 文件在基准测试文档下。
  - ROSA 基准测试关键结果页面。
  - 使用 Ansible 运行基准测试页面。
- 数据集模块
  - dataset/pom.xml.
  - KeycloakServer.java 更新默认的 project_version。
  - antora.yml 文件在数据集文档下。
- Kubernetes 模块
  - pom.xml 用于 ROSA 跨数据中心功能测试。
  - antora.yml 文件在 Kubernetes 文档下。
- Ansible 模块
  - ansible/env_example.yml.
  - ansible/env_rosa_benchmark.yml.
一旦所有更改到位，请将它们提交到 main 分支，并附上一个好的提交消息，表明项目现在已升级到更新的 SNAPSHOT 版本。