23.3. 互換性のない変更のローリング


次の設定変更では、"Rolling Update is not possible" という結果コードが返されます。

23.3.1. 機能

23.3.1.1. 常に再作成する

以下の機能を有効化または無効化する場合、再作成更新が必要です。

Expand
機能説明

multi-site:v1

マルチサイトサポート

persistent-user-sessions:v1

再起動やアップグレード後もオンラインユーザーセッションが維持される

23.3.1.2. 機能バージョンの変更時に再作成する

以下の機能のバージョンを変更すると、再作成更新がトリガーされます。

Expand
機能説明

login:v1

レガシーログインテーマ

login:v2

新しいログインテーマ

passkeys-conditional-ui-authenticator:v1

Passkeys 条件付き UI オーセンティケーター

23.3.2. 設定オプション

以下のいずれかの CLI オプションの値を変更すると、再作成更新がトリガーされます。

Expand
表23.1 Cache
オプション理由

--cache

ispnlocal 設定は相互に排他的であり、一方から他方へ変更するとデータが失われます。

--cache-config-file

設定ファイルを変更すると、キャッシュまたはトランスポート設定に互換性がなくなり、クラスターが期待どおりに形成されなくなる可能性があります。

--cache-stack

スタックを変更すると、ローリング更新中にクラスターが形成されなくなり、データが失われます。

--cache-embedded-mtls-enabled

TLS を有効化/無効化すると、ローリング更新中にクラスターが形成されなくなり、データが失われます。

--cache-remote-host

新しいリモートキャッシュに接続すると、以前にキャッシュされたデータが失われます。

--cache-remote-port

新しいリモートキャッシュに接続すると、以前にキャッシュされたデータが失われます。

警告

Red Hat build of Keycloak は、--cache-config-file を介して提供されるキャッシュ設定ファイルの内容の変更を検証しません。このファイルを変更する場合は、新しい設定を使用するノードが古い設定を実行しているノードとクラスターを形成できることを確認するために、変更内容を確認してテストする必要があります。クラスターを形成できない場合は、新しい設定に移行する前に、まず古い設定を実行している Red Hat build of Keycloak をシャットダウンする必要があります。

Expand
表23.2 データベース
オプション理由

--db

データの一貫性を確保するために、新しいデータベースベンダーへの移行をすべてのクラスターメンバーに適用する必要があります。

--db-schema

データの一貫性を確保するために、新しいデータベーススキーマへの移行をすべてのクラスターメンバーに適用する必要があります。

--db-url-database

データの一貫性を確保するために、新しいデータベース名への移行をすべてのクラスターメンバーに適用する必要があります。

--db-url-host

データの一貫性を確保するには、すべてのクラスターメンバーが同じデータベースに接続する必要があります。

--db-url-port

データの一貫性を確保するには、すべてのクラスターメンバーが同じデータベースに接続する必要があります。

警告

Red Hat build of Keycloak では、JDBC プロパティーの変更を容易にするために、--db-url オプションの変更をロールアウトできます。ホスト、ポート、またはデータベース名を変更すると、異なるクラスターメンバーが別のデータベースに接続し、データの一貫性の問題が発生する可能性があるため、この値を更新するときは十分注意する必要があります。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat