9.2. 安装数据库驱动程序


数据库驱动程序作为红帽构建的 Keycloak 的一部分提供,但 Oracle 数据库和 Microsoft SQL Server 驱动程序除外。

如果要连接到其中一个数据库,或者要连接到已包含数据库驱动程序的不同数据库,请手动安装缺少的驱动程序。

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

要为红帽构建的 Keycloak 安装 Oracle 数据库驱动程序:

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

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

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

    1. 用于 SQL Server 页的 Microsoft JDBC 驱动程序 下载版本。
    2. 通过 mssql-jdbc Maven Central。
    3. 数据库厂商推荐的安装介质适用于使用的特定数据库。
  2. 在运行 unzipped 分发时:防止 Red Hat build of Keycloak 的 provider folder 中的 mssql-jdbc
  3. 在运行容器时:构建自定义红帽构建的 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 部分。

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

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.