9.2. 安装数据库驱动程序
数据库驱动程序作为红帽构建的 Keycloak 的一部分提供,但 Oracle 数据库和 Microsoft SQL Server 驱动程序除外。
如果要连接到其中一个数据库,或者要连接到已包含数据库驱动程序的不同数据库,请手动安装缺少的驱动程序。
9.2.1. 安装 Oracle 数据库驱动程序
要为红帽构建的 Keycloak 安装 Oracle 数据库驱动程序:
从以下源之一下载
ojdbc11
和orai18n
JAR 文件:- 从 Oracle 驱动程序下载页面 zipped JDBC 驱动程序和 Companion Jars 版本 23.5.0.24.07。
-
通过
ojdbc11
和orai18n
的 Maven Central。 - 数据库厂商推荐的安装介质适用于使用的特定数据库。
-
在运行 unzipped 分发时:请参阅红帽构建的 Keycloak
提供程序
文件夹中的ojdbc11
和orai18n
JAR 文件 在运行容器时:构建自定义红帽构建的 Keycloak 镜像,并在
provider
文件夹中添加 JAR。在为 Operator 构建自定义镜像时,这些镜像需要使用红帽构建的 Keycloak 集合的所有构建时选项来优化镜像。构建可用于红帽构建的 Keycloak Operator 的镜像的最小 Containerfile,包括从 Maven Central 下载的 Oracle Database JDBC 驱动程序,如下所示:
FROM registry.redhat.io/rhbk/keycloak-rhel9:26 ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc11/23.5.0.24.07/ojdbc11-23.5.0.24.07.jar /opt/keycloak/providers/ojdbc11.jar ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/oracle/database/nls/orai18n/23.5.0.24.07/orai18n-23.5.0.24.07.jar /opt/keycloak/providers/orai18n.jar # Setting the build parameter for the database: ENV KC_DB=oracle # Add all other build parameters needed, for example enable health and metrics: ENV KC_HEALTH_ENABLED=true ENV KC_METRICS_ENABLED=true # To be able to use the image with the Red Hat build of Keycloak Operator, it needs to be optimized, which requires Red Hat build of Keycloak's build step: RUN /opt/keycloak/bin/kc.sh build
如需有关如何 构建优化镜像的详细信息,请参阅在容器中运行 Keycloak 的 Keycloak 部分。
然后,继续配置数据库,如下一节中所述。
9.2.2. 安装 Microsoft SQL Server 驱动程序
要为红帽构建的 Keycloak 安装 Microsoft SQL Server 驱动程序:
从以下源之一下载
mssql-jdbc
JAR 文件:- 从 用于 SQL Server 页的 Microsoft JDBC 驱动程序 下载版本。
-
通过
mssql-jdbc
Maven Central。 - 数据库厂商推荐的安装介质适用于使用的特定数据库。
-
在运行 unzipped 分发时:防止 Red Hat build of Keycloak 的
provider
folder 中的mssql-jdbc
在运行容器时:构建自定义红帽构建的 Keycloak 镜像,并在
provider
文件夹中添加 JAR。当为红帽构建的 Keycloak Operator 构建自定义镜像时,这些镜像需要使用红帽构建的 Keycloak 集合的所有构建时选项优化镜像。构建可用于红帽构建的 Keycloak Operator 的镜像的最小 Containerfile,包括从 Maven Central 下载的 Microsoft SQL Server JDBC 驱动程序,如下所示:
FROM registry.redhat.io/rhbk/keycloak-rhel9:26 ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/12.8.1.jre11/mssql-jdbc-12.8.1.jre11.jar /opt/keycloak/providers/mssql-jdbc.jar # Setting the build parameter for the database: ENV KC_DB=mssql # Add all other build parameters needed, for example enable health and metrics: ENV KC_HEALTH_ENABLED=true ENV KC_METRICS_ENABLED=true # To be able to use the image with the Red Hat build of Keycloak Operator, it needs to be optimized, which requires Red Hat build of Keycloak's build step: RUN /opt/keycloak/bin/kc.sh build
如需有关如何 构建优化镜像的详细信息,请参阅在容器中运行 Keycloak 的 Keycloak 部分。
然后,继续配置数据库,如下一节中所述。