9.2. データベースドライバーのインストール
データベースドライバーは、Oracle Database および Microsoft SQL Server ドライバーを除き、Keycloak の Red Hat ビルドの一部として同梱されます。
これらのデータベースのいずれかに接続する場合は手動で、必要なドライバーをインストールし、データベースドライバーがすでに含まれている別のデータベースに接続する場合はこのセクションを飛ばします。
9.2.1. Oracle データベースドライバーをインストールする
Red Hat build of Keycloak 用の Oracle Database ドライバーをインストールするには、以下を実行します。
次のいずれかのソースから、
ojdbc11
およびorai18n
JAR ファイルをダウンロードします。- Oracle ドライバーのダウンロードページ から、zip 形式の JDBC ドライバーおよび Companion Jars バージョン 23 1.5.24.07。
-
Maven Central (
ojdbc11
およびorai18n
など) - 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
-
展開済みのディストリビューションを実行する場合:
ojdbc11
およびorai18n
JAR ファイルを、Red Hat build of Keycloak のproviders
ファイルに配置します。 コンテナーを実行する場合: カスタムの 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 ドライバーをインストールするには、以下を実行します。
次のいずれかのソースから、
mssql-jdbc
JAR ファイルをダウンロードします。- Microsoft JDBC Driver for SQL Server ページから、バージョンをダウンロードする。
-
mssql-jdbc
を使用する Maven Central。 - 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
-
展開済みのディストリビューションを実行している場合:
mssql-jdbc
を、Red Hat build of Keycloak のproviders
フォルダーに配置します。 コンテナーを実行する場合: カスタムの 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 を実行する の章を参照してください。
次のセクションの説明に従い、引き続きデータベースを設定します。