콘텐츠로 이동
mofcloud

확장과 고가용성

마지막 업데이트:

대부분의 팀은 서버 한 대로 충분합니다. 서버 장애 중에도 MOF가 계속 동작해야 하거나, 클라우드 계정이 너무 많아 동기화가 계속 대기열에 쌓일 때만 머신을 추가하세요.

로드 밸런서 뒤의 MOF + Dash + MCP 두 세트와 Worker 두 대, 모두 하나의 PostgreSQL 사용고가용성: 웹 처리Worker: 동기화 실행로드 밸런서MOF + Dash + MCPMOF + Dash + MCPWorkerWorkerPostgreSQL
둘 중 한쪽만 따로 써도 됩니다. 가용성이 목적이면 왼쪽, 더 빠른 동기화가 목적이면 단일 서버 옆에 Worker를 둡니다.

각 프로세스의 역할

역할설정웹동기화
전체 MOF없음(기본값)예예
WorkerRK_CONFIG_0_CONTENT_MODE_WORKER=true아니요예
웹 전용RK_CONFIG_0_CONTENT_MODE_WEB=true예아니요

Admin → 시스템 → MOF 프로세스에서 실행 중인 모든 프로세스와 역할을 볼 수 있습니다.

고가용성

  1. 모든 서버에서 외부 PostgreSQL용 compose.yaml을 사용하고 같은 데이터베이스를 지정하세요.
  2. 먼저 서버 한 대를 시작해 로그에서 Admin 비밀번호를 확인한 뒤 나머지 서버를 시작합니다.
  3. 로드 밸런서가 각 서버의 80번 포트로 전달하도록 하고, /v1/mof/site-info에 대해 몇 초마다 액티브 헬스 체크를 수행하세요.

헬스 체크는 Dash를 거쳐 MOF까지 가므로, MOF가 멈춘 서버는 502를 반환해 제외됩니다. 액티브 체크가 없으면(패시브 전용 프록시) 장애 후 첫 요청은 타임아웃을 기다린 뒤에야 다른 서버로 넘어갑니다.

모든 서버에서 같은 이미지 버전을 사용하세요. 브라우저 OAuth를 쓴다면 MOF_PUBLIC_URL 및 MOF_MCP_OAUTH_SECRET 값도 같아야 합니다. 로그인 키, 암호화 키, 라이선스는 데이터베이스에 저장되므로 따로 할 일이 없습니다.

Kubernetes에서는 MOF, MCP, Dash가 각각 별도의 Deployment이므로 대신 레플리카를 늘리세요: kubectl -n mof scale deployment/mof deployment/dash --replicas=2. 업그레이드 시에는 여전히 모든 MOF Pod가 잠시 중지되므로(strategy Recreate), 모든 레플리카가 같은 버전으로 실행됩니다.

Worker 추가

메인 배포와 같은 데이터베이스와 MOF 버전을 사용하세요. Worker는 포트를 열지 않습니다.

compose.yaml 다운로드

Docker Hub · MOF v2.0.15

다운로드 compose.yaml ↓
파일과 이미지 보기
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:
고정된 안정 릴리스
MOFv2.0.15
mofcloud/mof:v2.0.15

데이터베이스 연결

메인 배포와 같은 데이터베이스 연결 정보를 입력합니다:

RK_POSTGRES_0_ADDR
주소:포트
RK_POSTGRES_0_USER
사용자 이름
RK_POSTGRES_0_PASS
비밀번호
기존 데이터와 데이터베이스 권한

역할에는 로그인과 CREATEDB 권한이 필요합니다. 주소를 바꿔도 데이터가 이전되거나 비밀번호가 재설정되지 않습니다. 데이터베이스를 전환하기 전에 별도로 백업하고 복원하세요.

시작

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

이 머신에 Worker를 더 추가하려면:

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

각 Worker는 동기화 작업(청구서, 리소스, 내보내기) 2개와 운영 작업(계정 삭제, 청구서 정리, 가상 태그 적용) 2개를 동시에 실행합니다. 머신 메모리에 여유가 있다면 compose.yaml에서 RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS의 주석을 해제하고 값을 늘리세요. RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS는 운영 작업에 대해 같은 역할을 합니다.