Przewodnik po instalacji

Pierwsze logowanie i eksploatacja

Pierwszy administrator, aktualizacje, kopie zapasowe, coming soon i zasady bezpieczeństwa.

Pierwszy administrator

Rejestracja jest otwarta tylko dla posiadaczy kodu zaproszenia, a kody generuje się w konsoli — której jeszcze nikt nie może otworzyć. Pierwszy kod generuje się na samym komputerze.

  1. Obraz: na serwerze, w katalogu głównym repozytorium, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Folder: w PowerShellu, w folderze, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Polecenie wypisuje kod w postaci XXXX-XXXX-XXXX; invite-code 5 wypisuje pięć.
  4. W portalu kliknij Zaloguj się, a potem Utwórz konto: wpisz kod, zarejestruj się adresem e-mail wpisanym do ADMINISTRATORS i potwierdź go kodem z e-maila weryfikacyjnego.
  5. Zaloguj się: Diagnostyka na dole każdej strony otwiera konsolę, w której generuje się pozostałe kody zaproszeń.

Wskazówka Jeśli e-mail weryfikacyjny nie dociera, sprawdź hasło skrzynki pocztowej: usługa logowania zgłasza przy uruchomieniu, że go brakuje.

Aktualizacja

Aktualizacja zastępuje obraz i zachowuje dane: znajdują się w woluminie kontenera, który należy do projektu, a nie do obrazu.

  1. Na komputerze programisty, ze zaktualizowanym repozytorium, zbuduj nowy obraz: .\rebuild_container_release.ps1 -NoSeedData.
  2. Skopiuj go na serwer, sprawdź i wczytaj jak za pierwszym razem: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Uruchom tym samym poleceniem co za pierwszym razem: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d zauważa nowy obraz i tworzy kontener od nowa, z kilkusekundową przerwą.
  4. Otwórz konsolę na karcie Aktualizacja: tam, gdzie wiersz pokazuje Dostępna aktualizacja, kliknij Uruchom aktualizację — do tego czasu funkcje danych tej usługi pozostają wyłączone.

Wskazówka Przed każdą aktualizacją sprawdź w diagnostyce, czy kopie baz danych są w porządku (karta „Kopie baz danych”), i skopiuj pliki: aktualizacja baz danych pracuje na kopii i zachowuje oryginał, dopóki kopia nie zostanie sprawdzona, ale kopie to Twoja własna droga powrotu.

Kopie i przywracanie

Każda usługa utrzymuje ciągłą kopię baz danych, którymi zarządza — kont, indeksów dokumentów, poczty, czatów — opóźnioną najwyżej o mniej więcej sekundę, i potrafi przywrócić je do stanu z dowolnej chwili ostatnich siedmiu dni. Same pliki — dokumenty, załączniki, podglądy — są zapisywane raz i nigdy się nie zmieniają: kopiuje się je osobno albo przechowuje w buckecie S3.

  1. Przenieś kopie baz danych poza ten komputer: zarejestruj miejsce docelowe klasy backups w buckecie S3 lub na innym dysku i je aktywuj.
  2. Obraz: skopiuj pliki, bez baz danych, w trakcie działania: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' zapisuje archiwum z datą w folderze files.
  3. Folder: zatrzymaj go poleceniem .\stop.ps1, skopiuj cały folder data, a potem uruchom go ponownie.
  4. Jeśli administrator zarejestrował inne miejsce docelowe dla plików, skopiuj jego folder w tej samej rundzie: pliki utworzone po jego aktywacji są tylko tam.
  5. Przechowuj kopie z dala od komputera, który chronią.

Wskazówka Aby przywrócić jedną bazę danych lub całą instalację do stanu z wybranej chwili, zatrzymaj instalację i uruchom merydion-storage copies restore (procedura „Kopie i przywracanie” w runbooku): polecenie zapisuje przywrócone bazy danych w nowym folderze, który następnie zajmuje miejsce starego.

Przełączanie witryny w coming soon

Coming soon pokazuje każdemu odwiedzającemu tylko stronę podglądu, dopóki instalacja jest przygotowywana: portal, aplikacje, Palatys i konsola czekają za nią, także dla administratorów.

  1. Zaloguj się jako administrator i otwórz https://merydion.example.com/coming-soon.html?enabled=true: strona potwierdza, a witryna jest w trybie coming soon.
  2. Aby ponownie włączyć witrynę, otwórz https://merydion.example.com/coming-soon.html?enabled=false: po potwierdzeniu strona przenosi Cię na stronę główną.
  3. Jeśli nie jesteś zalogowany, strona najpierw prosi o zalogowanie; kontu, które nie jest administratorem, mówi o tym, i nic się nie zmienia.
  4. Stan to plik site/coming-soon w folderze danych: usunięcie go włącza witrynę ponownie nawet bez strony.

Wskazówka Strona coming soon istnieje po angielsku i po włosku; odwiedzający z innym językiem dostaje wersję angielską.

Włączanie statystyk odwiedzin

