23.3. ローリング互換性のない変更
次の設定変更では、ローリング Update is not possible 結果コードが返されます。
23.3.1. 機能 リンクのコピーリンクがクリップボードにコピーされました!
23.3.1.1. Recreate always リンクのコピーリンクがクリップボードにコピーされました!
以下の機能を有効または無効にするには、再作成更新が必要です。
| 機能 | 説明 |
|---|---|
| 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 は、via-cache -config- file を介して提供されたキャッシュ設定ファイルの内容への変更を検証しません。このファイルを変更する場合は、変更を確認してテストし、新しい設定を使用してノードが古い設定を実行しているノードでクラスターを形成できるようにする必要があります。クラスターを形成できない場合は、新しい設定に移行する前に、古い設定を実行する前に、最初に古い設定を実行している Red Hat build of Keycloak をシャットダウンする必要があります。
| オプション | 理由 |
|---|---|
|
| 新規データベースベンダーへの移行は、データの整合性を確保するためにすべてのクラスターメンバーに適用する必要があります。 |
|
| 新規データベーススキーマへの移行は、データの整合性を確保するためにすべてのクラスターメンバーに適用する必要があります。 |
|
| データの一貫性を確保するために、新規データベース名をすべてのクラスターメンバーに適用する必要があります。 |
|
| すべてのクラスターメンバーは、データの一貫性を確保するために同じデータベースに接続する必要があります。 |
|
| すべてのクラスターメンバーは、データの一貫性を確保するために同じデータベースに接続する必要があります。 |
Red Hat build of Keycloak では、JDBC プロパティーの変更を容易にするために、--db-url オプションへの変更をロールアウトできます。ホスト、ポート、またはデータベース名を変更すると、個別のクラスターメンバーが別のデータベースに接続し、データの一貫性の問題が発生する可能性があります。