發布新版本

當我們針對先前版本的 Keycloak 發行版進行一項或多項不相容的回溯相容性變更時,我們將發布新版本的 Keycloak 效能基準測試。這些變更通常在「資料集」提供者中,但不限於此。

發布步驟

  1. 請確保所有需要的內容都已提交並推送至 https://github.com/keycloak/keycloak-benchmark 中的 main 分支。從 main 分支的 HEAD 本機端,建立一個新的發布分支,簽章為 0.XX-release,例如 0.13-release。在該發布分支中,進行以下一系列更新,以升級 Keycloak 效能基準測試的 SNAPSHOT 版本所需的版本。

  2. Snapshot 發布 GitHub 工作流程 YAML 中更新 Keycloak 的最新支援版本,在 --notes 'Latest version built from 中添加類似 <br>Use this with Keycloak 25.x 的行。這會進一步由 Snapshot GitHub 工作流程使用,以建立快照發行版,並在成品上印上特定的 Keycloak 發行版。

  3. 現在,針對以下關鍵字執行專案範圍的搜尋,並根據發行版將其替換為各自的關鍵字。

    • 搜尋 nightly 並將其替換為 25.0.1,如果發行版是針對 Keycloak 25.0.1 建置的。

    • 搜尋 keycloak-999.0.0-SNAPSHOT 並將其替換為 keycloak-25.0.1,如果發行版是針對 Keycloak 25.0.1 建置的。

  4. 現在,將您本機 XX-release 分支中的變更推送至遠端 XX-release 分支,這反過來會產生 SNAPSHOT 發行版所需的特定成品。

發布後步驟

  1. 一旦 release 分支被切出,且 SNAPSHOT 發行版成功產生其成品,請針對 main 分支執行以下步驟,以便將新變更傳播到較新的 SNAPSHOT 版本中。雖然這些發布後步驟必須手動執行,但我們希望在未來將其自動化為單次點擊的發布工作流程。

  2. 在以下檔案中的所有位置升級至新的 SNAPSHOT 版本。例如,在執行 0.13-SNAPSHOT 發行版後,請在以下檔案中搜尋 0.13-SNAPSHOT 關鍵字,並將其替換為下一個邏輯版本號,在此例中為 0.14-SNAPSHOT

  3. 一旦所有變更都已就位,請將這些變更提交至 main 分支,並使用良好的提交訊息,以表明專案現在已升級至較新的 SNAPSHOT 版本。