Ръководство за инсталиране

Първо влизане и експлоатация

Първият администратор, надстройките, архивите, coming soon и политиката за сигурност.

Първият администратор

Регистрацията е отворена само за притежатели на код за покана, а кодовете се генерират в конзолата — която още никой не може да отвори. Първият код се генерира на самата машина.

  1. Образ: на сървъра, от корена на хранилището, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Папка: в PowerShell, в папката, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Командата извежда код във формата XXXX-XXXX-XXXX; invite-code 5 извежда пет.
  4. В портала щракнете върху Вход, след това върху Създаване на акаунт: въведете кода, регистрирайте се с имейла, записан в ADMINISTRATORS, и го потвърдете с кода от имейла за потвърждение.
  5. Влезте: Диагностика, в долната част на всяка страница, отваря конзолата, където се генерират останалите кодове за покана.

Съвет Ако имейлът за потвърждение не пристига, проверете паролата на пощенската кутия: услугата за влизане съобщава при стартиране, когато тя липсва.

Надстройка

Надстройката заменя образа и запазва данните: те се намират в тома на контейнера, който принадлежи на проекта, а не на образа.

  1. На машината за разработка, с актуализираното хранилище, изградете новия образ: .\rebuild_container_release.ps1 -NoSeedData.
  2. Копирайте го на сървъра, проверете го и го заредете като първия път: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Стартирайте със същата команда като първия път: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d забелязва новия образ и пресъздава контейнера, с прекъсване от няколко секунди.
  4. Отворете конзолата в раздела Надстройка: където ред показва Налична надстройка, щракнете върху Изпълни надстройка — дотогава функциите за данни на тази услуга остават изключени.

Съвет Преди всяка надстройка проверете в диагностиката дали копията на базите данни са наред (картата „Копия на базите данни“) и копирайте файловете: надстройката на базите данни работи върху копие и пази оригинала, докато копието не бъде проверено, но копията са вашият собствен път назад.

Копия и възстановяване

Всяка услуга поддържа непрекъснато копие на базите данни, които управлява — акаунти, индекси на документите, поща, разговори —, което изостава най-много с около секунда, и може да го възстанови до състоянието във всеки момент от последните седем дни. Самите файлове — документи, прикачени файлове, визуализации — се записват веднъж и никога не се променят: те се копират отделно или се съхраняват в bucket на S3.

  1. Изнесете копията на базите данни извън машината: регистрирайте местоназначение от класа backups в bucket на S3 или на друг диск и го активирайте.
  2. Образ: копирайте файловете, без базите данни, докато работи: 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 .' записва архив с дата в папката files.
  3. Папка: спрете я с .\stop.ps1, копирайте изцяло папката data, после я стартирайте отново.
  4. Ако администратор е регистрирал друго местоназначение за файловете, копирайте неговата папка в същия кръг: файловете, създадени след активирането му, са само там.
  5. Пазете копията далеч от машината, която защитават.

Съвет За да върнете една база данни или цялата инсталация към състоянието от даден момент, спрете инсталацията и изпълнете merydion-storage copies restore (процедурата „Копия и възстановяване“ от ръководството): командата записва възстановените бази данни в нова папка, която после заема мястото на старата.

Поставяне на сайта в coming soon

Coming soon показва на всеки посетител само страница за предварителен преглед, докато инсталацията се подготвя: порталът, приложенията, Palatys и конзолата чакат зад нея, и за администраторите.

  1. Влезте като администратор и отворете https://merydion.example.com/coming-soon.html?enabled=true: страницата потвърждава и сайтът е в coming soon.
  2. За да включите сайта отново, отворете https://merydion.example.com/coming-soon.html?enabled=false: след потвърждението страницата ви отвежда към началната страница.
  3. Ако не сте влезли, страницата първо ви моли да влезете; на акаунт, който не е администратор, го казва и нищо не се променя.
  4. Състоянието е файлът site/coming-soon в папката с данни: премахването му включва сайта отново дори без страницата.

Съвет Страницата на coming soon съществува на английски и италиански; посетител с друг език получава английската.

Включване на статистиката на посещенията

