Połącz Collabora Online z ownCloud Infinite Scale

Użyj usługi Collaboration usługi ownCloud Infinite Scale jako mostu WOPI między interfejsem użytkownika a Collabora Online. W przypadku nowej instalacji najbezpieczniejszym rozwiązaniem jest oficjalny modułowy ocis_fullprzykład Docker Compose firmy ownCloud, który obejmuje Infinite Scale, Collaboration, Collabora i Traefik. Ustaw publiczne adresy URL Infinite Scale, Collabora i WOPI, używaj prawidłowych certyfikatów TLS i zachowaj spójność wszystkich tajnych kluczy usługi. Nie konfiguruj tego tak, jakby Infinite Scale był klasycznym serwerem ownCloud.

To rozróżnienie zostało potwierdzone w aktualnej dokumentacji ownCloud: Infinite Scale integruje pakiety biurowe za pośrednictwem WOPI i usługi Collaboration. Usługa ta zastępuje starszy cs3org/wopiserwer zewnętrzny w nowszych wersjach, więc administratorzy aktualizujący starsze wdrożenie muszą postępować zgodnie z instrukcjami migracji dla zainstalowanej wersji.

1. Sprawdź wymagania wstępne dotyczące wydania i sieci

Przed zainstalowaniem czegokolwiek należy sprawdzić dokładną wersję Infinite Scale. Aktualna dokumentacja ownCloud wymienia usługę Collaboration w dokumentacji programistycznej 9.0 i informuje, że należy ją uruchomić osobno, gdy Infinite Scale działa w trybie nadzorowanym. Przykład pełnego stosu ownCloud ostrzega również, że konfiguracja zależy od wersji zawierających usługę Collaboration i nie działa z wersjami produkcyjnymi 5.x. Należy używać dokumentacji i plików Compose, które odpowiadają zainstalowanej wersji; nie należy kopiować przykładu kroczącego do starszego systemu produkcyjnego bez sprawdzenia zgodności.

W przypadku wdrożenia publicznego zaplanuj oddzielne nazwy hostów, takie jak cloud.example.com, office.example.comi wopi.example.com. Przeglądarka musi mieć dostęp do adresów URL chmury i Collabora, a Collabora musi mieć dostęp do punktu końcowego WOPI udostępnianego przez Infinite Scale. DNS, zapory sieciowe i zaufanie TLS muszą działać w obu kierunkach. Host dostępny z laptopa, ale nie z kontenera Collabora, nie wystarczy.

Przykład wdrożenia ownCloud wykorzystuje Traefik jako odwrotny serwer proxy i oczekuje prawidłowego protokołu SSL dla konfiguracji serwera. Lokalna konfiguracja testowa może korzystać z certyfikatów podpisanych przez siebie, ale instalacje publiczne nie powinny automatycznie wyłączać weryfikacji certyfikatów. Zdecyduj, których nazw hostów i certyfikatów będziesz używać przed skonfigurowaniem stosu.

2. Zacznij od przykładu dopasowania kompozycji ownCloud

1. Otwórz oficjalny przewodnik wdrożenia pełnej, modułowej wersji oCIS z WebOffice firmy ownCloud i odpowiadający jej katalog przykładów ocis_full . W przypadku środowiska produkcyjnego sprawdź wydanie lub tag, który pasuje do Twojej wersji Infinite Scale, zamiast polegać na gałęzi kroczącej repozytorium.
2. Przejrzyj przykładowy .envplik. Ustaw OCIS_DOMAIN, COLLABORA_DOMAIN, i WOPISERVER_DOMAINna nazwy hostów, które odpowiadają Twojemu serwerowi. Przykład włącza Collabora za pomocą COLLABORA=:collabora.yml; zachowaj to ustawienie, jeśli Collabora jest edytorem pakietu Office, którego chcesz używać.
3. Ustaw silne, prywatne dane uwierzytelniające administratora i postępuj zgodnie z przykładowymi instrukcjami dotyczącymi produkcyjnego protokołu TLS. Nie pozostawiaj przykładowych haseł bez zmian. Jeśli wersja repozytorium zmieniła nazwy zmiennych środowiskowych lub układ plików, użyj plików z tej samej wersji z tagami, zamiast mieszać instrukcje z różnych wersji.
4. Przed uruchomieniem usługi Compose sprawdź jej konfigurację. Upewnij się, że usługi Collabora, Collaboration, Infinite Scale i proxy współdzielą docelową sieć i konfigurację. W przewodniku ownCloud ostrzega się, że jeśli usługa Collaboration działa w oddzielnym kontenerze, odpowiednia konfiguracja Infinite Scale i wygenerowane klucze tajne muszą być współdzielone z pozostałymi usługami.

Przykład wdrożenia to zintegrowany stos, a nie uniwersalna konfiguracja dla każdej istniejącej instalacji. Jeśli korzystasz już z Infinite Scale z systemd, Kubernetes lub niestandardowym odwrotnym serwerem proxy, zachowaj ten model wdrożenia i skonfiguruj usługę Collaboration oraz App Registry, korzystając z dokumentacji dla tej wersji, zamiast uruchamiać drugi pełny stos.

3. Połącz Collaboration z Collabora za pomocą WOPI

Ustawienia podstawowe identyfikują adres URL edytora i zewnętrznie dostępne źródło WOPI. W obecnej dokumentacji usługi COLLABORATION_APP_NAMEjest to wyświetlana nazwa aplikacji, COLLABORATION_APP_PRODUCTidentyfikuje produkt, COLLABORATION_APP_ADDRwskazuje na Collabora i COLLABORATION_WOPI_SRCjest adresem URL, którego Collabora używa do odczytu i zapisu plików za pośrednictwem Infinite Scale. Koncepcja konfiguracji wygląda następująco:

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

Użyj rzeczywistych publicznych adresów URL i formatu zmiennych wymaganych przez wdrożenie. Jeśli usługi komunikują się w wewnętrznej sieci kontenerów, adres wewnętrzny może być odpowiedni dla jednego ustawienia, a adres URL widoczny w przeglądarce – dla innego. Nie należy zastępować nazwy hosta tylko dla kontenera wartością, którą Collabora musi rozwiązać zewnętrznie.

Usługa Collaboration wymaga również wartości środowiska wykonawczego Infinite Scale OCIS_URL: OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, i MICRO_REGISTRY_ADDRESS. Muszą one być zgodne z działającą instancją; oficjalny przykład pełnego stosu udostępnia relacje usług dla własnej sieci Compose. Nie należy tworzyć nowych sekretów tylko dla jednej usługi ani wyłączać sprawdzania klucza WOPI, aby uniknąć niezgodności. Należy włączyć weryfikację certyfikatów dla zaufanych certyfikatów publicznych; COLLABORATION_APP_INSECUREjest to udokumentowane jedynie jako opcja dla certyfikatu aplikacji WOPI z podpisem własnym, a nie jako ogólne rozwiązanie problemu produkcyjnego.

Rejestr aplikacji kontroluje, która aplikacja pakietu Office jest wyświetlana dla każdego typu MIME i która aplikacja otwiera się domyślnie. Jeśli Collabora jest uruchomiona, ale dokumenty nie wyświetlają opcji „otwórz za pomocą”, sprawdź konfigurację typu MIME w rejestrze i jej default_appwartość. Nazwa używana w tym rejestrze musi być zgodna ze skonfigurowaną nazwą aplikacji pakietu Office. OwnCloud dokumentuje to jako konfigurację YAML; zmienne środowiskowe nie zastępują mapowania typu MIME.

4. Uruchom, przetestuj i zdiagnozuj integrację

Korzystając z oficjalnego przykładu Compose, sprawdź poprawność wyrenderowanej konfiguracji, a następnie uruchom stos z katalogu wdrożenia:

docker compose config
docker compose up -d

Jeśli nie korzystasz z przykładu Compose, najpierw uruchom usługi bramy, dostawcy aplikacji i Collabora. W trybie nadzorowanym dokumenty ownCloud uruchamiają usługę Collaboration jawnie za pomocą ocis collaboration server; nie uruchamia się ona automatycznie. Upewnij się, że wymagane zmienne środowiskowe są wypełnione w procesie usługi Collaboration przed jego uruchomieniem.

1. Otwórz https://office.example.com/hosting/discoveryw przeglądarce. Osiągalny punkt końcowy powinien zwrócić kod XML odkrycia Collabora, a nie błąd DNS, TLS lub proxy.
2. Zaloguj się do Infinite Scale, otwórz obsługiwany dokument i wybierz Collabora, jeśli interfejs użytkownika oferuje wiele aplikacji biurowych. Przetestuj istniejący plik i, jeśli jest to włączone w Rejestrze aplikacji, utwórz nowy dokument.
3. Wprowadź niewielką zmianę, poczekaj, aż wskaźnik zapisu zniknie, zamknij edytor i ponownie otwórz plik, aby sprawdzić, czy zmiana została zachowana.
4. Jeśli edytor się nie otworzy, sprawdź dzienniki Infinite Scale Collaboration i App Provider, dzienniki Collabora oraz dzienniki odwrotnego proxy z tym samym znacznikiem czasu. Komunikat „Nieautoryzowany host WOPI” wskazuje na konfigurację zaufania WOPI Collabora; nieudane wywołanie zwrotne lub błąd TLS wskazuje na dostępność adresu URL lub zaufanie certyfikatu; brak opcji aplikacji wskazuje na rejestr aplikacji.

Pomyślna integracja oznacza, że ​​przeglądarka ładuje edytor, połączenie WOPI osiąga poziom Infinite Scale, a zmiany są zapisywane po ponownym otwarciu. Dokładne nazwy kontenerów, połączenia URL i lokalizacje plików konfiguracyjnych zależą od wersji Infinite Scale i metody wdrożenia. Szczegółowe informacje można znaleźć w dokumentacji ownCloud dopasowanej do wersji, szczególnie w przypadku migracji ze starszego, zewnętrznego serwera WOPI.

Odniesienia: konfiguracja usługi ownCloud Collaboration , konfiguracja ownCloud App Registry oraz notatki dotyczące wydania i migracji usługi Infinite Scale .