Collabora OnlineをownCloud Infinite Scaleに接続する

ownCloud Infinite Scaleのコラボレーションサービスを、Web UIとCollabora Online間のWOPIブリッジとして使用します。新規インストールの場合、ocis_fullInfinite Scale、Collabora、Collabora、およびTraefikを含むownCloud公式のモジュール式Docker Composeサンプルを使用するのが最も安全です。公開されているInfinite Scale、Collabora、およびWOPIのURLを設定し、有効なTLS証明書を使用し、すべてのサービスシークレットを一貫して保持してください。Infinite Scaleを従来のownCloud Serverのように構成しないでください。

この違いはownCloudの最新ドキュメントにも明記されています。Infinite ScaleはWOPIとそのコラボレーションサービスを通じてオフィススイートを統合します。このサービスはcs3org/wopi新しいリリースで従来の外部サーバーに取って代わるため、古い環境をアップグレードする管理者は、インストール済みのバージョンに対応した移行手順に従う必要があります。

1. リリースおよびネットワークの前提条件を確認する

インストールを行う前に、Infinite Scaleの正確なリリースバージョンを確認してください。現在のownCloudドキュメントでは、コラボレーションサービスは9.0の開発ドキュメントに記載されており、Infinite Scaleを監視モードで実行する場合は別途起動する必要があるとされています。ownCloudのフルスタックサンプルでも、セットアップはコラボレーションサービスを含むリリースに依存しており、5.xの製品版リリースでは動作しないと警告されています。インストールされているリリースバージョンに合ったドキュメントとComposeファイルを使用してください。互換性を確認せずに、ローリングサンプルを古い製品版システムにコピーしないでください。

公開展開の場合は、 、 、 などの個別のホスト名を計画してくださいcloud.example.com。office.example.comブラウザwopi.example.comはクラウドと Collabora の URL にアクセスできる必要があり、Collabora は Infinite Scale が公開する WOPI エンドポイントにアクセスできる必要があります。DNS、ファイアウォール、および TLS の信頼関係は双方向で機能する必要があります。ラップトップからはアクセスできるが Collabora コンテナからはアクセスできないホストでは不十分です。

ownCloudのデプロイメント例では、リバースプロキシとしてTraefikを使用しており、サーバー設定には有効なSSL証明書が必要です。ローカルテスト環境では自己署名証明書を使用できますが、公開環境では証明書の検証を暗黙的に無効にすべきではありません。スタックを設定する前に、使用するホスト名と証明書を決定してください。

2. ownCloudの対応するComposeの例から始めます

1. ownCloudの公式フルモジュール型oCIS（WebOffice付き）導入ガイドと、対応するocis_fullサンプルディレクトリを開いてください。本番環境では、リポジトリのローリングブランチに頼るのではなく、Infinite Scaleのバージョンに合ったリリースまたはタグをチェックアウトしてください。
2. サンプル.envファイルを確認してください。OCIS_DOMAIN、、COLLABORA_DOMAINを、WOPISERVER_DOMAINサーバーに解決されるホスト名に設定してください。このサンプルではCOLLABORA=:collabora.yml、​​でCollaboraを有効にしています。Collaboraをオフィスエディタとして使用する場合は、この設定を維持してください。
3. 強力で安全な管理者認証情報を設定し、サンプルに記載されている本番環境におけるTLS設定に関するガイダンスに従ってください。サンプルパスワードはそのまま使用しないでください。リポジトリのバージョンによって環境変数名やファイル構成が変更されている場合は、異なるバージョンの手順を混在させるのではなく、同じタグ付きリリースに含まれるファイルを使用してください。
4. Compose を起動する前に、構成を確認してください。Collabora、Collaboration、Infinite Scale、およびプロキシサービスが、意図したネットワークと構成を共有していることを確認してください。ownCloud ガイドでは、Collaboration が別のコンテナで実行される場合、関連する Infinite Scale 構成と生成されたシークレットを他のサービスと共有する必要があると警告しています。

デプロイメント例は統合スタックであり、既存のすべてのインストール環境に適用できる汎用的な構成ではありません。既にsystemd、Kubernetes、またはカスタムリバースプロキシを使用してInfinite Scaleを実行している場合は、そのデプロイメントモデルを維持し、2つ目のフルスタックを起動するのではなく、該当リリースのドキュメントを使用してコラボレーションサービスとアプリケーションレジストリを設定してください。

