23.3. 互換性のない変更のローリング
次の設定変更では、"Rolling Update is not possible" という結果コードが返されます。
23.3.1. 機能 リンクのコピーリンクがクリップボードにコピーされました!
23.3.1.1. 常に再作成する リンクのコピーリンクがクリップボードにコピーされました!
以下の機能を有効化または無効化する場合、再作成更新が必要です。
| 機能 | 説明 |
|---|---|
| multi-site:v1 | マルチサイトサポート |
| persistent-user-sessions:v1 | 再起動やアップグレード後もオンラインユーザーセッションが維持される |
23.3.1.2. 機能バージョンの変更時に再作成する リンクのコピーリンクがクリップボードにコピーされました!
以下の機能のバージョンを変更すると、再作成更新がトリガーされます。
| 機能 | 説明 |
|---|---|
| login:v1 | レガシーログインテーマ |
| login:v2 | 新しいログインテーマ |
| passkeys-conditional-ui-authenticator:v1 | Passkeys 条件付き UI オーセンティケーター |
23.3.2. 設定オプション リンクのコピーリンクがクリップボードにコピーされました!
以下のいずれかの CLI オプションの値を変更すると、再作成更新がトリガーされます。
| オプション | 理由 |
|---|---|
|
|
|
|
| 設定ファイルを変更すると、キャッシュまたはトランスポート設定に互換性がなくなり、クラスターが期待どおりに形成されなくなる可能性があります。 |
|
| スタックを変更すると、ローリング更新中にクラスターが形成されなくなり、データが失われます。 |
|
| TLS を有効化/無効化すると、ローリング更新中にクラスターが形成されなくなり、データが失われます。 |
|
| 新しいリモートキャッシュに接続すると、以前にキャッシュされたデータが失われます。 |
|
| 新しいリモートキャッシュに接続すると、以前にキャッシュされたデータが失われます。 |
Red Hat build of Keycloak は、--cache-config-file を介して提供されるキャッシュ設定ファイルの内容の変更を検証しません。このファイルを変更する場合は、新しい設定を使用するノードが古い設定を実行しているノードとクラスターを形成できることを確認するために、変更内容を確認してテストする必要があります。クラスターを形成できない場合は、新しい設定に移行する前に、まず古い設定を実行している Red Hat build of Keycloak をシャットダウンする必要があります。
| オプション | 理由 |
|---|---|
|
| データの一貫性を確保するために、新しいデータベースベンダーへの移行をすべてのクラスターメンバーに適用する必要があります。 |
|
| データの一貫性を確保するために、新しいデータベーススキーマへの移行をすべてのクラスターメンバーに適用する必要があります。 |
|
| データの一貫性を確保するために、新しいデータベース名への移行をすべてのクラスターメンバーに適用する必要があります。 |
|
| データの一貫性を確保するには、すべてのクラスターメンバーが同じデータベースに接続する必要があります。 |
|
| データの一貫性を確保するには、すべてのクラスターメンバーが同じデータベースに接続する必要があります。 |
Red Hat build of Keycloak では、JDBC プロパティーの変更を容易にするために、--db-url オプションの変更をロールアウトできます。ホスト、ポート、またはデータベース名を変更すると、異なるクラスターメンバーが別のデータベースに接続し、データの一貫性の問題が発生する可能性があるため、この値を更新するときは十分注意する必要があります。