Installationsvejledning

Imaget på en Linux-server

Byg imaget, gør serveren klar, og start containeren på dit domæne.

Byg imaget

Imaget bygges på udviklingsmaskinen, med Docker Desktop i tilstanden Linux-containere, og kommer til serveren som en fil: serveren har hverken brug for et registry eller for kildekoden.

  1. Kør .\rebuild_container_release.ps1 -NoSeedData fra roden af repositoriet: det bygger imaget, kontrollerer, at det ikke indeholder kilder og har alle kompilerede dele, starter det til test og gemmer det som deploy\docker\merydion-allinone.tar med dets fingeraftryk.
  2. Kopiér imaget og fingeraftrykket til serveren, for eksempel med scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Kontrollér fingeraftrykket på serveren, og indlæs imaget: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Tip Uden -NoSeedData pakker buildet også merydion-data.tar.gz med udviklingsmaskinens data — inklusive persondata og login-tjenestens private nøgle: det er ikke til en ny installation.

Gør serveren klar

Bevar repositoriets struktur på serveren: compose-filen finder sine naboer via relative stier. Filerne nedenfor hører til serveren, aldrig til imaget.

  1. Lad DNS-posten for dit domæne pege på serveren, og åbn porte 80 og 443 mod internettet.
  2. Skriv en rigtig e-mail i den globale blok i deploy/prod-allinone/Caddyfile: Let's Encrypt skriver dertil, før et certifikat udløber.
  3. Opret deploy/prod-allinone/.env med MERYDION_DOMAIN=merydion.example.com og, så bekræftelses-e-mails sendes, MERYDION_AUTH_SMTP_PASSWORD= efterfulgt af postkassens adgangskode.
  4. Opret SERVER_SECRETS.json i roden af repositoriet, kun læsbar for dig (chmod 600): tjenesternes øvrige hemmeligheder hører til der, og uden nogen indeholder den { "services": {} } — uden filen starter containeren ikke.
  5. Skriv din e-mail i ADMINISTRATORS i roden af repositoriet.

Tip En hemmelighed hører aldrig til i SERVER_CONFIGURATION.json, som er versioneret og holder de hemmelige felter tomme; et felts variabel har forrang for SERVER_SECRETS.json.

Start containeren

Containeren indeholder gatewayen, tjenesterne, portalen og apps. Den starter fra det indlæste image uden at bygge noget på serveren.

  1. Fra roden af repositoriet: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Kontrollér, at den kører: docker compose -f deploy/prod-allinone/docker-compose.yml ps skal vise running, ikke restarting.
  3. Ved første besøg henter Caddy certifikatet, hvilket tager op til et minut: derefter svarer curl -sS https://merydion.example.com/health ok.
  4. Hvis containeren bliver ved med at genstarte, er en tjeneste stoppet og har trukket de andre med: læs hvorfor med docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Tip Videoopkald på denne server kræver også medietjenestens UDP-port og et TURN-relæ: runbooken til en enkelt node i repositoriet beskriver de ekstra indstillinger.

Tilbage til guiden

Produktivitet, made in Italy.

Giv hele pakken til dit team – enkel, sikker og helt din.