Witryna może liczyć swoje odwiedziny za pomocą Google Analytics 4, najpierw prosząc każdego odwiedzającego o zgodę: dopóki odwiedzający się nie zgodzi, nic od Google się nie wczytuje. Statystyki pozostają wyłączone, dopóki instalacja nie poda swojego identyfikatora pomiaru, a konsola administracyjna nie ma ich nigdy.

  1. W Google Analytics utwórz usługę i internetowy strumień danych dla adresu witryny, a następnie skopiuj jego identyfikator pomiaru (zaczyna się od G-).
  2. Obraz: w pliku .env obok docker-compose.yml dodaj MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX i utwórz kontener od nowa poleceniem docker compose up -d. Folder: wyeksportuj tę samą zmienną w sesji przed start.ps1.
  3. Otwórz witrynę w oknie prywatnym: w lewym dolnym rogu pojawia się powiadomienie o statystykach odwiedzin, a na dole każdej strony link „Preferencje plików cookie”.
  4. Aby wyłączyć statystyki, wyczyść zmienną i utwórz kontener od nowa: powiadomienie znika, a przeglądarki osób, które się zgodziły, przestają wczytywać Google Analytics.

Wskazówka Polityka prywatności i polityka plików cookie już opisują statystyki, w każdym języku, dla instalacji, która je włącza. W usłudze ustaw wybrany okres przechowywania danych — Google przechowuje dane wizyty przez maksymalnie 14 miesięcy — i pozostaw sygnały Google wyłączone: witryna wyłącza je również po swojej stronie.

Udostępnianie witryny wyszukiwarkom

Każda instalacja każe wyszukiwarkom jej nie indeksować, dopóki sama nie włączy indeksowania: nieoficjalna kopia witryny — instalacja testowa, instalacja organizacji — nigdy nie konkuruje z oficjalną w wynikach wyszukiwania. Adresy deklarowane przez strony, podglądy i mapy witryny wskazują oficjalną witrynę, https://merydion.eu, a strony konta, konsola i strona nieistniejącego adresu nigdy nie trafiają do indeksu.

  1. Tylko w instalacji, która obsługuje oficjalną witrynę. Obraz: w pliku .env obok docker-compose.yml dodaj MERYDION_SITE_INDEXING=1 i utwórz kontener od nowa poleceniem docker compose up -d. Folder: wyeksportuj tę samą zmienną w sesji przed start.ps1.
  2. Sprawdź: curl -I https://merydion.eu/ nie pokazuje już nagłówka X-Robots-Tag: noindex, a https://merydion.eu/robots.txt wskazuje https://merydion.eu/sitemap.xml.
  3. W Google Search Console i w Bing Webmaster Tools zweryfikuj domenę rekordem DNS i prześlij https://merydion.eu/sitemap.xml.
  4. Aby ponownie wycofać witrynę z wyszukiwarek, wyczyść zmienną i utwórz kontener od nowa: każda odpowiedź znów zawiera noindex, a wyszukiwarki usuwają strony przy następnej wizycie.

Wskazówka Portal dla innego adresu generuje się z ustawioną zmienną MERYDION_SITE_ORIGIN (na przykład https://www.example.com): adresy kanoniczne, alternatywne wersje językowe, podglądy i mapy witryny wskazują wtedy ten adres. Strona nieistniejącego adresu odpowiada w języku swojego folderu, ze statusem 404.

Content-Security-Policy portalu

Strony portalu działają pod ścisłą Content-Security-Policy, którą wysyła brama: strona może używać tylko własnych plików, żądań do własnego źródła, obrazów także z data: i blob: oraz żadnej ramki z innej witryny. To właśnie powstrzymuje zabłąkany fragment znaczników przed uruchomieniem kodu. Jedynym wyjątkiem są statystyki odwiedzin: strony, które mogą liczyć odwiedziny, dopuszczają także gtag.js od Google, tylko w jego ścieżce, oraz zbieranie danych Google Analytics, które wczytują się dopiero wtedy, gdy odwiedzający wyrazi zgodę.

  1. Dostosowany portal ze skryptami lub stylami wpisanymi wewnątrz stron nie działa: skrypty i style trafiają do osobnych plików.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE i window.MERYDION_DIAGNOSTICS_BASE mogą przenieść rodzinę żądań tylko pod inną ścieżkę tego samego źródła; adres w innym źródle jest ignorowany, z błędem w konsoli przeglądarki.
  3. Strony konsoli instalacji mają zasady bez wyjątku dla statystyk, a ponadto nie można ich wyświetlić w ramce.
  4. Zasady znajdują się w apps/portal-csp.mjs i w trzech plikach Caddyfile, a test utrzymuje je jednakowe: zmieniaj je we wszystkich czterech miejscach naraz.

Wskazówka Formularz logowania usługi tożsamości i strona odmowy konsoli przychodzą z własnymi, jeszcze ostrzejszymi zasadami.

Powrót do przewodnika

Produktywność, made in Italy.

Daj swojemu zespołowi cały pakiet — prosty, bezpieczny i w pełni Twój.