7.2. 安装数据库驱动程序
数据库驱动程序作为红帽构建的 Keycloak 的一部分提供,但 Oracle Database 和 Micrsoft SQL Server 驱动程序需要单独安装。
如果要连接到其中一个数据库,请安装必要的驱动程序,如果您要连接到已经包含数据库驱动程序的不同数据库,请跳过此部分。
7.2.1. 安装 Oracle 数据库驱动程序
为红帽构建的 Keycloak 安装 Oracle Database 驱动程序:
从以下源之一下载
ojdbc11
和orai18n
JAR 文件:- 来自 Oracle 驱动程序下载页的 zip JDBC 驱动程序和Companion Jars 版本 23.3.0.23.09。
-
通过
ojdbc11
和orai18n
的 Maven Central。 - 数据库厂商推荐的安装介质用于使用的特定数据库。
-
运行解压缩的分发时:红帽构建的 Keycloak
供应商
文件夹中的ojdbc11
和orai18n
JAR 文件 运行容器: 构建自定义红帽构建的 Keycloak 镜像,并在
provider
文件夹中添加 JAR。为 Operator 构建自定义镜像时,这些镜像需要使用红帽构建的 Keycloak 集的所有构建时间选项优化镜像。用于构建可用于红帽构建的 Keycloak Operator 的最小 Dockerfile,并包括从 Maven Central 下载的 Oracle Database JDBC 驱动程序,如下所示:
FROM registry.redhat.io/rhbk/keycloak-rhel9:24 ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc11/23.3.0.23.09/ojdbc11-23.3.0.23.09.jar /opt/keycloak/providers/ojdbc11.jar ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/oracle/database/nls/orai18n/23.3.0.23.09/orai18n-23.3.0.23.09.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
如需了解如何构建优化镜像的详细信息,请参阅 容器章节中的 Running Red Hat build of Keycloak。
然后,按照下一节中所述继续配置数据库。
7.2.2. 安装 Microsoft SQL Server 驱动程序
为红帽构建的 Keycloak 安装 Microsoft SQL Server 驱动程序:
从以下源之一下载
mssql-jdbc
JAR 文件:- 从 Microsoft JDBC Driver for SQL Server 页面 下载版本。
-
通过
mssql-jdbc
的 Maven Central。 - 数据库厂商推荐的安装介质用于使用的特定数据库。
-
运行解压缩的分发时:红帽构建的 Keycloak
供应商
文件夹中的mssql-jdbc
运行容器: 构建自定义红帽构建的 Keycloak 镜像,并在
provider
文件夹中添加 JAR。当为红帽构建的 Keycloak Operator 构建自定义镜像时,需要使用红帽构建的 Keycloak 集的所有构建时选项优化镜像。构建可用于红帽构建的 Keycloak Operator 的最小 Dockerfile,并包括从 Maven Central 下载的 Microsoft SQL Server JDBC 驱动程序,如下所示:
FROM registry.redhat.io/rhbk/keycloak-rhel9:24 ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/12.4.2.jre11/mssql-jdbc-12.4.2.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
如需了解如何构建优化镜像的详细信息,请参阅 容器章节中的 Running Red Hat build of Keycloak。
然后,按照下一节中所述继续配置数据库。