3. WOPIを使用してコラボレーションをCollaboraに接続する

コア設定では、エディタの URL と外部からアクセス可能な WOPI ソースを指定します。現在のサービスドキュメントでは、COLLABORATION_APP_NAMEはアプリの表示名、 はCOLLABORATION_APP_PRODUCT製品を識別するもの、COLLABORATION_APP_ADDRは Collabora を指し、 はCOLLABORATION_WOPI_SRCCollabora が Infinite Scale を介してファイルを読み書きするために使用する URL です。概念的な構成は次のようになります。

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

デプロイメントで必要とされる実際の公開URLと変数形式を使用してください。サービスが内部コンテナネットワーク上で通信する場合、内部アドレスは一方の設定に適している一方、ブラウザ向けのURLは別の設定に適している場合があります。Collaboraが外部から解決する必要のある値に、コンテナ専用のホスト名を代入しないでください。

コラボレーション サービスでは、Infinite Scale ランタイム値OCIS_URL、OCIS_JWT_SECRET、OCIS_REVA_GATEWAY、 も必要ですMICRO_REGISTRY_ADDRESS。これらは実行中のインスタンスと一致している必要があります。公式のフルスタック サンプルでは、​​独自の Compose ネットワークのサービス関係が提供されています。1 つのサービスのためだけに新しいシークレットを作成したり、不一致を回避するために WOPI 証明キー チェックを無効にしたりしないでください。信頼できる公開証明書については、証明書の検証を有効にしたままにしてください。COLLABORATION_APP_INSECUREは、自己署名 WOPI アプリ証明書のオプションとしてのみ文書化されており、一般的な運用上の修正ではありません。

アプリレジストリは、各MIMEタイプに対してどのオフィスアプリが表示されるか、またどのアプリがデフォルトで起動するかを制御します。Collaboraが実行中であるにもかかわらず、ドキュメントに「このアプリケーションで開く」オプションが表示されない場合は、レジストリのMIMEタイプ設定とそのdefault_app値を確認してください。そこで使用されている名前は、設定されているオフィスアプリ名と一致している必要があります。ownCloudはこの設定をYAML形式で文書化しており、環境変数はMIMEタイプのマッピングを置き換えるものではありません。

4. 統合の開始、テスト、診断

公式のComposeサンプルを使用して、レンダリングされた構成を検証し、デプロイメントディレクトリからスタックを起動します。

docker compose config
docker compose up -d

Compose サンプルを使用しない場合は、まずゲートウェイ、アプリプロバイダ、および Collabora サービスを起動してください。監視モードでは、ownCloud のドキュメントでは、Collaboration を明示的に起動するように指示されていますocis collaboration server。自動的には起動しません。Collaboration サービスプロセスを起動する前に、必要な環境変数が正しく設定されていることを確認してください。

1. https://office.example.com/hosting/discoveryブラウザで開いてください。アクセス可能なエンドポイントは、DNS、TLS、またはプロキシのエラーではなく、Collaboraの検出XMLを返します。
2. Infinite Scaleにサインインし、サポートされているドキュメントを開きます。UIに複数のオフィスアプリが表示されている場合は、Collaboraを選択してください。既存のファイルと、アプリレジストリで有効になっている場合は新しいドキュメントの作成の両方をテストしてください。
3. 小さな編集を行い、保存インジケーターが安定するまで待ち、エディタを閉じてからファイルを再度開き、変更が反映されていることを確認してください。
4. エディタが開かない場合は、Infinite Scale Collaboration および App Provider のログ、Collabora のログ、およびリバースプロキシのログを同じタイムスタンプで確認してください。「Unauthorized WOPI host」は Collabora の WOPI 信頼設定を示しています。コールバックの失敗または TLS エラーは、URL の到達可能性または証明書の信頼性を示しています。アプリオプションが見つからない場合は、アプリレジストリに問題があります。

統合が成功すると、ブラウザでエディタが読み込まれ、WOPI接続がInfinite Scaleに到達し、再度開いた後も編集内容が保持されます。コンテナ名、URL配線、構成ファイルの場所は、Infinite Scaleのリリースとデプロイ方法によって異なります。特に従来の外部WOPIサーバーから移行する場合は、リリースに対応したownCloudのドキュメントを参照してください。

参考資料：ownCloud Collaboration サービス構成、ownCloud App Registry 構成、およびInfinite Scale リリース ノートと移行ノート。