搜索

7.2. 安装数据库驱动程序

download PDF

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

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

7.2.1. 安装 Oracle 数据库驱动程序

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

  1. 从以下源之一下载 ojdbc11orai18n JAR 文件:

    1. 来自 Oracle 驱动程序下载页的 zip JDBC 驱动程序和Companion Jars 版本 23.3.0.23.09。
    2. 通过 ojdbc11orai18n 的 Maven Central。
    3. 数据库厂商推荐的安装介质用于使用的特定数据库。
  2. 运行解压缩的分发时:红帽构建的 Keycloak 供应商 文件夹中的 ojdbc11orai18n JAR 文件
  3. 运行容器: 构建自定义红帽构建的 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 驱动程序:

  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: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

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

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.