Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

7.2. 安装数据库驱动程序

数据库驱动程序作为红帽构建的 Keycloak 的一部分提供，但 Oracle Database 和 Micrsoft SQL Server 驱动程序需要单独安装。

如果要连接到其中一个数据库，请安装必要的驱动程序，如果您要连接到已经包含数据库驱动程序的不同数据库，请跳过此部分。

7.2.1. 安装 Oracle 数据库驱动程序
复制链接

为红帽构建的 Keycloak 安装 Oracle Database 驱动程序：

  1. 从以下源之一下载 ojdbc11 和 orai18n JAR 文件：

    1. 来自 Oracle 驱动程序下载页面 的 zip JDBC 驱动程序和Companion Jars 版本 23.2.0.0。
    2. 通过 ojdbc11 和 orai18n 的 Maven Central。
    3. 数据库厂商推荐的安装介质用于使用的特定数据库。
  2. 运行解压缩的分发时：红帽构建的 Keycloak 供应商 文件夹中的 ojdbc11 和 orai18n JAR 文件

  3. 运行容器： 构建自定义红帽构建的 Keycloak 镜像，并在 provider 文件夹中添加 JAR。为 Keycloak Operator 构建自定义镜像时，这些镜像需要优化镜像，并包含 Keycloak 集的所有构建时间选项。

    用于构建可用于红帽构建的 Keycloak Operator 的最小 Dockerfile，并包括从 Maven Central 下载的 Oracle Database JDBC 驱动程序，如下所示： 

    FROM registry.redhat.io/rhbk/keycloak-rhel9:22
ADD --chown=keycloak:keycloak https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc11/23.2.0.0/ojdbc11-23.2.0.0.jar /opt/keycloak/providers/ojdbc11.jar
ADD --chown=keycloak:keycloak https://repo1.maven.org/maven2/com/oracle/database/nls/orai18n/23.2.0.0/orai18n-23.2.0.0.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 {project_name} Operator, it needs to be optimized, which requires {project_name}'s build step:
RUN /opt/keycloak/bin/kc.sh build
    Copy to Clipboard Toggle word wrap

    如需了解如何构建优化镜像的详细信息，请参阅 容器章节中的 Running Red Hat build of Keycloak。

然后，按照下一节中所述继续配置数据库。

7.2.2. 安装 Microsoft SQL Server 驱动程序
复制链接

为红帽构建的 Keycloak 安装 Microsoft SQL Server 驱动程序：

  1. 从以下源之一下载 mssql-jdbc JAR 文件：

    1. 从 Microsoft JDBC Driver for SQL Server 页面 下载版本。
    2. 通过 mssql-jdbc 的 Maven Central。
    3. 数据库厂商推荐的安装介质用于使用的特定数据库。
  2. 运行解压缩的分发时：红帽构建的 Keycloak 供应商 文件夹中的 mssql-jdbc

  3. 运行容器： 构建自定义红帽构建的 Keycloak 镜像，并在 provider 文件夹中添加 JAR。当为红帽构建的 Keycloak Operator 构建自定义镜像时，需要使用红帽构建的 Keycloak 集的所有构建时选项优化镜像。

    构建可用于红帽构建的 Keycloak Operator 的最小 Dockerfile，并包括从 Maven Central 下载的 Microsoft SQL Server JDBC 驱动程序，如下所示： 

    FROM registry.redhat.io/rhbk/keycloak-rhel9:22
ADD --chown=keycloak:keycloak https://repo1.maven.org/maven2/com/microsoft/sqlserver/mssql-jdbc/12.2.0.jre11/mssql-jdbc-12.2.0.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 {project_name} Operator, it needs to be optimized, which requires {project_name}'s build step:
RUN /opt/keycloak/bin/kc.sh build
    Copy to Clipboard Toggle word wrap

    如需了解如何构建优化镜像的详细信息，请参阅 容器章节中的 Running Red Hat build of Keycloak。

然后，按照下一节中所述继续配置数据库。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat