從 CLI 執行效能基準測試

從任何主機對已佈建的 Keycloak 實例執行效能基準測試的通用命令列。

使用此選項對本機執行的 Keycloak 實例執行 Keycloak 效能基準測試。 當每秒對 Keycloak 的遠端實例執行超過 300 個新使用者時，由於 `TIME_WAIT` 模式下的大量網路連線，負載產生可能會停滯。 在這種情況下，請使用透過 Ansible 和 EC2 執行效能基準測試或類似機制，將負載產生分散到多個節點。

先決條件

  1. 來自準備 Keycloak 以進行測試的 Keycloak URL

  2. 或者下載效能基準測試模組，或者在本機建立它。

    若要按原樣執行測試而無需本機修改，建議選擇下載選項。

  3. 已安裝 Java 21，且 `java` 可執行檔可在路徑上使用。

從 CLI 執行測試

準備工作

執行測試

若要開始執行測試，請執行

./kcb.sh

依預設，測試預期 Keycloak 在 http://0.0.0.0:8080 上執行，而預設情境是 `keycloak.scenarion.authentication.ClientSecret`。

若要使用不同的伺服器 URL、Realm 和情境

./kcb.sh --scenario=keycloak.scenario.authentication.AuthorizationCode --server-url=https://keycloak-keycloak.192.168.12.345.nip.io --realm-name=test-realm

請參閱情境概述以取得所有可用情境及其設定選項的概述。

請參閱設定效能基準測試以設定不同的參數。

單次與增量執行模式

在單次執行模式下（這是預設模式），腳本會執行一次並在主控台上列印結果。

在增量模式下，由 CLI 選項 `--increment` 觸發，腳本會先執行一次效能基準測試作為預熱，然後再次執行，如果成功，則會重複執行，並根據參數中給定的值增加工作負載。 一旦效能基準測試在其中一個增量後失敗，腳本會執行額外的增量較小的執行，以找出可能成功的最大工作負載，並在主控台上列印此資訊。

報告

對於預設的 Gatling 產生報告，請查看 `result` 目錄中的報告。 如需其他報告，請參閱Keycloak 效能基準測試的報告。