Príručka k inštalácii

Obraz na linuxovom serveri

Zostavte obraz, pripravte server a spustite kontajner na svojej doméne.

Zostavenie obrazu

Obraz sa zostavuje na vývojovom počítači, s Docker Desktop v režime linuxových kontajnerov, a na server putuje ako súbor: server nepotrebuje register ani zdrojový kód.

  1. V koreni repozitára spustite .\rebuild_container_release.ps1 -NoSeedData: zostaví obraz, overí, že neobsahuje žiadne zdrojové súbory a obsahuje každú skompilovanú časť, skúšobne ho spustí a uloží ako deploy\docker\merydion-allinone.tar s jeho odtlačkom.
  2. Skopírujte obraz a jeho odtlačok na server, napríklad pomocou scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Na serveri overte odtlačok a načítajte obraz: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Tip Bez -NoSeedData zostavenie zabalí aj merydion-data.tar.gz s údajmi vývojového počítača — vrátane osobných údajov a súkromného kľúča prihlasovacej služby: to nie je pre novú inštaláciu.

Príprava servera

Na serveri zachovajte usporiadanie repozitára: súbor compose nájde svojich susedov podľa relatívnej cesty. Nižšie uvedené súbory patria serveru, nikdy obrazu.

  1. Nasmerujte záznam DNS svojej domény na server a otvorte porty 80 a 443 do internetu.
  2. V deploy/prod-allinone/Caddyfile napíšte do globálneho bloku skutočný e-mail: Let's Encrypt naň píše, než certifikát vyprší.
  3. Vytvorte deploy/prod-allinone/.env s MERYDION_DOMAIN=merydion.example.com a, aby overovacie e-maily odchádzali, s MERYDION_AUTH_SMTP_PASSWORD=, za ktorým nasleduje heslo schránky.
  4. Vytvorte SERVER_SECRETS.json v koreni repozitára, čitateľný iba pre vás (chmod 600): patria tam ostatné tajomstvá služieb, a ak žiadne nie sú, obsahuje { "services": {} } — bez súboru sa kontajner nespustí.
  5. Napíšte svoj e-mail do ADMINISTRATORS v koreni repozitára.

Tip Tajomstvo nikdy nepatrí do SERVER_CONFIGURATION.json, ktorý je verziovaný a tajné polia necháva prázdne; premenná poľa má prednosť pred SERVER_SECRETS.json.

Spustenie kontajnera

Kontajner obsahuje bránu, služby, portál a aplikácie. Spúšťa sa z načítaného obrazu, bez toho, aby sa na serveri čokoľvek zostavovalo.

  1. V koreni repozitára: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Overte, že beží: docker compose -f deploy/prod-allinone/docker-compose.yml ps musí ukazovať running, nie restarting.
  3. Pri prvej návšteve Caddy získa certifikát, čo trvá do minúty: potom curl -sS https://merydion.example.com/health odpovie ok.
  4. Ak sa kontajner stále reštartuje, niektorá služba sa zastavila a strhla so sebou ostatné: dôvod zistíte pomocou docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Tip Videohovory na tomto serveri potrebujú aj port UDP služby médií a relay TURN: runbook jedného uzla v repozitári opisuje ďalšie nastavenia.

Späť na príručku

Produktivita, made in Italy.

Prineste svojmu tímu celý balík — jednoduchý, bezpečný a úplne váš.