Příručka k instalaci

Obraz na linuxovém serveru

Sestavte obraz, připravte server a spusťte kontejner na své doméně.

Sestavení obrazu

Obraz se sestavuje na vývojovém počítači, s Docker Desktop v režimu linuxových kontejnerů, a na server putuje jako soubor: server nepotřebuje registr ani zdrojový kód.

  1. V kořeni repozitáře spusťte .\rebuild_container_release.ps1 -NoSeedData: sestaví obraz, ověří, že neobsahuje žádné zdrojové soubory a obsahuje každou zkompilovanou část, zkušebně ho spustí a uloží jako deploy\docker\merydion-allinone.tar s jeho otiskem.
  2. Zkopírujte obraz a jeho otisk na server, například pomocí scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Na serveru ověřte otisk a načtěte obraz: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Tip Bez -NoSeedData sestavení zabalí také merydion-data.tar.gz s daty vývojového počítače — včetně osobních údajů a soukromého klíče přihlašovací služby: to není pro novou instalaci.

Příprava serveru

Na serveru zachovejte uspořádání repozitáře: soubor compose najde své sousedy podle relativní cesty. Níže uvedené soubory patří serveru, nikdy obrazu.

  1. Nasměrujte záznam DNS své domény na server a otevřete porty 80 a 443 do internetu.
  2. V deploy/prod-allinone/Caddyfile napište do globálního bloku skutečný e-mail: Let's Encrypt na něj píše, než certifikát vyprší.
  3. Vytvořte deploy/prod-allinone/.env s MERYDION_DOMAIN=merydion.example.com a, aby odcházely ověřovací e-maily, s MERYDION_AUTH_SMTP_PASSWORD= následovaným heslem schránky.
  4. Vytvořte SERVER_SECRETS.json v kořeni repozitáře, čitelný jen pro vás (chmod 600): patří tam ostatní tajemství služeb, a když žádná nejsou, obsahuje { "services": {} } — bez souboru se kontejner nespustí.
  5. Napište svůj e-mail do ADMINISTRATORS v kořeni repozitáře.

Tip Tajemství nikdy nepatří do SERVER_CONFIGURATION.json, který je verzovaný a tajná pole nechává prázdná; proměnná pole má přednost před SERVER_SECRETS.json.

Spuštění kontejneru

Kontejner obsahuje bránu, služby, portál a aplikace. Spouští se z načteného obrazu, aniž by se na serveru cokoli sestavovalo.

  1. V kořeni repozitáře: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Ověřte, že běží: docker compose -f deploy/prod-allinone/docker-compose.yml ps musí ukazovat running, ne restarting.
  3. Při první návštěvě Caddy získá certifikát, což trvá až minutu: pak curl -sS https://merydion.example.com/health odpoví ok.
  4. Pokud se kontejner stále restartuje, některá služba se zastavila a strhla s sebou ostatní: důvod zjistíte pomocí docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Tip Videohovory na tomto serveru potřebují také port UDP služby médií a relay TURN: runbook jednoho uzlu v repozitáři popisuje další nastavení.

Zpět na průvodce

Produktivita, made in Italy.

Přineste svému týmu celou sadu — jednoduchou, bezpečnou a zcela vaši.