Salta ai contenuti
mofcloud

Scalabilità e alta disponibilità

Ultimo aggiornamento:

Un server basta per la maggior parte dei team. Aggiungi macchine solo quando MOF deve restare attivo anche in caso di guasto di un server, o quando ci sono così tanti account cloud che le sincronizzazioni continuano ad accodarsi.

Due MOF + Dash + MCP dietro un load balancer e due worker, tutti su un unico PostgreSQLAlta disponibilità: serve il webWorker: eseguono le sincronizzazioniLoad balancerMOF + Dash + MCPMOF + Dash + MCPWorkerWorkerPostgreSQL
Ciascuna metà funziona da sola: il lato sinistro per l'uptime, i worker accanto a un singolo server per sincronizzazioni più rapide.

Cosa fa ogni processo

RuoloImpostazioneWebSincronizzazioni
MOF completoNiente (predefinito)SìSì
WorkerRK_CONFIG_0_CONTENT_MODE_WORKER=trueNoSì
Solo webRK_CONFIG_0_CONTENT_MODE_WEB=trueSìNo

Admin → Sistema → Processi MOF mostra ogni processo in esecuzione e il suo ruolo.

Alta disponibilità

  1. Su ogni server, usa il compose.yaml con PostgreSQL esterno con lo stesso database.
  2. Avvia un server e prendi la password di Admin dal suo log, poi avvia gli altri.
  3. Punta il load balancer sulla porta 80 di ogni server, con un health check attivo su /v1/mof/site-info ogni pochi secondi.

Il controllo passa da Dash a MOF, quindi un server il cui MOF si è fermato risponde 502 e viene escluso. Senza un controllo attivo (proxy solo passivi), la prima richiesta dopo un guasto attende un timeout prima di passare a un altro server.

Usa le stesse versioni delle immagini ovunque. Con OAuth via browser, anche MOF_PUBLIC_URL e MOF_MCP_OAUTH_SECRET devono coincidere. La chiave di accesso, la chiave di cifratura e la licenza risiedono nel database; lì non c'è nulla da fare.

Su Kubernetes, MOF, MCP e Dash sono Deployment separati, quindi aggiungi invece repliche: kubectl -n mof scale deployment/mof deployment/dash --replicas=2. Gli aggiornamenti fermano comunque brevemente ogni Pod di MOF (strategia Recreate), così tutte le repliche eseguono una sola versione.

Più worker

Usa lo stesso database e la stessa versione di MOF del deployment principale. I worker non aprono alcuna porta.

Scarica compose.yaml

Docker Hub · MOF v2.0.15

Scarica compose.yaml ↓
Visualizza file e immagini
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:
Release stabili fissate
MOFv2.0.15
mofcloud/mof:v2.0.15

Connessione al database

Inserisci la stessa connessione al database del deployment principale:

RK_POSTGRES_0_ADDR
Indirizzo:porta
RK_POSTGRES_0_USER
Nome utente
RK_POSTGRES_0_PASS
Password
Dati esistenti e accesso al database

Il ruolo richiede i permessi di login e CREATEDB. Cambiare l'indirizzo non migra i dati né reimposta le password. Esegui backup e ripristino separatamente prima di cambiare database.

Avvia

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

Per aggiungere altri worker su questa macchina:

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

Ogni worker esegue contemporaneamente 2 job di sincronizzazione (fatture, risorse, esportazioni) e 2 job operativi (eliminare un account, eliminare fatture, applicare un tag virtuale). Togli il commento e aumenta RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS in compose.yaml se la macchina ha memoria disponibile; RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS fa lo stesso per i job operativi.