検索

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

download PDF

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

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

9.2.1. Oracle データベースドライバーをインストールする

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

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

    1. Oracle ドライバーのダウンロードページ から、zip 形式の JDBC ドライバーおよび Companion Jars バージョン 23 1.5.24.07。
    2. Maven Central ( ojdbc11 および orai18n など)
    3. 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
  2. 展開済みのディストリビューションを実行する場合: ojdbc11 および 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
    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

    最適化されたイメージをビルドする方法の詳細は、コンテナーで 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
    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

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

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

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.