9.2. データベースドライバーのインストール
データベースドライバーは、Oracle Database および Microsoft SQL Server ドライバーを除き、Red Hat build of Keycloak の一部として出荷されます。
これらのデータベースのいずれかに接続する場合は、不足している必要なドライバーを手動でインストールしてください。データベースドライバーがすでに含まれている別のデータベースに接続する場合は、このセクションをスキップしてください。
組み込みデータベースドライバーをオーバーライドしたり、独自のドライバーを提供したりすることは、サポート対象外と見なされます。サポートされている唯一の例外は、Oracle Database ドライバーのように、このガイドに明示的に文書化されているものです。
9.2.1. Oracle データベースドライバーをインストールする リンクのコピーリンクがクリップボードにコピーされました!
Red Hat build of Keycloak 用の Oracle Database ドライバーをインストールするには、以下を実行します。
次のいずれかのソースから
ojdbc17およびorai18nJAR ファイルをダウンロードします。- Oracle ドライバーダウンロードページ の 圧縮された JDBC driver and Companion Jars バージョン 23.6.0.24.10。
-
ojdbc17およびorai18n経由の Maven Central。 - 使用しているデータベースのデータベースベンダーが推奨するインストールメディア。
-
展開した配布物を実行する場合:
ojdbc17および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 ドライバーを含むイメージをビルドするための最小限の Containerfile は、次のようになります。
FROM registry.redhat.io/rhbk/keycloak-rhel9:26.4 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最適化されたイメージをビルドする方法の詳細は、コンテナー内での Red Hat build of Keycloak の実行 の章を参照してください。
次のセクションの説明に従い、引き続きデータベースを設定します。