> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 水平扩展 Ayakaleaf Pro 支持水平扩展。我们已经过测试并验证它在多副本情况下可以正常运行。本文档列出了在多个节点上运行 Ayakaleaf Pro 的技术要求，并提供相关指南。从 Server CE/Server Pro `5.0.3` 开始，环境变量已从 `SHARELATEX_*` 更名为 `OVERLEAF_*`。如果你使用的是 `4.x` 版本（或更早版本），请确保变量使用相应的前缀（例如使用 `SHARELATEX_SITE_URL` 而不是 `OVERLEAF_SITE_URL`）设置水平扩展需要投入大量精力。我们建议**仅**在达到一定规模时才考虑水平扩展。举例来说，一个面向总计 1,000 名用户的 Server Pro 安装，已成功部署在一台配备两颗 4 核处理器和 32GB 系统内存的服务器上。有关建议，请参阅[硬件要求](/zh-CN/on-premises/getting-started/requirements/hardware-requirements)文档。采用水平扩展的 Server Pro 部署涉及一系列外部组件，例如负载均衡器和 S3 兼容的存储后端。我们可以帮助排查 Server Pro 容器中可能因配置错误而导致的错误，并根据本文档提供一般性建议。遗憾的是，我们无法协助配置第三方应用程序/系统。解决与你用于提供外部组件的硬件/软件相关的特定技术问题，不在我们的支持条款范围内。 ### 要求

