Guia de instalação

A imagem num servidor Linux

Construa a imagem, prepare o servidor e inicie o contentor no seu domínio.

Construir a imagem

A imagem constrói-se na máquina de desenvolvimento, com o Docker Desktop em modo de contentores Linux, e chega ao servidor como ficheiro: o servidor não precisa de registo nem de código-fonte.

  1. Na raiz do repositório, execute .\rebuild_container_release.ps1 -NoSeedData: constrói a imagem, verifica que não contém fontes e que tem cada parte compilada, inicia-a para teste e guarda-a como deploy\docker\merydion-allinone.tar com a sua impressão digital.
  2. Copie a imagem e a sua impressão digital para o servidor, por exemplo com scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. No servidor, verifique a impressão digital e carregue a imagem: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Sugestão Sem -NoSeedData, a build empacota também merydion-data.tar.gz com os dados da máquina de desenvolvimento — dados pessoais e chave privada do serviço de início de sessão incluídos: não é para uma instalação nova.

Preparar o servidor

No servidor, mantenha a disposição do repositório: o ficheiro compose encontra os seus vizinhos por caminho relativo. Os ficheiros abaixo pertencem ao servidor, nunca à imagem.

  1. Faça o registo DNS do seu domínio apontar para o servidor e abra as portas 80 e 443 para a Internet.
  2. Em deploy/prod-allinone/Caddyfile, escreva um e-mail real no bloco global: a Let's Encrypt escreve para lá antes de um certificado expirar.
  3. Crie deploy/prod-allinone/.env com MERYDION_DOMAIN=merydion.example.com e, para que os e-mails de verificação saiam, MERYDION_AUTH_SMTP_PASSWORD= seguido da palavra-passe da caixa de correio.
  4. Crie SERVER_SECRETS.json na raiz do repositório, legível apenas por si (chmod 600): os outros segredos dos serviços vão para lá, e sem nenhum contém { "services": {} } — sem o ficheiro, o contentor não arranca.
  5. Escreva o seu e-mail em ADMINISTRATORS, na raiz do repositório.

Sugestão Um segredo nunca vai para SERVER_CONFIGURATION.json, que é versionado e mantém vazios os campos secretos; a variável de um campo prevalece sobre SERVER_SECRETS.json.

Iniciar o contentor

O contentor contém o gateway, os serviços, o portal e as aplicações. Arranca a partir da imagem carregada, sem construir nada no servidor.

  1. Na raiz do repositório: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Verifique que está a funcionar: docker compose -f deploy/prod-allinone/docker-compose.yml ps tem de indicar running, não restarting.
  3. Na primeira visita o Caddy obtém o certificado, o que demora até um minuto: depois curl -sS https://merydion.example.com/health responde ok.
  4. Se o contentor reiniciar sem parar, um serviço parou e arrastou os outros: leia o motivo com docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Sugestão As videochamadas neste servidor precisam também da porta UDP do serviço de multimédia e de um relay TURN: o runbook de nó único no repositório descreve as definições adicionais.

Voltar ao guia

Produtividade, made in Italy.

Leve toda a suite para a sua equipa — simples, segura e inteiramente sua.