ONLYOFFICEワークスペースのデフォルトの保存場所を変更する

ONLYOFFICE Workspaceポータルのデータをローカルディスクからサポートされているクラウドストレージサービスに移行するには、ポータルの設定 → 統合でそのサービスに接続し、コントロールパネル → 共通設定 → ストレージを開いて設定を行い、接続をクリックします。ONLYOFFICEによると、接続するとデータ移行が開始され、時間がかかる場合があります。「ストレージの場所」がDockerインストールで使用されるホストディレクトリを指す場合は、代わりにデプロイメント内のCommunity Serverデータボリュームを変更してください。これは別の操作です。

どの保存場所を変更しようとしていますか？

ONLYOFFICEでは、「ストレージ」という言葉を複数の意味で使用しています。コントロールパネルのストレージページでは、ポータルデータの保存先を「ディスクデフォルト」からサポートされているサードパーティ製ストレージに切り替えることができます。これは、Workspaceポータルデータをサーバーのローカルディスクから移動したい場合に、ほとんどのユーザーが想定している管理者設定です。ドキュメントモジュール内のフォルダを選択したり、個々のユーザー用に外部ドライブを接続したり、バックアップ先を変更したり、Dockerのデータディレクトリを移動したりするのとは異なります。

コントロールパネルのドキュメントには、ポータルストレージとしてGoogle Cloud Storage、Amazon AWS S3、Rackspace Cloud Storage、Selectel Cloud Storageが記載されています。CDNの選択肢として記載されているのはAmazon S3とSelectelのみです。CDNは、静的ポータルコンテンツを配信するための別の設定であり、ストレージ選択の代替となるものではありません。インストール環境に表示されるプロバイダーオプションとフィールドについては、最新のONLYOFFICEストレージ手順書をご確認ください。

始める前に何を準備すべきですか？

コントロールパネルにアクセスできる管理者アカウントが必要です。まず、ポータルの統合設定で選択したプロバイダーを接続してください。そうしないと、ストレージオプションが利用できないか、グレー表示されます。S3バケット名やリージョンなど、宛先に必要な詳細情報を準備し、認証情報とバケットのアクセス許可によってワークスペースサーバーがそれを使用できることを確認してください。

ストレージの保存先を変更する前に、最新のバックアップを作成してください。コントロールパネルのバックアップガイドには、バックアップの保存先とポータルバックアップの作成方法が記載されています。本番環境のポータルの場合は、比較的静かな時間帯を選び、ストレージ移行が開始されることをユーザーに通知してください。ドキュメントには、移行には時間がかかる場合があると記載されていますが、具体的な期間は示されていないため、完了予定時刻を基準にスケジュールを立てないでください。

コントロールパネルでポータルストレージを切り替えるにはどうすればよいですか？

1. プロバイダーに接続します。ポータルの設定を開き、「統合」に進みます。使用予定のクラウドサービスを追加し、接続設定を保存します。サービスが利用可能になってから、コントロールパネルに戻ってください。

2. ストレージを開きます。管理者アカウントでサインインします。スタートページからコントロールパネルを開くか、設定 → コントロールパネルを使用します。左側のサイドバーの共通設定で、ストレージを選択します。ストレージセクションで、初期設定ではディスクの既定のストレージが選択されています。使用するサードパーティのプロバイダを選択してください。

3. プロバイダーの詳細を入力して接続します。該当するサービスに表示されるフィールドに入力し、内容を確認してから「接続」をクリックしてください。Amazon S3の場合、ドキュメントに記載されているフィールドにはバケットとリージョンがあり、サービスURLなどのエンドポイント設定はオプションです。他のプロバイダーではフィールドが異なるため、選択したサービスに必要な値のみを使用してください。

4. 移行が完了するまでお待ちください。「接続」をクリックすると、ページが再読み込みされ、データ移行プロセスが開始されます。ブラウザを開いたままにするか、後でコントロールパネルに戻ってストレージページを確認してください。移行中は、ストレージの変更は行わないでください。移行が完了すると、ONLYOFFICEは接続先が選択された状態でストレージページが読み込まれると通知します。

もしかして、Dockerホストのディレクトリのことでしょうか？

ポータルのストレージセレクターは、Docker のバインドマウントされたデータディレクトリを変更しません。ONLYOFFICE Community Server の Docker ドキュメントでは、/var/www/onlyoffice/DataCommunity Server データのコンテナパスとして が示され、 などのホストフォルダにマッピングされていることがわかります/app/onlyoffice/CommunityServer/data。別のディスクを使用するには、コンテナの宛先は同じまま、Compose ファイル内のホスト側のソースパスを編集します。例:

services:
  communityserver:
    volumes:
      - /srv/onlyoffice/community-data:/var/www/onlyoffice/Data

実行中のコンテナを新しい空のディレクトリに指定して、そこに既存のデータが表示されることを期待しないでください。現在のデータをバックアップし、関連するスタックを停止し、所有権と権限を保持したまま古いマウント済みデータを新しいホストディレクトリにコピーし、バインドマウントを更新して再起動します。古いコピーを削除する前に、ポータルがロードされ、ファイルと設定が存在することを確認してください。正確なサービス名とボリュームマッピングは、Compose ファイルとインストール方法によって異なります。まず、実際の構成を確認してください。サポートされているコンテナパスとホストマウント方法については、ベンダーのDocker Community Server データボリュームのドキュメントを参照してください。

新しい場所をどのように確認できますか？

クラウドストレージを変更する場合は、コントロールパネル → ストレージ を再度開き、移行後に目的のプロバイダーが選択されていることを確認してください。ドキュメント モジュールを開き、管理者と一般ユーザーを使用して、既存のファイルと新しくアップロードしたファイルをいくつかテストしてください。Docker ホスト パスを変更する場合は、実行中のコンテナのマウントを調べ、想定されるホスト ディレクトリが にマッピングされていることを確認し/var/www/onlyoffice/Data、再起動後もポータルがファイルの読み書きができることを確認してください。移行が完了しない場合、またはデータが欠落している場合は、元のバックアップとストレージ コピーをそのまま保持し、ポータルとコンテナのログを収集し、移行を繰り返す前に ONLYOFFICE サポートにご相談ください。