Pular para o conteúdo
mofcloud

Escalabilidade e alta disponibilidade

Última atualização:

Um servidor é suficiente para a maioria das equipes. Adicione máquinas apenas quando o MOF precisar continuar no ar mesmo com a falha de um servidor, ou quando houver tantas contas de nuvem que as sincronizações fiquem acumulando na fila.

Dois MOF + Dash + MCP atrás de um balanceador de carga e dois workers, todos em um mesmo PostgreSQLAlta disponibilidade: serve a webWorkers: executam sincronizaçõesBalanceador de cargaMOF + Dash + MCPMOF + Dash + MCPWorkerWorkerPostgreSQL
Cada metade funciona sozinha: o lado esquerdo para disponibilidade, workers ao lado de um único servidor para sincronizações mais rápidas.

O que cada processo faz

PapelConfiguraçãoWebSincronizações
MOF completoNada (padrão)SimSim
WorkerRK_CONFIG_0_CONTENT_MODE_WORKER=trueNãoSim
Somente webRK_CONFIG_0_CONTENT_MODE_WEB=trueSimNão

Admin → Sistema → Processos do MOF mostra cada processo em execução e seu papel.

Alta disponibilidade

  1. Em cada servidor, use o compose.yaml de PostgreSQL externo com o mesmo banco de dados.
  2. Inicie um servidor e pegue a senha do Admin no log dele; depois inicie os outros.
  3. Aponte o balanceador de carga para a porta 80 de cada servidor, com um health check ativo em /v1/mof/site-info a cada poucos segundos.

A verificação passa pelo Dash até o MOF, então um servidor cujo MOF parou responde 502 e é retirado. Sem verificação ativa (proxies apenas passivos), a primeira requisição após uma falha espera um timeout antes de passar para outro servidor.

Use as mesmas versões de imagem em todos os lugares. Com OAuth pelo navegador, MOF_PUBLIC_URL e MOF_MCP_OAUTH_SECRET também precisam ser iguais. A chave de login, a chave de criptografia e a licença ficam no banco de dados; nada a fazer ali.

No Kubernetes, MOF, MCP e Dash são Deployments separados, então adicione réplicas: kubectl -n mof scale deployment/mof deployment/dash --replicas=2. As atualizações ainda param brevemente todos os Pods do MOF (estratégia Recreate), para que todas as réplicas rodem a mesma versão.

Mais workers

Use o mesmo banco de dados e a mesma versão do MOF da implantação principal. Workers não abrem nenhuma porta.

Baixar compose.yaml

Docker Hub · MOF v2.0.15

Download compose.yaml ↓
Ver arquivo e imagens
compose.yaml
# MOF v2.0.15 — Linux amd64 / dockerhub
# Use the same database connection and MOF version as the main deployment.
# Private-network PostgreSQL without TLS. TLS-only databases are not supported by this release.
name: mof-worker
x-logging: &logging
  driver: json-file
  options:
    max-size: "20m"
    max-file: "5"

services:
  mof-worker:
    image: mofcloud/mof:v2.0.15
    restart: unless-stopped
    logging: *logging
    environment:
      RK_POSTGRES_0_ADDR: "db.example.com:5432"
      RK_POSTGRES_0_USER: "mof"
      RK_POSTGRES_0_PASS: "REPLACE_WITH_YOUR_DATABASE_PASSWORD"
      RK_CONFIG_0_CONTENT_MODE_WORKER: "true"
      # Optional, default 2: jobs run at the same time in this process, for syncs (bills,
      # resources, exports) and ops (delete an account, purge bills, apply a virtual tag filter).
      # RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS: "2"
      # RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS: "2"
    volumes:
      - offer-cache:/usr/src/mof/offer-cache

volumes:
  offer-cache:
Versões estáveis fixadas
MOFv2.0.15
mofcloud/mof:v2.0.15

Conexão com o banco de dados

Preencha a mesma conexão com o banco de dados da implantação principal:

RK_POSTGRES_0_ADDR
Endereço:porta
RK_POSTGRES_0_USER
Usuário
RK_POSTGRES_0_PASS
Senha
Dados existentes e acesso ao banco de dados

O role precisa de permissões de login e CREATEDB. Alterar o endereço não migra dados nem redefine senhas. Faça backup e restauração separadamente antes de trocar de banco de dados.

Iniciar

Terminal
docker compose config --quiet
docker compose up -d
docker compose ps

Para adicionar mais workers nesta máquina:

Terminal
docker compose up -d --scale mof-worker=3
docker compose logs --tail=100 mof-worker

Cada worker executa 2 jobs de sincronização (faturas, recursos, exportações) e 2 jobs de operação (excluir uma conta, limpar faturas, aplicar uma tag virtual) ao mesmo tempo. Descomente e aumente RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS no compose.yaml se a máquina tiver memória sobrando; RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS faz o mesmo para os jobs de operação.