Installatiehandleiding

De image op een Linux-server

Bouw de image, bereid de server voor en start de container op uw domein.

De image bouwen

De image wordt gebouwd op de ontwikkelcomputer, met Docker Desktop in de modus voor Linux-containers, en komt als bestand op de server: de server heeft geen registry en geen broncode nodig.

  1. Voer in de hoofdmap van de repository .\rebuild_container_release.ps1 -NoSeedData uit: het bouwt de image, controleert dat er geen broncode in zit en elk gecompileerd onderdeel wel, start hem ter proef en slaat hem op als deploy\docker\merydion-allinone.tar met zijn vingerafdruk.
  2. Kopieer de image en zijn vingerafdruk naar de server, bijvoorbeeld met scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Controleer op de server de vingerafdruk en laad de image: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Tip Zonder -NoSeedData verpakt de build ook merydion-data.tar.gz met de gegevens van de ontwikkelcomputer — inclusief persoonsgegevens en de privésleutel van de aanmeldservice: dat is niet voor een nieuwe installatie.

De server voorbereiden

Behoud op de server de indeling van de repository: het compose-bestand vindt zijn buren via relatieve paden. De bestanden hieronder horen bij de server, nooit bij de image.

  1. Laat het DNS-record van uw domein naar de server wijzen en open poorten 80 en 443 naar internet.
  2. Zet in deploy/prod-allinone/Caddyfile een echt e-mailadres in het globale blok: Let's Encrypt schrijft daarheen voordat een certificaat verloopt.
  3. Maak deploy/prod-allinone/.env aan met MERYDION_DOMAIN=merydion.example.com en, zodat de verificatie-e-mails vertrekken, MERYDION_AUTH_SMTP_PASSWORD= gevolgd door het wachtwoord van de mailbox.
  4. Maak SERVER_SECRETS.json aan in de hoofdmap van de repository, alleen leesbaar voor u (chmod 600): daar staan de andere geheimen van de services, en zonder geheimen bevat het { "services": {} } — zonder het bestand start de container niet.
  5. Zet uw e-mailadres in ADMINISTRATORS, in de hoofdmap van de repository.

Tip Een geheim hoort nooit in SERVER_CONFIGURATION.json, dat onder versiebeheer staat en de geheime velden leeg houdt; de variabele van een veld gaat voor op SERVER_SECRETS.json.

De container starten

De container bevat de gateway, de services, het portaal en de apps. Hij start vanaf de geladen image, zonder iets op de server te bouwen.

  1. In de hoofdmap van de repository: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Controleer dat hij draait: docker compose -f deploy/prod-allinone/docker-compose.yml ps moet running tonen, niet restarting.
  3. Bij het eerste bezoek haalt Caddy het certificaat op, wat tot een minuut duurt: daarna antwoordt curl -sS https://merydion.example.com/health met ok.
  4. Als de container steeds opnieuw start, is een service gestopt en heeft die de andere meegesleurd: lees waarom met docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Tip Videogesprekken op deze server hebben ook de UDP-poort van de mediaservice en een TURN-relay nodig: het runbook voor één node in de repository beschrijft de extra instellingen.

Terug naar de handleiding

Productiviteit, made in Italy.

Breng de hele suite naar uw team — eenvoudig, veilig en volledig van u.