變更資料集提供者

本指南說明開發人員如何對資料集提供者進行本地修改。

概觀

本指南的目標對象是 Java 開發人員。

為了能夠測試對提供者所做的變更,需要將提供者部署在 Keycloak 的執行實例中。每次變更提供者的 JAR 檔案後,都需要重新將其部署到 Keycloak。

先決條件

需要具備 Java 和 Keycloak Java API 的知識,或需要在開發期間學習。

建議的設定是先完成在 minikube 上 Keycloak 中安裝資料集提供者指南,因為它已完全腳本化並準備好進行遠端偵錯。

也可以針對 Keycloak Wildfly 或在本地執行的 Keycloak Quarkus 實例開發提供者,但目前這不屬於本指南的一部分。

使用本機設定準備變更

在 IDE 中開啟 Keycloak 效能基準測試專案後,請按照以下步驟實作新的或已變更的需求

  1. 根據需要在 /dataset/src 中變更原始程式碼。

  2. 從模組的檔案路徑,在 IDE 中啟動測試類別 DeploymentIT。它將封裝提供者並安裝到 Keycloak 的 Quarkus 實例中。

  3. 開啟 https://127.0.0.1:8080 與 Quarkus 互動,並使用遠端偵錯。

  4. 遠端偵錯可在 8787 連接埠上使用,並測試提供者的 REST API

  5. 從步驟 1 重複操作,直到滿足需求為止。

使用 Minikube 設定準備變更

在 IDE 中開啟 Keycloak 效能基準測試專案後,請按照以下步驟實作新的或已變更的需求

  1. 根據需要在 /dataset/src 中變更原始程式碼。

  2. 執行在 Minikube 上安裝中所述的 task 來更新安裝。這會建置新版本的資料集提供者 JAR 檔案,將其部署到 minikube 並重新啟動 Keycloak。

  3. 依照偵錯 Keycloak中的指示連線到正在執行的 Keycloak 實例並偵錯提供者,並測試產生資料集中所述的提供者 API。

  4. 從步驟 1 重複操作,直到滿足需求為止。