Przewodnik po instalacji

Obraz na serwerze Linux

Zbuduj obraz, przygotuj serwer i uruchom kontener w swojej domenie.

Budowanie obrazu

Obraz buduje się na komputerze programisty, z Docker Desktop w trybie kontenerów Linux, i trafia na serwer jako plik: serwer nie potrzebuje ani rejestru, ani kodu źródłowego.

  1. W katalogu głównym repozytorium uruchom .\rebuild_container_release.ps1 -NoSeedData: buduje obraz, sprawdza, czy nie zawiera źródeł i czy ma każdą skompilowaną część, uruchamia go próbnie i zapisuje jako deploy\docker\merydion-allinone.tar z jego odciskiem.
  2. Skopiuj obraz i jego odcisk na serwer, na przykład poleceniem scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Na serwerze sprawdź odcisk i wczytaj obraz: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Wskazówka Bez -NoSeedData kompilacja pakuje też merydion-data.tar.gz z danymi komputera programisty — łącznie z danymi osobowymi i kluczem prywatnym usługi logowania: to nie jest do nowej instalacji.

Przygotowanie serwera

Na serwerze zachowaj układ repozytorium: plik compose znajduje swoich sąsiadów po ścieżce względnej. Poniższe pliki należą do serwera, nigdy do obrazu.

  1. Skieruj rekord DNS swojej domeny na serwer i otwórz porty 80 i 443 na internet.
  2. W deploy/prod-allinone/Caddyfile wpisz prawdziwy adres e-mail w bloku globalnym: Let's Encrypt pisze na niego przed wygaśnięciem certyfikatu.
  3. Utwórz deploy/prod-allinone/.env z MERYDION_DOMAIN=merydion.example.com oraz, żeby wychodziły e-maile weryfikacyjne, MERYDION_AUTH_SMTP_PASSWORD= z hasłem skrzynki pocztowej.
  4. Utwórz SERVER_SECRETS.json w katalogu głównym repozytorium, czytelny tylko dla Ciebie (chmod 600): trafiają tam pozostałe sekrety usług, a jeśli ich nie ma, zawiera { "services": {} } — bez tego pliku kontener się nie uruchamia.
  5. Wpisz swój adres e-mail do ADMINISTRATORS w katalogu głównym repozytorium.

Wskazówka Sekret nigdy nie trafia do SERVER_CONFIGURATION.json, który jest wersjonowany i zostawia pola sekretów puste; zmienna pola ma pierwszeństwo przed SERVER_SECRETS.json.

Uruchamianie kontenera

Kontener zawiera bramę, usługi, portal i aplikacje. Uruchamia się z wczytanego obrazu, niczego nie budując na serwerze.

  1. W katalogu głównym repozytorium: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Sprawdź, czy działa: docker compose -f deploy/prod-allinone/docker-compose.yml ps musi pokazywać running, a nie restarting.
  3. Przy pierwszej wizycie Caddy pobiera certyfikat, co trwa do minuty: potem curl -sS https://merydion.example.com/health odpowiada ok.
  4. Jeśli kontener ciągle się restartuje, któraś usługa się zatrzymała i pociągnęła za sobą pozostałe: przyczynę odczytasz poleceniem docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Wskazówka Rozmowy wideo na tym serwerze potrzebują też portu UDP usługi multimediów i przekaźnika TURN: runbook pojedynczego węzła w repozytorium opisuje dodatkowe ustawienia.

Powrót do przewodnika

Produktywność, made in Italy.

Daj swojemu zespołowi cały pakiet — prosty, bezpieczny i w pełni Twój.