更改数据集提供程序

本指南介绍了开发者如何对数据集提供程序进行本地修改。

概述

本指南面向 Java 开发者。

为了能够测试对提供程序所做的更改，需要将提供程序部署在 Keycloak 的运行实例中。 每次更改提供程序的 JAR 文件后，都需要将其重新部署到 Keycloak。

前提条件

需要具备 Java 和 Keycloak Java API 的知识，或需要在开发过程中学习。

推荐的设置是首先完成在 minikube 上 Keycloak 中安装数据集提供程序指南，因为它已完全脚本化并为远程调试做好准备。

也可以针对 Keycloak Wildfly 或在本地运行的 Keycloak Quarkus 实例开发提供程序，但这不属于今天的指南内容。

使用本地设置准备更改

在 IDE 中打开 Keycloak Benchmark 项目后，按如下步骤操作以实施新的或更改的需求

  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 Benchmark 项目后，按如下步骤操作以实施新的或更改的需求

  1. 根据需要更改 /dataset/src 中的源代码。

  2. 运行 在 minikube 上安装 中描述的 task 以更新安装。 这将构建数据集提供程序 JAR 文件的新版本，将其部署到 minikube 并重启 Keycloak。

  3. 按照调试 Keycloak 中的说明连接到正在运行的 Keycloak 实例并调试提供程序，并按照生成数据集中概述的方式测试提供程序的 API。

  4. 从步骤 1 重复操作，直到满足需求。