Collabora CODEの設定を、デプロイメントの変更を失うことなく復元する

Collabora CODEコンテナは、再構築後にデフォルト設定で再起動する場合や、サーバー障害によって構成の有効なコピーが失われる場合があります。coolwsd.xml設定を提供するアクティブファイルとデプロイメントファイルをバックアップしてください。バックアップしたファイルを同じ永続ソースに復元し、ユーザーが編集を再開する前にファイルとサービスを検証してください。

メインファイルは一般的に です/etc/coolwsd/coolwsd.xml。パッケージ、Docker、Helm のインストールでは、真の情報源が異なるため、コピーする前にデプロイメントを特定してください。

1. アクティブな構成ソースを見つける

パッケージのインストール時には、ホストファイルを確認してください。Dockerの場合は、実行中のコンテナ内のファイルを確認し、ホストファイルまたはディレクトリがその上にマウントされているかどうかを確認してください。Compose、参照されている環境ファイル、またはHelmの値も保持してください。これらのファイルで指定された起動オプションは、必ずしもXMLに保存されているとは限りません。

sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml

実際のコンテナ名に置き換えてくださいcollabora-code。Collaboraの設定とDockerのドキュメントにはこれらのデプロイパスが記載されており、アップストリームのHelmチャートにはチャートレベルの設定が公開されています。ご使用のリリースのドキュメントをお読みください。デフォルト設定やデプロイ動作はバージョンによって異なる場合があります。

2. XMLファイルとデプロイメントファイルをバックアップする

日付を明記したコピーを制限付きディレクトリに保存してください。設定情報には、許可されているWOPIホスト、プロキシの動作、証明書のパス、または管理設定などが含まれる可能性があります。バックアップは機密性の高い運用データとして扱ってください。

パッケージのインストール時に、ファイルメタデータを保持する：

sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml

Dockerの場合、コンテナからホストにライブファイルをコピーします。

mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
  ~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml

バインドマウントがファイルを提供する場合は、ホスト側のソースもバックアップしてください。これは、再起動時にコンテナ内の編集内容を上書きする可能性のあるファイルです。Compose ファイルと参照されている.envファイルはすべて、同じ保護されたバックアップセットに保持してください。Helm の場合は、正確な値ファイルとリリース ID を保存し、既存のシークレット処理プロセスを使用して、個別に管理される Secrets または ConfigMaps も保存してください。

3. バックアップを再現可能にする

CODEイメージタグまたはパッケージバージョン、コンテナ名、マウント元、およびバックアップ日時を記録してください。パッケージのインストール時cp -aにメタデータを保持するために使用できます。コンテナファイルの所有権はホストと異なる場合があるため、ホストの所有者またはモードがすべてのイメージバージョンに適しているとは限りません。

Compose の場合、ファイルまたはディレクトリ全体がマウントされているかどうかを判断してください/etc/coolwsd。ディレクトリのマウントによってイメージに含まれるファイルが隠される可能性があり、不完全なディレクトリでは必要なファイルが利用できなくなる可能性があります。CODE が依存するマウントされたディレクトリ内のすべてのファイルをバックアップしてください。環境設定は別途保管し、機密情報を保護してください。

Helm の場合、生成されたポッドを編集することに頼らないでください。アップグレードによってポッドが再作成される可能性があります。チャートの値と外部の Secret または ConfigMap は保持してください。Collabora のアップストリーム チャートは値による設定コンテンツをサポートしているため、宣言されたソースは実行中のポッドからのコピーよりも信頼性が高くなります。

4. 永続的なソースに復元する

CODEを停止するか、メンテナンスウィンドウを使用してください。ファイルを置き換える前に、現在のファイルを保存してください。パッケージのインストールの場合、選択したバックアップを復元し、そのパッケージが想定する所有権とモードを維持してください。

sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd

サンプルの所有者とグループがパッケージと一致しない場合があります。既存のファイルを確認しstat、サンプル値を無条件に適用するのではなく、想定される所有権とモードを維持してください。バインドマウントされたコンテナの場合は、ホストファイルを復元し、Composeの再起動または再作成ワークフローに従ってください。カスタムイメージまたはHelmの値によって構成が提供されている場合は、そのソースを更新して再デプロイしてください。使い捨てコンテナを編集しても、変更は反映されません。

メジャーバージョン変更時に復元する前に、設定を確認してください。オプションはリリース間で変更される可能性があるため、保存したファイルを対象バージョンのテンプレートおよび移行に関する注意事項と比較してください。XMLを復元しても、証明書、秘密鍵、カスタムフォント、リバースプロキシ設定は、別途バックアップされていない限り復元されません。

5. 編集を再開する前に確認する

ファイルが存在すること、サービスが読み取り可能であること、および形式が整然としたXMLであることを確認します。インストールされている場合は、xmllint構文チェックも行います。

xmllint --noout /etc/coolwsd/coolwsd.xml

これはXML構文のみを確認するものであり、CODEバージョンで全てのオプションがサポートされていることを証明するものではありません。解析エラーがないかログを調べ、サービスが引き続き実行されていることを確認してください。コンテナの場合は、docker compose ps最近のログを確認してください。パッケージの場合は、systemctl status coolwsdシステムジャーナルを確認してください。

最後に、通常のWOPIホスト経由でドキュメントを開き、読み込みと保存が成功することを確認してください。CODEが起動してもドキュメントの読み込みに失敗した場合は、復元された許可リスト、外部ホスト名、TLS終端、プロキシ設定をデプロイメントと比較してください。起動に失敗した場合は、復元前のコピーにロールバックし、ファイルを比較してから再度試してください。

• バックアップバージョンとデプロイメントバージョンが一致していることを確認してください。
• マウント値またはHelm値が復元されたソースを指していることを確認してください。
• XML解析とサービス起動が成功したことを確認します。
• 接続されたストレージプラットフォームを介したファイルの開き方と保存方法をテストします。

公式資料

• Collabora Onlineの設定ドキュメント
• Collabora CODE Dockerイメージのドキュメント
• Collaboraの上流Helmチャート値
• Dockerバインドマウントに関するドキュメント