Ghid de instalare

Imaginea pe un server Linux

Construiți imaginea, pregătiți serverul și porniți containerul pe domeniul dvs.

Construirea imaginii

Imaginea se construiește pe mașina de dezvoltare, cu Docker Desktop în modul containere Linux, și ajunge pe server ca fișier: serverul nu are nevoie nici de registru, nici de codul sursă.

  1. Din rădăcina depozitului, rulați .\rebuild_container_release.ps1 -NoSeedData: construiește imaginea, verifică faptul că nu conține surse și că are fiecare parte compilată, o pornește de probă și o salvează ca deploy\docker\merydion-allinone.tar cu amprenta sa.
  2. Copiați imaginea și amprenta pe server, de exemplu cu scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Pe server, verificați amprenta și încărcați imaginea: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Sfat Fără -NoSeedData, build-ul împachetează și merydion-data.tar.gz cu datele mașinii de dezvoltare — inclusiv date personale și cheia privată a serviciului de autentificare: nu este pentru o instalare nouă.

Pregătirea serverului

Pe server, păstrați structura depozitului: fișierul compose își găsește vecinii după calea relativă. Fișierele de mai jos aparțin serverului, niciodată imaginii.

  1. Faceți ca înregistrarea DNS a domeniului dvs. să indice serverul și deschideți porturile 80 și 443 spre Internet.
  2. În deploy/prod-allinone/Caddyfile, scrieți un e-mail real în blocul global: Let's Encrypt scrie la el înainte să expire un certificat.
  3. Creați deploy/prod-allinone/.env cu MERYDION_DOMAIN=merydion.example.com și, ca e-mailurile de verificare să plece, MERYDION_AUTH_SMTP_PASSWORD= urmat de parola căsuței poștale.
  4. Creați SERVER_SECRETS.json în rădăcina depozitului, lizibil doar de dvs. (chmod 600): acolo merg celelalte secrete ale serviciilor, iar dacă nu există niciunul conține { "services": {} } — fără fișier containerul nu pornește.
  5. Scrieți e-mailul dvs. în ADMINISTRATORS, în rădăcina depozitului.

Sfat Un secret nu merge niciodată în SERVER_CONFIGURATION.json, care este versionat și ține goale câmpurile secrete; variabila unui câmp are prioritate față de SERVER_SECRETS.json.

Pornirea containerului

Containerul conține gateway-ul, serviciile, portalul și aplicațiile. Pornește din imaginea încărcată, fără să construiască nimic pe server.

  1. Din rădăcina depozitului: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Verificați că rulează: docker compose -f deploy/prod-allinone/docker-compose.yml ps trebuie să arate running, nu restarting.
  3. La prima vizită Caddy obține certificatul, ceea ce durează până la un minut: apoi curl -sS https://merydion.example.com/health răspunde ok.
  4. Dacă containerul repornește încontinuu, un serviciu s-a oprit și le-a tras după el pe celelalte: citiți motivul cu docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Sfat Apelurile video pe acest server au nevoie și de portul UDP al serviciului media și de un releu TURN: runbook-ul pentru nod unic din depozit descrie setările suplimentare.

Înapoi la ghid

Productivitate, made in Italy.

Aduceți întreaga suită echipei dvs. — simplă, sigură și complet a dvs.