배포 가이드
규모에 따라 Server SDK 애플리케이션의 배포 형태를 선택합니다. 단일 머신, 가져오기와 내보내기 분리, 여러 협업 노드.
Server SDK 응용 프로그램은 세 가지 배치 모양을 가지고 있으며 응용 프로그램의 규모는 어느 것을 사용하는지 결정합니다. Collaboration SDK, 수입 및 수출 및 이름 *와 함께 시작하면 모듈이 조립되는 방법을 볼 수 있습니다. 배포는 여러 노드가 동일한 어셈블리를 실행하는 방법을 결정합니다.
| 형태 | 협업 | 가져오기와 내보내기 | 권장 규모 |
|---|---|---|---|
| 단일 머신 | 노드 1개 | 같은 노드 | 로컬 애플리케이션, 개발과 테스트, 소수의 내부 사용자 |
| 가져오기와 내보내기 분리 | 노드 1개 | 별도 노드 | 다중 사용자 온라인 서비스, 노드 1개 용량 이내 |
| 여러 노드 | 여러 노드 | 별도 노드 | 노드 1개 용량을 넘거나 노드 장애 조치가 필요한 경우 |
단일 머신
모든 구성 요소는 단일 Node.js 프로세스에서 실행되며 브라우저는 직접 처리 할 수 있습니다.
- Database Adapter는
IDatabaseAdapter계약을 구현합니다. 데이터베이스 어댑터를 참고하세요. - 수입 및 수출은 교환 서비스 및 파일 서비스에 의해 제공됩니다. 협업 확장 모듈를 참조하십시오.
- 변환은 CPU-바운드이므로 큰 파일이 협업을 느립니다.
전환이 지연될 때 별도의 노드로 가져와 내보내기, 또는 서비스가 많은 사용자를 위해 응답해야 할 때.
가져오기와 내보내기 분리
단일 노드에 남아있는 동안 전용 노드에서 가져 오기 및 내보내기 실행. 게이트웨이는 두 가지 종류의 요청을 별도로 경로, 양쪽 모두 동일한 데이터베이스를 사용합니다.
가져 오기 및 내보내기 노드는 데이터베이스 어댑터, UniverCollabService, 파일 서비스 및 교환 서비스를 조립하고 데이터베이스와 직접 작동합니다. 주입 지점은 단일 기계와 동일합니다. 같은 파일 저장에서 노드 포인트 파일 서비스 모두 UniverCollabService에 동일한 권한 Middleware를 설치합니다.
Process Memory는 하나의 협업 노드가 제공될 수 있는 문서의 수를 제한합니다. 용량이 초과될 때 여러 노드로 이동하거나 장애가 필요할 때 실패합니다.
여러 협업 노드
여러 협업 노드는 동일한 데이터베이스에 대해 동일한 코드를 실행합니다. pub/sub 어댑터 릴레이 룸, 우선, 노드 사이 방송 및 티켓 저장 공유 세션 티켓. @univerjs-pro/collaboration-cluster-redis는 Redis 구현을 제공합니다. 모든 노드는 실행 노드의 수를 다루는 동일한 라이센스를 사용합니다. 협력 노드를 참조하십시오. 참고 구현을 위해 멀티 노드을 참조하십시오.
각 협업 노드는 Redis pub/sub 어댑터와 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 });더 나아가기
하나의 매우 큰 문서는 같은 노드에 작은 문서에 대한 요청을 느리게합니다. 문서 크기로 노드 풀을 분할하고 전용 풀에 큰 문서를 게이트웨이 경로로 배치하십시오. 라우팅 키는 여전히 단위 ID이며, 모든 풀은 데이터베이스와 pub/sub을 공유합니다.
이 가이드는 어떠셨나요?