Сайтът може да брои посещенията си с Google Analytics 4, като първо иска съгласие от всеки посетител: докато посетителят не приеме, нищо от Google не се зарежда. Статистиката остава изключена, докато инсталацията не посочи своя идентификатор за измерване, а в административната конзола тя никога не присъства.

  1. В Google Analytics създайте ресурс и уеб поток от данни за адреса на сайта и копирайте неговия идентификатор за измерване (започва с G-).
  2. Образ: във файла .env до docker-compose.yml добавете MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX и пресъздайте контейнера с docker compose up -d. Папка: експортирайте същата променлива в сесията преди start.ps1.
  3. Отворете сайта в частен прозорец: долу вляво се появява известието за статистиката на посещенията, а в долната част на всяка страница — „Предпочитания за бисквитките“.
  4. За да изключите статистиката, изпразнете променливата и пресъздайте контейнера: известието изчезва, а браузърите на тези, които са приели, спират да зареждат Google Analytics.

Съвет Политиката за поверителност и политиката за бисквитките вече описват статистиката, на всеки език, за инсталацията, която я включва. В ресурса задайте желаното запазване на данните — Google пази данните от едно посещение най-много 14 месеца — и оставете сигналите на Google изключени: сайтът ги изключва и от своя страна.

Отваряне на сайта за търсачките

Всяка инсталация казва на търсачките да не я индексират, докато не включи индексирането: копие на сайта, което не е официалното — тестова инсталация, инсталацията на някоя организация — никога не се конкурира с него в резултатите. Адресите, които декларират страниците, визуализациите и картите на сайта, сочат официалния сайт, https://merydion.eu, а страниците на акаунта, конзолата и страницата на несъществуващ адрес никога не влизат в индекс.

  1. Само на инсталацията, която обслужва официалния сайт. Образ: във файла .env до docker-compose.yml добавете MERYDION_SITE_INDEXING=1 и пресъздайте контейнера с docker compose up -d. Папка: експортирайте същата променлива в сесията преди start.ps1.
  2. Проверете: curl -I https://merydion.eu/ вече не показва заглавката X-Robots-Tag: noindex, а https://merydion.eu/robots.txt сочи към https://merydion.eu/sitemap.xml.
  3. В Google Search Console и в Bing Webmaster Tools потвърдете домейна с DNS запис и изпратете https://merydion.eu/sitemap.xml.
  4. За да извадите отново сайта от търсачките, изпразнете променливата и пресъздайте контейнера: всеки отговор отново казва noindex, а търсачките премахват страниците при следващото си посещение.

Съвет Портал, генериран за друг адрес, задава при генерирането си MERYDION_SITE_ORIGIN (например https://www.example.com): тогава каноничните адреси, алтернативните езикови версии, визуализациите и картите на сайта сочат този адрес. Страницата на несъществуващ адрес отговаря на езика на своята папка, със статус 404.

Content-Security-Policy на портала

Страниците на портала работят под строга Content-Security-Policy, която шлюзът изпраща: страницата може да използва само собствените си файлове, заявки към собствения си произход, изображения и от data: и blob: и никаква рамка от друг сайт. Това пречи на случаен фрагмент маркиране да изпълни код. Единственото изключение е статистиката на посещенията: страниците, които могат да броят посещенията, допускат и gtag.js на Google, само по неговия път, и събирането на данни на Google Analytics, които се зареждат едва след като посетителят приеме.

  1. Персонализиран портал със скриптове или стилове, написани в страниците, не работи: скриптовете и стиловете отиват в собствени файлове.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE и window.MERYDION_DIAGNOSTICS_BASE могат да преместят група заявки само под друг път от същия произход; адрес от друг произход се пренебрегва, с грешка в конзолата на браузъра.
  3. Страниците на конзолата на инсталацията носят политиката без изключението за статистиката и освен това не могат да се показват в рамка.
  4. Политиката се намира в apps/portal-csp.mjs и в трите Caddyfile, а тест ги поддържа еднакви: променяйте я и на четирите места едновременно.

Съвет Формулярът за влизане на услугата за самоличност и страницата за отказ на конзолата пристигат със собствена политика, още по-строга.

Обратно към ръководството

Производителност, made in Italy.

Предоставете целия пакет на екипа си — прост, сигурен и изцяло ваш.