7.2. データベースドライバーのインストール
データベースドライバーは、個別にインストールする必要がある Oracle Database ドライバーと Micrsoft SQL Server ドライバーを除き、Red Hat build of Keycloak に同梱されます。
これらのデータベースのいずれかに接続する場合は、必要なドライバーをインストールします。データベースドライバーがすでに含まれている別のデータベースに接続する場合は、このセクションをスキップしてください。
7.2.1. Oracle データベースドライバーをインストールする
Red Hat build of Keycloak 用の Oracle Database ドライバーをインストールするには、以下を実行します。
次のいずれかのソースから、
ojdbc11およびorai18nJAR ファイルをダウンロードします。- Oracle ドライバーのダウンロードページ の 圧縮された JDBC ドライバーと Companion Jars バージョン 23.3.0.23.09。
-
ojdbc11およびorai18n経由で Maven Central。 - 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
-
展開済みのディストリビューションを実行する場合:
ojdbc11およびorai18nJAR ファイルを、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 ドライバーを含むイメージをビルドするための最小限の Dockerfile は、次のようになります。
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
最適化されたイメージをビルドする方法の詳細は、コンテナーで Red Hat build of Keycloak を実行する の章を参照してください。
次のセクションの説明に従い、引き続きデータベースを設定します。
7.2.2. Microsoft SQL Server ドライバーをインストールする
Red Hat build of Keycloak 用の Microsoft SQL Server ドライバーをインストールするには、以下を実行します。
次のいずれかのソースから、
mssql-jdbcJAR ファイルをダウンロードします。- 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 ドライバーを含むイメージをビルドするための最小限の Dockerfile は、次のようになります。
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
最適化されたイメージをビルドする方法の詳細は、コンテナーで Red Hat build of Keycloak を実行する の章を参照してください。
次のセクションの説明に従い、引き続きデータベースを設定します。
