Docker版DocSearchで暗号鍵やプラグインを compose.override.yaml に置いている場合、起動や更新のコマンドでどのファイルを読み込むかに注意が必要です。docker-docsearchのREADMEが修正されました。Composeのファイル選択は既存環境にも該当し、既定の鍵を使うと起動時に出る警告はFess 15.10開発版の説明です。
通常の運用ではComposeファイルのあるディレクトリーで実行する
compose.yaml と同じ場所に compose.override.yaml を置き、そこで docker compose up -d や docker compose pull を実行すると上書きファイルが読み込まれます。停止は docker compose down です。-f compose.yaml を指定した場合は、そのファイルだけが読み込まれます。
本番用の compose-production.yaml も使う場合は、-f compose.yaml -f compose-production.yaml -f compose.override.yaml の順に指定します。起動時と停止時で同じファイルを読み込ませます。
暗号鍵とプラグインが反映される条件
暗号鍵は FESS_JAVA_OPTS に -Dfess.config.app.cipher.key=... として渡します。上書きファイルでこの変数を設定すると値全体が置き換わるので、ベースにある他のJVMオプションも含めます。既定の鍵は公開されており、独自の鍵は空白を除く印字可能ASCIIの16、24、32文字にします。鍵を変更すると以前の鍵で保存したパスワードを読めなくなるため、既存環境の更新では保存時の鍵を維持します。
FESS_PLUGINS に追加したプラグインは、起動時に対象バージョンが取得されます。Fessを更新する場合は対応するプラグインの版を指定します。再起動前に docker compose config で両変数が読み込まれることを確認できます。展開結果には鍵が含まれるため、画面の共有やログへの貼り付けは避けます。