Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

9.2. データベースドライバーのインストール

データベースドライバーは、Oracle Database および Microsoft SQL Server ドライバーを除き、Red Hat build of Keycloak の一部として出荷されます。

これらのデータベースのいずれかに接続する場合は、不足している必要なドライバーを手動でインストールしてください。データベースドライバーがすでに含まれている別のデータベースに接続する場合は、このセクションをスキップしてください。

9.2.1. Oracle データベースドライバーをインストールする
リンクのコピー

Red Hat build of Keycloak 用の Oracle Database ドライバーをインストールするには、以下を実行します。

  1. 次のいずれかのソースから ojdbc17 および orai18n JAR ファイルをダウンロードします。

    1. Oracle ドライバーダウンロードページ の 圧縮された JDBC driver and Companion Jars バージョン 23.6.0.24.10。
    2. ojdbc17 および orai18n 経由の Maven Central。
    3. 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
  2. 展開した配布物を実行する場合: ojdbc17 および orai18n JAR ファイルを Red Hat build of Keycloak の providers フォルダーに配置します。

  3. コンテナーを実行する場合: カスタムの Red Hat build of Keycloak イメージをビルドし、providers フォルダーに JAR を追加します。Operator 用のカスタムイメージをビルドする場合、そのイメージは Red Hat build of Keycloak セットのすべてのビルド時オプションを使用して最適化されたイメージである必要があります。

    Red Hat build of Keycloak Operator で使用でき、Maven Central からダウンロードした Oracle Database JDBC ドライバーを含むイメージをビルドするための最小限の Containerfile は、次のようになります。 

    FROM registry.redhat.io/rhbk/keycloak-rhel9:26.2
ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc17/23.6.0.24.10/ojdbc17-23.6.0.24.10.jar /opt/keycloak/providers/ojdbc17.jar
ADD --chown=keycloak:keycloak --chmod=644 https://repo1.maven.org/maven2/com/oracle/database/nls/orai18n/23.6.0.24.10/orai18n-23.6.0.24.10.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
    Copy to Clipboard Toggle word wrap

    最適化されたイメージをビルドする方法の詳細は、コンテナーで Red Hat build of Keycloak を実行する の章を参照してください。

次のセクションの説明に従い、引き続きデータベースを設定します。

9.2.2. Microsoft SQL Server ドライバーをインストールする
リンクのコピー

Red Hat build of Keycloak 用の Microsoft SQL Server ドライバーをインストールするには、以下を実行します。

  1. 次のいずれかのソースから、mssql-jdbc JAR ファイルをダウンロードします。

    1. Microsoft JDBC Driver for SQL Server ページから、バージョンをダウンロードする。
    2. mssql-jdbc 経由の Maven Central。
    3. 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
  2. 展開済みのディストリビューションを実行している場合: mssql-jdbc を、Red Hat build of Keycloak の providers フォルダーに配置します。

  3. コンテナーを実行する場合: カスタムの Red Hat build of Keycloak イメージをビルドし、providers フォルダーに JAR を追加します。Red Hat build of Keycloak Operator のカスタムイメージをビルドする場合、それらのイメージは Red Hat build of Keycloak セットのすべてのビルド時オプションを使用して最適化されたイメージである必要があります。

    Red Hat build of Keycloak Operator で使用でき、Maven Central からダウンロードした Microsoft SQL Server JDBC ドライバーを含むイメージをビルドするための最小限の Containerfile は、次のようになります。 

    FROM registry.redhat.io/rhbk/keycloak-rhel9:26.2
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
    Copy to Clipboard Toggle word wrap

    最適化されたイメージをビルドする方法の詳細は、コンテナーで Red Hat build of Keycloak を実行する の章を参照してください。

次のセクションの説明に従い、引き続きデータベースを設定します。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat