Przywróć ustawienia Collabora CODE bez utraty zmian wdrożenia

Kontener Collabora CODE może uruchomić się ponownie z ustawieniami domyślnymi po przebudowie, a awaria serwera może spowodować utratę działającej kopii konfiguracji. Utwórz kopię zapasową coolwsd.xmlplików aktywnych i wdrożeniowych, które dostarczają ustawienia. Przywróć je do tego samego trwałego źródła, a następnie sprawdź poprawność pliku i usługi przed wznowieniem edycji przez użytkowników.

Plik główny to zazwyczaj /etc/coolwsd/coolwsd.xml. Źródło prawdy różni się w zależności od instalacji pakietu, Dockera i Helma, dlatego przed skopiowaniem czegokolwiek należy zidentyfikować wdrożenie.

1. Znajdź aktywne źródło konfiguracji

Podczas instalacji pakietu sprawdź plik hosta. W Dockerze sprawdź plik wewnątrz uruchomionego kontenera i sprawdź, czy plik lub katalog hosta jest na nim zamontowany. Zachowaj również Compose, pliki środowiskowe, do których istnieją odwołania, lub wartości Helm: opcje startowe tam zawarte niekoniecznie są przechowywane w formacie 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

Zastąp collabora-coderzeczywistą nazwą kontenera. Konfiguracja Collabora i dokumentacja Dockera opisują te ścieżki wdrażania, a jej wykres Helm udostępnia ustawienia na poziomie wykresu. Przeczytaj dokumentację dotyczącą swojej wersji; ustawienia domyślne i sposób wdrażania mogą się różnić między wersjami.

2. Utwórz kopię zapasową plików XML i plików wdrożeniowych

Przechowuj kopię z datą w katalogu zastrzeżonym. Konfiguracja może ujawnić dozwolone hosty WOPI, zachowanie serwera proxy, ścieżki certyfikatów lub ustawienia administracyjne. Traktuj kopię zapasową jako poufne dane operacyjne.

W przypadku instalacji pakietu zachowaj metadane pliku:

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

W przypadku platformy Docker skopiuj plik na żywo z kontenera do hosta:

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

Jeśli plik jest dostarczany przez montowanie powiązania, należy wykonać kopię zapasową również jego źródła po stronie hosta; to właśnie ten plik może nadpisać edycję w kontenerze po ponownym uruchomieniu. Plik Compose i wszystkie .envpliki, do których się odwołuje, należy zachować w tym samym chronionym zestawie kopii zapasowych. W przypadku Helm należy zapisać plik dokładnych wartości i tożsamość wydania, a także oddzielnie zarządzane sekrety lub mapy konfiguracji, korzystając z istniejącego procesu obsługi sekretów.

3. Uczyń kopię zapasową powtarzalną

Zapisz znacznik obrazu CODE lub wersję pakietu, nazwę kontenera, źródło montowania i datę kopii zapasowej. Instalacje pakietów mogą być używane cp -ado zachowania metadanych. Własność pliku kontenera może różnić się w zależności od hosta, więc nie zakładaj, że właściciel lub tryb hosta będzie pasował do każdej wersji obrazu.

W przypadku funkcji Compose określ, czy plik, czy cały katalog jest zamontowany w /etc/coolwsd. Montowanie katalogu może ukryć pliki zawarte w obrazie; niekompletny katalog może uniemożliwić dostęp do oczekiwanych plików. Utwórz kopię zapasową każdego pliku w zamontowanym katalogu, z którego korzysta CODE. Przechowuj ustawienia środowiska osobno i chroń poufne dane.

W przypadku Helm nie należy polegać na edycji wygenerowanego podu: aktualizacje mogą go odtworzyć. Zachowaj wartości wykresu oraz wszelkie zewnętrzne dane tajne lub mapę konfiguracji. Wykres upstream Collabora obsługuje zawartość konfiguracji za pomocą wartości, dzięki czemu deklarowane źródło może być bardziej wiarygodne niż kopia z działającego podu.

4. Przywróć do trwałego źródła

Zatrzymaj CODE lub skorzystaj z okna konserwacji. Zapisz bieżący plik przed jego nadpisaniem. W przypadku instalacji pakietu przywróć wybraną kopię zapasową i zachowaj właściciela oraz tryb oczekiwany przez ten pakiet:

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

Właściciel i grupa próbki mogą nie pasować do Twojego pakietu. Sprawdź istniejący plik stati zachowaj jego oczekiwany właściciel i tryb, zamiast bezmyślnie stosować wartości próbki. W przypadku kontenera montowanego metodą bind-mounted, przywróć plik hosta i postępuj zgodnie z procedurą ponownego uruchomienia Compose lub ponownego utworzenia. Jeśli niestandardowy obraz lub wartość Helm dostarczają konfigurację, zaktualizuj to źródło i wdróż ponownie; edycja kontenera jednorazowego nie zostanie zachowana.

Przejrzyj konfigurację przed przywróceniem po istotnej zmianie wersji. Opcje mogą się zmieniać między wydaniami, dlatego porównaj zapisany plik z szablonem wersji docelowej i notatkami dotyczącymi migracji. Przywracanie XML nie przywraca certyfikatów, kluczy prywatnych, czcionek niestandardowych ani konfiguracji odwrotnego serwera proxy, chyba że zostały one utworzone osobno.

5. Sprawdź przed ponownym otwarciem edycji

Sprawdź, czy plik istnieje, jest czytelny dla usługi i ma poprawny format XML. Jeśli jest zainstalowany, xmllintsprawdza składnię:

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

To tylko potwierdza składnię XML; nie dowodzi, że każda opcja jest obsługiwana przez Twoją wersję CODE. Sprawdź logi pod kątem błędów analizy i upewnij się, że usługa nadal działa. W przypadku kontenerów sprawdź logi docker compose psi ostatnie logi. W przypadku pakietów sprawdź logi systemctl status coolwsdi dziennik systemowy.

Na koniec otwórz dokument za pośrednictwem standardowego hosta WOPI i sprawdź, czy się załadował i zapisał. Jeśli CODE uruchomi się, ale dokumenty nie zostaną załadowane, porównaj przywróconą listę dozwolonych, zewnętrzną nazwę hosta, zakończenie TLS i ustawienia proxy z wdrożeniem. Jeśli uruchomienie się nie powiedzie, przywróć kopię sprzed przywrócenia i porównaj pliki przed ponowną próbą.

• Potwierdź zgodność wersji kopii zapasowej i wdrożenia.
• Sprawdź, czy wartości mount lub Helm wskazują na przywrócone źródło.
• Potwierdź pomyślne parsowanie XML i uruchomienie usługi.
• Przetestuj otwieranie i zapisywanie za pośrednictwem podłączonej platformy pamięci masowej.

Oficjalne źródła

• Dokumentacja konfiguracji Collabora Online
• Dokumentacja obrazu Collabora CODE Docker
• Wartości wykresu Helm w górę strumienia Collabora
• Dokumentacja montowań Dockera