#### 外部集中式数据存储 Server Pro 中的数据存储可分为四类数据存储： * **MongoDB** * 大部分数据持久化存储在 MongoDB 中。 * 我们支持本地实例或外部实例，例如 [MongoDB](https://www.mongodb.com/atlas) Atlas（在 AWS 基础设施内运行的全托管 MongoDB 服务）。
注意： 遗憾的是，目前我们尚未正式支持 CosmoDB/DocumentDB 等 MongoDB 兼容数据库，因为我们没有用它们测试过 Server Pro。虽然使用兼容数据库部署 Server Pro **可能**可行，但我们仅正式支持使用 MongoDB 的部署。
* **Redis** * Redis 存储临时数据，例如在刷新到 MongoDB 之前待处理的文档更新。 * Redis 用于在不同服务之间传递文档更新，并通知编辑器某个项目中的状态变化。 * Redis 用于存储用户会话。 * 我们支持本地实例或外部实例。
注意： 遗憾的是，目前我们尚未正式支持 KeyDB/Valkey 等 Redis 兼容的键值存储，因为我们没有用它们测试过 Server Pro。虽然使用兼容存储部署 Server Pro **可能**可行，但我们仅正式支持使用 Redis 的部署。
* **项目文件和历史文件** * 不可编辑的项目文件存储在 MongoDB 之外。新的项目历史系统（Server Pro 3.5 及以后版本）同样将历史记录存储在 MongoDB 之外。 * 对于小型单实例部署，我们支持本地文件系统（可以由本地 SSD、NFS 或 EBS 提供支持）或 [S3 兼容的数据存储系统](/zh-CN/on-premises/configuration/overleaf-toolkit/s3)。 * 对于水平扩展，我们**仅**支持 S3 兼容的数据存储系统。
重要： 水平扩展**不**支持 NFS/Amazon EFS/Amazon EBS。有关 Server Pro 存储扩展的更多详情，请参阅[硬件存储](/zh-CN/on-premises/getting-started/requirements/hardware-requirements#storage)要求部分。 * **临时文件** * 为获得最佳性能，LaTeX 编译需要在快速的本地磁盘上运行。编译输出无需持久化或备份。 * 新上传文件的缓冲以及项目 zip 文件的创建同样受益于使用本地磁盘。我们强烈建议使用本地磁盘。使用任何类型的网络磁盘（例如 NFS 或 EBS）都可能导致意外的编译错误和其他性能问题。 #### **Git-bridge** Server Pro 从 4.0.1 版本开始提供 Git-bridge。 git 仓库存储在本地磁盘上，没有可用的复制选项。Git-bridge 应以**单例**方式运行。为获得最佳性能，我们建议为 git-bridge 数据使用本地磁盘。git-bridge 数据磁盘应定期备份。对于水平扩展的数据存储，你需要： * 一个可供所有 Server Pro 实例访问的集中式 MongoDB 实例 * 一个可供所有 Server Pro 实例访问的集中式 Redis 实例 * 一个用于存放项目文件和历史文件的集中式 S3 兼容存储后端 * 每个实例上用于临时文件的本地磁盘 * 托管 git-bridge 容器的实例上用于 git-bridge 数据的本地磁盘 #### 负载均衡器要求 * **持久路由**，例如使用 cookie 这一要求源自以下组件： * Server Pro 中的实时编辑功能使用 WebSocket，并以 XHR 轮询作为回退方案。每个编辑会话在服务器端都有本地状态，因此同一编辑会话的请求必须始终路由到同一个 Server Pro 实例。协作功能使用 Redis [Pub/Sub](https://redis.io/docs/latest/develop/interact/pubsub/) 在多个 Server Pro 实例之间共享更新。 * 为了优化性能，LaTeX 编译会将输出和编译缓存保存在本地。向某个 Server Pro 实例发出编译请求后，后续的 PDF/日志下载请求需要路由到同一个 Server Pro 实例。 * **较长的请求超时时间**，以支持大型 LaTeX 文档的编译 * **WebSocket 支持**，以获得最佳性能 * **50MB 的 POST 负载大小** * **Keep-alive 超时时间**必须低于 Server Pro 的 keep-alive 超时时间 Server Pro 中的 keep-alive 超时时间可以通过环境变量 `NGINX_KEEPALIVE_TIMEOUT` 进行配置，默认值为 65s。在默认值下，负载均衡器中设置 60s 的 keep-alive 超时时间即可正常工作。如果设置 `NGINX_KEEPALIVE_TIMEOUT=120`，负载均衡器可以选择 115s。 * **客户端 IP** 将请求头 `X-Forwarded-For` 设置为客户端 IP。 * **终止 SSL** 时负载均衡器需要添加请求头 `X-Forwarded-Proto: https`。 ```text theme={null} global group haproxy user haproxy # Verbose logging log stdout format raw local0 debug defaults mode http option httpchk HEAD /status http-check expect status 200 default-server check # Verbose logging log global option httplog # Reroute to a different backend if the sticky one is down option redispatch 1 # These retries are for TCP connect errors, not on HTTP status 500 responses retries 3 # Sticky session for 24h of inactivity -- compile output is deleted after 24h cookie server-pro-ha insert maxidle 24h # Try to connect to any backend for 1min, then return 503 timeout queue 1m # Give Server Pro instances 15s to startup timeout connect 15s # Abort requests from very slow clients (allow 1min of inactivity when reading a request) timeout client 1m # Allow slow compiles -- hard-coded limit in clsi is 10min timeout server 10m # Disconnect the editor after 23h -- 1h ahead of their last use yesterday timeout tunnel 23h # Note: The keepalive behavior in haproxy works great with the default keepalive setup in Server Pro. # Haproxy is cleaning up connections in the background and it will redispatch requests when needed. listen server-pro-ha-http bind :80 http-request redirect scheme https unless { ssl_fc } listen server-pro-ha-https bind :443 ssl crt /etc/ssl/certs/ssl-key-and-certificate-bundle.pem # Tell the application that we are behind https http-request set-header X-Forwarded-Proto https # Tell the application the actual client ip option forwardfor # See https://hstspreload.org/#deployment-recommendations http-response set-header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload;" # Route git traffic to the sibling container of the git-bridge use-server server-pro-ha-1 if { path_beg /git/ } # Debugging http-response add-header X-Served-By %s stats enable stats uri /haproxy server server-pro-ha-1 198.18.1.1:80 cookie server-pro-ha-1 server server-pro-ha-2 198.18.1.2:80 cookie server-pro-ha-2 server server-pro-ha-3 198.18.1.3:80 cookie server-pro-ha-3 ``` #### Server Pro 配置 **密钥** 各 Server Pro 实例需要使用一致的共享密钥： * `WEB_API_PASSWORD`（web api 认证） * `STAGING_PASSWORD` 和 `V1_HISTORY_PASSWORD` 使用相同的值（历史认证） * `CRYPTO_RANDOM`（用于会话 cookie） * `OT_JWT_AUTH_KEY`（历史认证）所有这些密钥都需要配置各自唯一的值，并在各实例之间共享。如果未进行配置，当用户请求被路由到不同的 Server Pro 实例时，请求将无法通过认证检查，用户要么会频繁被重定向到登录页面，要么在 UI 中的操作会以意想不到的方式失败。如果未进行配置，Server Pro 会为每个密钥使用一个新的随机值，该值基于从 `/dev/urandom` 读取的 32 个随机字节（256 个随机位）。 ```bash wrap theme={null} # https://github.com/overleaf/overleaf/blob/45ca0f796c679103efd305ddbef28073c4a5de32/server-ce/init_scripts/00_regen_sharelatex_secrets.sh#L14 dd if=/dev/urandom bs=1 count=32 2>/dev/null | base64 -w 0 | rev | cut -b 2- | rev | tr -d '\n+/' ``` **MongoDB** 将 `OVERLEAF_MONGO_URL`（`4.x` 及更早版本为 `SHARELATEX_MONGO_URL`）指向集中式 MongoDB 实例。 **Redis** 将 `OVERLEAF_REDIS_HOST`（`4.x` 及更早版本为 `SHARELATEX_REDIS_HOST`）和 `REDIS_HOST` 指向集中式 Redis 实例。 **用于项目文件和历史文件的 S3 兼容存储** 详情请参阅 [S3 兼容存储](/zh-CN/on-premises/configuration/overleaf-toolkit/s3)文档。 **临时文件** 默认将本地 SSD 绑定挂载到 `/var/lib/overleaf`（`4.x` 及更早版本为 `/var/lib/sharelatex`）即可满足需求。请务必将 `SANDBOXED_COMPILES_HOST_DIR` 指向宿主机上的挂载点。我们强烈建议使用本地磁盘。使用任何类型的网络磁盘（例如 NFS 或 EBS）都可能导致意外的编译错误和其他性能问题。 **代理配置** * 设置 `OVERLEAF_BEHIND_PROXY=true`（`4.x` 及更早版本为 `SHARELATEX_BEHIND_PROXY`）以获取准确的客户端 IP。 * 将 `TRUSTED_PROXY_IPS` 设置为负载均衡器的 IP（可以指定多个 CIDR，以逗号分隔）。 **Git-bridge 集成** Server Pro 从 4.0.1 版本开始提供 Git-bridge。 git-bridge 容器需要一个配套的 Server Pro 容器来处理传入的 git 请求。该配套容器也可以处理常规用户流量。在示例配置中，第一个实例充当 git-bridge 的配套容器，但实际上任何实例都可以承担这一角色。为什么需要指定一个 Server Pro 容器作为 git-bridge 的配套容器？因为 Server Pro 会向 git-bridge 提供历史服务的下载 URL，我们需要将这些历史 URL 配置为可从 git-bridge 容器访问。 Server Pro 容器配置： * 将 `GIT_BRIDGE_ENABLED` 设置为 `'true'` * 将 `GIT_BRIDGE_HOST` 设置为 ``，例如 `git-bridge` * 将 `GIT_BRIDGE_PORT` 设置为 `8000` * 将 `V1_HISTORY_URL` 设置为 `http://:3100/api`。注意：仅 git-bridge 容器的配套容器需要进行此设置。其他实例可以使用 localhost URL，即默认值。 git-bridge 容器配置： * 将 `GIT_BRIDGE_API_BASE_URL` 设置为 `http:///api/v0`，例如 `http://server-pro-ha-1/api/v0` * 将 `GIT_BRIDGE_OAUTH2_SERVER` 设置为 `http://`，例如 `http://server-pro-ha-1` * 将 `GIT_BRIDGE_POSTBACK_BASE_URL` 设置为 `http://:8000`，例如 `http://git-bridge:8000` * 将 `GIT_BRIDGE_ROOT_DIR` 设置为绑定挂载的 git-bridge 数据磁盘，例如 `/data/git-bridge` 以下配置展示了一个自包含的部署。要使该演示正常运行，你需要提供有效的 SSL 密钥/证书，并调整 `OVERLEAF_SITE_URL`（`4.x` 及更早版本为 `SHARELATEX_SITE_URL`）。在实际部署中，你必须按照行内注释的说明，将虚拟密钥替换为真实密钥。在实际部署中，你还需要将各个容器迁移到专用节点上，并根据你的本地网络设置调整 IP 地址。 ```yaml theme={null} version: '2.2' # Actual horizontal scaling setup: pick your own network and replace IPs in config. networks: default: ipam: config: # This subnet is part of a reserved subnet used for benchmarking # https://tools.ietf.org/html/rfc2544 # The full subnet is 198.18.0.0/15 # Use 198.18.0.0/24 for lb and dbs # Use 198.18.1.0/24 for server-pro # Use 198.18.0.128/25 for ephemeral container - gateway: 198.18.0.1 ip_range: 198.18.0.128/25 subnet: 198.18.0.0/23 services: # Actual horizontal scaling setup: run haproxy outside docker on a separate host. lb: image: haproxy:2.6 container_name: lb user: root logging: driver: local options: max-size: 10g max-file: '100' volumes: - ./haproxy.conf:/usr/local/etc/haproxy/haproxy.cfg # $ cat certificate.pem key.pem > ssl-key-and-certificate-bundle.pem - /path/to/ssl-key-and-certificate-bundle.pem:/etc/ssl/certs/ssl-key-and-certificate-bundle.pem # Alternative to "ports": use host network to avoid docker-proxy overhead network_mode: host # Alternative to "network_mode: host": use docker-proxy for network isolation # ports: # - "80:80" # - "443:443" # networks: # default: # ipv4_address: 198.18.0.2 # Actual horizontal scaling setup: remove these as they run on other hosts. depends_on: server-pro-ha-1: condition: service_started server-pro-ha-2: condition: service_started server-pro-ha-3: condition: service_started # Actual horizontal scaling setup: run this container next to server-pro-ha-1. # For Server Pro 4.0 onwards. git-bridge: restart: always # The tag should match the `server-pro-ha-1` container tag. image: quay.io/sharelatex/git-bridge:4.0.1 volumes: # Actual horizontal scaling setup: point /data/git-bridge at a dedicated local ssd. - ~/git_bridge_data:/data/git-bridge container_name: git-bridge environment: GIT_BRIDGE_API_BASE_URL: "http://server-pro-ha-1/api/v0" GIT_BRIDGE_OAUTH2_SERVER: "http://server-pro-ha-1" GIT_BRIDGE_POSTBACK_BASE_URL: "http://198.18.0.6:8000" GIT_BRIDGE_ROOT_DIR: "/data/git-bridge" user: root command: ["/server-pro-start.sh"] # Actual horizontal scaling setup: run on host 198.18.0.6 and expose port # ports: # - "8000:8000" networks: default: ipv4_address: 198.18.0.6 # Actual horizontal scaling setup: run this container on a separate host. server-pro-ha-1: &server-pro-ha-config restart: always image: quay.io/sharelatex/sharelatex-pro:4.0.1 container_name: server-pro-ha-1 hostname: server-pro-ha-1 depends_on: # Actual horizontal scaling setup: keep this entry. git-bridge: condition: service_started # Actual horizontal scaling setup: remove the ones below as they run on other hosts. mongo: condition: service_healthy redis: condition: service_started minio: condition: service_started mongo_replica_set_setup: condition: service_completed_successfully minio_setup: condition: service_completed_successfully stop_grace_period: 60s volumes: - /tmp/scratch-disk1:/var/lib/sharelatex - /var/run/docker.sock:/var/run/docker.sock environment: &server-pro-ha-environment # Actual horizontal scaling setup: provide your own domain/app name. OVERLEAF_SITE_URL: 'https://overleaf.example.com' OVERLEAF_APP_NAME: Server Pro Horizontal Scaling Demo OVERLEAF_MONGO_URL: mongodb://198.18.0.3/sharelatex OVERLEAF_REDIS_HOST: 198.18.0.4 REDIS_HOST: 198.18.0.4 ENABLED_LINKED_FILE_TYPES: 'project_file,project_output_file' EMAIL_CONFIRMATION_DISABLED: 'true' SANDBOXED_COMPILES: 'true' SANDBOXED_COMPILES_SIBLING_CONTAINERS: 'true' SANDBOXED_COMPILES_HOST_DIR: '/tmp/scratch-disk1/data/compiles' # S3 # Actual horizontal scaling setup: pick secure credentials. OVERLEAF_FILESTORE_BACKEND: s3 OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME: overleaf-user-files OVERLEAF_FILESTORE_TEMPLATE_FILES_BUCKET_NAME: overleaf-template-files OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID: OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY: OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY OVERLEAF_FILESTORE_S3_ENDPOINT: http://198.18.0.5:9000 OVERLEAF_FILESTORE_S3_PATH_STYLE: 'true' OVERLEAF_FILESTORE_S3_REGION: '' OVERLEAF_HISTORY_BACKEND: "s3" OVERLEAF_HISTORY_PROJECT_BLOBS_BUCKET: "overleaf-project-blobs" OVERLEAF_HISTORY_CHUNKS_BUCKET: "overleaf-chunks" OVERLEAF_HISTORY_S3_ACCESS_KEY_ID: "OVERLEAF_HISTORY_S3_ACCESS_KEY_ID" OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY: "OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY" OVERLEAF_HISTORY_S3_ENDPOINT: http://198.18.0.5:9000 OVERLEAF_HISTORY_S3_PATH_STYLE: 'true' OVERLEAF_HISTORY_S3_REGION: '' # /S3 # git-bridge GIT_BRIDGE_ENABLED: 'true' GIT_BRIDGE_HOST: 198.18.0.6 GIT_BRIDGE_PORT: 8000 # Only needed on the sibling instance of git-bridge V1_HISTORY_URL: "http://server-pro-ha-1:3100/api" # /git-bridge # Horizontal scaling # Actual horizontal scaling setup: pick secure credentials. WEB_API_PASSWORD: WEB_API_PASSWORD STAGING_PASSWORD: V1_HISTORY_PASSWORD V1_HISTORY_PASSWORD: V1_HISTORY_PASSWORD CRYPTO_RANDOM: CRYPTO_RANDOM OT_JWT_AUTH_KEY: OT_JWT_AUTH_KEY OVERLEAF_BEHIND_PROXY: 'true' # Actual horizontal scaling setup: IPs of load balancers TRUSTED_PROXY_IPS: 198.18.0.1,198.18.0.2 # /Horizontal scaling # Actual horizontal scaling setup: run on host 198.18.1.1 and expose ports # ports: # - "80:80" networks: default: ipv4_address: 198.18.1.1 # Actual horizontal scaling setup: run this container on a separate host. server-pro-ha-2: <<: *server-pro-ha-config hostname: server-pro-ha-2 container_name: server-pro-ha-2 volumes: - /tmp/scratch-disk2:/var/lib/sharelatex - /var/run/docker.sock:/var/run/docker.sock environment: <<: *server-pro-ha-environment SANDBOXED_COMPILES_HOST_DIR: '/tmp/scratch-disk2/data/compiles' V1_HISTORY_URL: "http://localhost:3100/api" # Actual horizontal scaling setup: run on host 198.18.1.2 and expose ports # ports: # - "80:80" networks: default: ipv4_address: 198.18.1.2 # Actual horizontal scaling setup: run this container on a separate host. server-pro-ha-3: <<: *server-pro-ha-config hostname: server-pro-ha-3 container_name: server-pro-ha-3 volumes: - /tmp/scratch-disk3:/var/lib/sharelatex - /var/run/docker.sock:/var/run/docker.sock environment: <<: *server-pro-ha-environment SANDBOXED_COMPILES_HOST_DIR: '/tmp/scratch-disk3/data/compiles' V1_HISTORY_URL: "http://localhost:3100/api" # Actual horizontal scaling setup: run on host 198.18.1.3 and expose ports # ports: # - "80:80" networks: default: ipv4_address: 198.18.1.3 # Actual horizontal scaling setup: run this container on a separate host. minio: image: minio/minio:RELEASE.2023-05-18T00-05-36Z container_name: minio command: server /data volumes: # Actual horizontal scaling setup: run minio with multiple disks, see minio docs. - ~/minio_data:/data environment: # Actual horizontal scaling setup: pick secure credentials. MINIO_ROOT_USER: MINIO_ROOT_USER MINIO_ROOT_PASSWORD: MINIO_ROOT_PASSWORD # Actual horizontal scaling setup: run on host 198.18.0.5 and expose port # ports: # - "9000:9000" networks: default: ipv4_address: 198.18.0.5 # Actual horizontal scaling setup: run this setup once on a separate host. minio_setup: depends_on: - minio image: minio/mc:RELEASE.2023-05-18T16-59-00Z entrypoint: sh command: - '-c' # Actual horizontal scaling setup: pick secure credentials. - | mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD \ || sleep 10 && \ mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD \ || sleep 10 && \ mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD \ || sleep 10 && \ mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD mc mb --ignore-existing s3/overleaf-user-files mc mb --ignore-existing s3/overleaf-template-files mc admin user add s3 \ OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID \ OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY mc mb --ignore-existing s3/overleaf-project-blobs mc mb --ignore-existing s3/overleaf-chunks mc admin user add s3 \ OVERLEAF_HISTORY_S3_ACCESS_KEY_ID \ OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY echo ' { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-user-files" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-user-files/*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-template-files" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-template-files/*" } ] }' > policy-filestore.json echo ' { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-project-blobs" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-project-blobs/*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-chunks" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-chunks/*" } ] }' > policy-history.json # Put the contents of the policy from the previous section in policy-filestore.json # Reminder: Replace the bucket names accordingly. mc admin policy create s3 overleaf-filestore policy-filestore.json mc admin policy attach s3 overleaf-filestore \ --user=OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID || true mc admin policy create s3 overleaf-history policy-history.json mc admin policy attach s3 overleaf-history \ --user=OVERLEAF_HISTORY_S3_ACCESS_KEY_ID || true # Actual horizontal scaling setup: run this container on a separate host. mongo: restart: always image: mongo:4.4 container_name: mongo command: "--replSet overleaf" expose: - 27017 volumes: - ~/mongo_data:/data/db healthcheck: test: echo 'db.stats().ok' | mongo localhost:27017/test --quiet interval: 10s timeout: 10s retries: 5 # Actual horizontal scaling setup: run on host 198.18.0.3 and expose port # ports: # - "27017:27017" networks: default: ipv4_address: 198.18.0.3 mongo_replica_set_setup: image: mongo:4.4 entrypoint: sh depends_on: mongo: condition: service_healthy command: - '-c' - | mongo 198.18.0.3 --eval "rs.initiate({ _id: \"overleaf\", members: [ { _id: 0, host: \"198.18.0.3:27017\" } ] })" # Actual horizontal scaling setup: run this container on a separate host. redis: restart: always image: redis:6.2 container_name: redis expose: - 6379 volumes: - ~/redis_data:/data # Actual horizontal scaling setup: run on host 198.18.0.4 and expose port # ports: # - "6379:6379" networks: default: ipv4_address: 198.18.0.4 ``` #### 硬件我们建议所有参与水平扩展的 Server Pro 实例使用相同的硬件规格。关于 Server Pro 实例[硬件规格](/zh-CN/on-premises/getting-started/requirements/hardware-requirements)的一般性建议同样适用。 #### 升级 Server Pro 作为升级过程的一部分，Server Pro 会自动运行数据库迁移。这些迁移**并非**设计为可在多个实例上并行运行。迁移需要在实际的 Web 应用程序启动之前完成。你可以检查日志中是否出现 `Finished migrations` 条目，或者等待应用程序开始接受流量。升级流程如下： 1. 安排一个维护窗口 2. 停止所有 Server Pro 实例 3. 按照[文档](/zh-CN/on-premises/maintenance/data-and-backups#performing-a-consistent-backup)中的说明进行一致性备份 4. 使用新版本启动单个 Server Pro 实例 5. 验证新实例是否按预期工作 6. 使用新版本启动其他实例 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.