배포 가이드

이 페이지는 Server SDK 애플리케이션의 세 가지 배포 형태를 규모 순으로 소개합니다. 먼저 Collaboration SDK, 가져오기와 내보내기, 예제를 읽고 모듈이 어떻게 조립되는지 확인하세요. 배포는 같은 조립을 하나 이상의 노드에 배치하는 일입니다.

단일 머신

모든 기능을 하나의 Node.js 프로세스에 배포하고 브라우저가 직접 연결합니다.

• Database Adapter는 IDatabaseAdapter 계약을 구현합니다. 데이터베이스 어댑터를 참고하세요.
• 가져오기와 내보내기의 작업과 파일 저장, 시간 제한, 다운로드 링크는 파일 교환 통합을 참고하세요.
• 변환은 CPU 집약적이며 큰 파일은 협업을 느리게 합니다.

변환이 협업 응답에 영향을 주거나 많은 사용자에게 지속적으로 서비스해야 할 때 가져오기와 내보내기를 분리합니다.

가져오기와 내보내기 분리

가져오기와 내보내기를 별도 노드로 옮깁니다. 협업은 노드 1개를 유지하고, 게이트웨이가 두 종류의 경로를 나누어 라우팅하며, 둘 다 같은 데이터베이스에 연결합니다.

가져오기와 내보내기 노드는 Database Adapter, UniverCollabService, 변환 모듈을 조립하고 데이터베이스에 직접 접근합니다. 주입 지점은 단일 머신과 같습니다.

협업 노드 1개가 처리할 수 있는 문서 수는 프로세스 메모리로 제한됩니다. 용량을 넘거나 장애 조치가 필요하면 여러 노드로 넘어갑니다.

여러 협업 노드

여러 협업 노드가 같은 코드를 실행하고 같은 데이터베이스에 연결합니다. pub/sub 어댑터가 노드 간에 Room, Presence, 브로드캐스트를 중계하고 ticket store가 Session Ticket을 공유하며 @univerjs-pro/collaboration-cluster-redis가 Redis 구현을 제공합니다. 참고 예제: Multi-node.

각 협업 노드는 Redis pub/sub 어댑터와 ticket store를 Endpoint에 전달하며, 나머지 조립은 그대로입니다.

import { createClient } from "redis";import { RedisPubSubAdapter, RedisSessionTicketStore } from "@univerjs-pro/collaboration-cluster-redis";import { UniverCollabEndpoint } from "@univerjs-pro/collaboration-endpoint";const client = createClient({ url: process.env.REDIS_URL });const subClient = client.duplicate();await Promise.all([client.connect(), subClient.connect()]);const pubSub = new RedisPubSubAdapter({ pubClient: client, subClient });const ticketStore = new RedisSessionTicketStore({ client });const endpoint = new UniverCollabEndpoint(service, { pubSub, ticketStore });

더 나아가기

한 노드에서 매우 큰 문서를 처리하면 같은 노드의 작은 문서 요청이 느려집니다. 문서 규모에 따라 노드 풀을 나누고 게이트웨이가 큰 문서를 전용 풀로 라우팅하게 할 수 있습니다. 라우팅 키는 여전히 unit ID이고 모든 풀이 데이터베이스와 pub/sub를 공유합니다.