水平スケーリング

バージョン3.5.6から、Server Proは水平スケーリングをサポートしています。

このドキュメントは技術要件を列挙し、複数ノードでServer Proを実行するためのガイドラインを提供します。

Server CE/Server Proの開始バージョンから 5.0.3 Overleaf CE/Server Pro 以降では 環境変数は から SHARELATEX_*.

からリブランドされて OVERLEAF_* バージョン（またはそれ以前）では、変数に適切にプレフィックスが付けられていることを確認してください（例： SHARELATEX_SITE_URL の代わりに OVERLEAF_SITE_URL)

水平スケーリングの設定には相当の作業が必要です。ある規模に達したときに水平スケーリングを検討することをお勧めします。 のみ 例として、合計1000ユーザー向けのServer Proインストールは、2つの4コアプロセッサと32GBのシステムメモリを備えた単一サーバで問題なくセットアップされています。詳細は ハードウェア要件 のドキュメントを参照してください。

水平スケーリングされたServer Proのデプロイには、ロードバランサやS3互換のストレージバックエンドなど一連の外部コンポーネントが関与します。

当社は、設定ミスによって生じる可能性のあるServer Proコンテナ内のエラーのトラブルシューティングを支援し、本ドキュメントに基づく一般的なアドバイスを提供できます。ただし、サードパーティのアプリケーション／システムの設定支援は提供できません。

外部コンポーネントを提供するためのハードウェア／ソフトウェア固有の技術的問題の解決は、当社のサポート範囲に含まれません。

要件

外部の中央データストレージ

Server Proのデータストレージは4つのデータストアに分割できます：

• MongoDB

  • データの大部分はMongoDBに永続化されます。

  • ローカルインスタンスか、次のような外部インスタンスのいずれかをサポートします、 MongoDB 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互換のデータストレージシステム のみ 水平スケーリングでは、

  S3互換のデータストレージシステムをサポートします。 重要： 使用してはいけません NFS/Amazon EFS/Amazon EBSは 水平スケーリングでサポートされています。詳細はServer Proのストレージスケーリングに関する ハードウェアストレージ

• の要件セクションを参照してください。

  • エフェメラルファイル

  • 最適なパフォーマンスのために、LaTeXのコンパイルは高速なローカルディスクで実行する必要があります。コンパイルの出力は永続化やバックアップを必ずしも必要としません。

新しいファイルアップロードのバッファリングやプロジェクトのzipファイル作成もローカルディスクを使用することで恩恵を受けます。

ローカルディスクの使用を強く推奨します。NFSやEBSのようなネットワークディスクを使用すると、予期せぬコンパイルエラーやその他のパフォーマンス問題が発生する可能性があります。

Git-bridge

Git-bridgeはServer Pro 4.0.1から利用可能です。 Gitリポジトリはローカルディスクに保存されます。レプリケーションオプションはありません。Git-bridgeはシングルトン

として実行する必要があります。最適なパフォーマンスのため、git-bridgeデータにはローカルディスクの使用を推奨します。git-bridgeのデータディスクは定期的にバックアップする必要があります。

• 水平スケーリングでのデータストレージには、次が必要です：

• すべてのServer Proインスタンスからアクセス可能な中央のMongoDBインスタンス

• すべてのServer Proインスタンスからアクセス可能な中央のRedisインスタンス

• プロジェクトおよび履歴ファイル用の中央のS3互換ストレージバックエンド

• 各インスタンスにおけるエフェメラルファイル用のローカルディスク

git-bridgeデータ用にgit-bridgeコンテナをホストするインスタンスのローカルディスク

• ロードバランサ要件永続的ルーティング

  （例：クッキーを使用）

  • この要件は以下のコンポーネントに由来します： Server Proのリアルタイム編集機能は、フォールバックとしてXHRポーリングを用いるWebSocketを使用します。各編集セッションはサーバ側にローカル状態を持ち、特定の編集セッションのリクエストは常に同じServer Proインスタンスにルーティングされる必要があります。コラボレーション機能は複数のServer Proインスタンス間での更新共有にRedisの Pub/Sub

  • を使用します。

• LaTeXコンパイルはパフォーマンス向上のために出力とコンパイルキャッシュをローカルに保持します。あるServer Proインスタンスにコンパイル要求を出した場合、以降のPDF/ログダウンロード要求は同じServer Proインスタンスにルーティングされる必要があります。 長いリクエストタイムアウト

• 大きなLaTeX文書のコンパイルをサポートするため WebSocketサポート

• 最適なパフォーマンスのため

• POSTペイロードサイズ50MB キープアライブタイムアウト

  Server Proのキープアライブタイムアウトより短くする必要があります NGINX_KEEPALIVE_TIMEOUTServer Proのキープアライブタイムアウトは環境変数で設定できます、

  デフォルト値は65秒です。

  デフォルト設定では、ロードバランサ側で60秒のキープアライブタイムアウトが機能します。 もしNGINX_KEEPALIVE_TIMEOUT=120

• を設定した場合、ロードバランサは115秒を選ぶ可能性があります。

  クライアントIP リクエストヘッダを設定してください X-Forwarded-For

• が にクライアントIPを含めること。

  SSL終端 ロードバランサはリクエストヘッダを追加する必要があります.

X-Forwarded-Proto: https

HAProxyのサンプル構成
  global
  group haproxy

  user haproxy
  # 詳細なログ出力

log stdout format raw local0 debug
  defaults
  mode                    http
  option                  httpchk HEAD /status
  http-check              expect status 200

  user haproxy
  default-server          check
  log                     global

  option                  httplog
  # スティッキーなバックエンドがダウンしている場合に別のバックエンドへ再ルーティング
  option                  redispatch 1
  # これらのリトライはTCP接続エラー用であり、HTTPステータス500の応答に対するものではありません

  retries                 3
  # 24時間の非アクティブでスティッキーセッション -- コンパイル出力は24時間後に削除されます

  cookie                  server-pro-ha insert maxidle 24h
  # 1分間どのバックエンドにも接続を試み、それから503を返す
  timeout queue           1m
  # Server Proインスタンスに起動のための15秒を与える

  timeout connect         15s
  # 非常に遅いクライアントからのリクエストを中断する（リクエスト読み取り時の非アクティブを1分許容）

  timeout client          1m
  # 遅いコンパイルを許容 -- clsiのハードコードされた上限は10分

  timeout server          10m
  # エディタを23時間後に切断 -- 昨日最後の使用の1時間前に合わせる

  timeout tunnel          23h
  # 注：haproxyのキープアライブ動作はServer Proのデフォルトキープアライブ設定と相性が良いです。

#       Haproxyはバックグラウンドで接続をクリーンアップし、必要に応じてリディスパッチします。
  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
  # アプリケーションに対してhttpsの背後にあることを伝える

  http-request set-header X-Forwarded-Proto https
  # アプリケーションに実際のクライアントIPを伝える

  option forwardfor
  # https://hstspreload.org/#deployment-recommendations を参照

  http-response set-header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload;"
  # gitトラフィックをgit-bridgeの兄弟コンテナへルーティングする

  use-server server-pro-ha-1 if { path_beg /git/ }
  # デバッグ
  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

• （ウェブAPI認証） および STAGING_PASSWORD V1_HISTORY_PASSWORD

• 同じ値（履歴認証） CRYPTO_RANDOM

• （セッションクッキー用） OT_JWT_AUTH_KEY

（履歴認証）

これらすべてのシークレットはそれぞれ固有の値で設定され、インスタンス間で共有される必要があります。

設定されていない場合、ユーザーのリクエストが異なるServer Proインスタンスにルーティングされると認証チェックに失敗し、頻繁にログインページにリダイレクトされたり、UIでの操作が予期せず失敗したりします。 設定されていない場合、Server Proは各シークレットに対して新しいランダム値を /dev/urandom

（256ランダムビット）に基づく32バイトのランダム値から生成します。
# https://github.com/overleaf/overleaf/blob/45ca0f796c679103efd305ddbef28073c4a5de32/server-ce/init_scripts/00_regen_sharelatex_secrets.sh#L14

MongoDB

dd if=/dev/urandom bs=1 count=32 2>/dev/null | base64 -w 0 | rev | cut -b 2- | rev | tr -d '\n+/' OVERLEAF_MONGO_URL (もしあなたが ポイント OVERLEAF_* バージョン

Redis

dd if=/dev/urandom bs=1 count=32 2>/dev/null | base64 -w 0 | rev | cut -b 2- | rev | tr -d '\n+/' OVERLEAF_REDIS_HOST (およびそれ以前）は中央のMongoDBインスタンスを指すようにしてください。 ポイント OVERLEAF_* SHARELATEX_REDIS_HOST REDIS_HOST およびそれ以前）および

中央のRedisインスタンスを指すようにしてください。

プロジェクトおよび履歴ファイル用のS3互換ストレージ S3 互換ストレージ 詳細についてはドキュメントの

の要件セクションを参照してください。

を参照してください。 /var/lib/overleaf (ローカルSSDのデフォルトのバインドマウント先は ポイント OVERLEAF_* /var/lib/sharelatex SANDBOXED_COMPILES およびそれ以前）で十分です。ホスト上のマウントポイントを必ず

に向けてください。

ローカルディスクの使用を強く推奨します。NFSやEBSのようなネットワークディスクを使用すると、予期せぬコンパイルエラーやその他のパフォーマンス問題が発生する可能性があります。

• プロキシの設定 設定してください (OVERLEAF_BEHIND_PROXY=true ポイント OVERLEAF_* SHARELATEX_BEHIND_PROXY

• プロキシの設定 およびそれ以前）は正確なクライアントIPのために。 TRUSTED_PROXY_IPS

ロードバランサのIPに設定してください（複数のCIDRはカンマで区切って指定できます）。

Git-bridge

Git-bridgeの統合

git-bridgeコンテナは受信するgitリクエストを処理するための兄弟Server Proコンテナを必要とします。この兄弟コンテナは通常のユーザートラフィックも処理できます。サンプル構成では最初のインスタンスがgit-bridgeの兄弟コンテナとして働きますが、実際にはどのインスタンスでもその役割を果たせます。

なぜgit-bridgeのために1つのServer Proコンテナを兄弟として指定する必要があるのか？Server Proは履歴サービス用のダウンロードURLをgit-bridgeに渡します。これらの履歴URLがgit-bridgeコンテナからアクセス可能であるように設定する必要があります。

• プロキシの設定 Server Proコンテナの設定： から GIT_BRIDGE_ENABLED

• プロキシの設定 'true' から GIT_BRIDGE_HOST <git-bridgeコンテナ名> git-bridge

• プロキシの設定 例： から 8000

• プロキシの設定 GIT_BRIDGE_PORT から V1_HISTORY_URL.

  http://<server-proの兄弟コンテナ名>:3100/api

注：これはgit-bridgeコンテナの兄弟コンテナ上でのみ必要です。他のインスタンスはデフォルトのlocalhostのURLを使用できます。

• プロキシの設定 git-bridgeコンテナの設定： から GIT_BRIDGE_API_BASE_URLで、例えば http://<server-proの兄弟コンテナ名>/api/v0

• プロキシの設定 http://server-pro-ha-1/api/v0 から GIT_BRIDGE_OAUTH2_SERVERで、例えば http://<server-proの兄弟コンテナ名>

• プロキシの設定 http://server-pro-ha-1 から GIT_BRIDGE_POSTBACK_BASE_URLで、例えば http://<git-bridgeコンテナ名>:8000

• プロキシの設定 http://git-bridge:8000 GIT_BRIDGE_ROOT_DIR バインドマウントされたgit-bridgeデータディスクを指す、例えば

/data/git-bridge

docker-compose.ymlのサンプル構成 OVERLEAF_SITE_URL (SHARELATEX_SITE_URL ポイント OVERLEAF_* 以下の構成は自己完結型のセットアップを示しています。デモを動作させるには有効なSSL鍵／証明書を用意し、

およびそれ以前）を調整する必要があります。実運用のセットアップでは、ダミーのシークレットを実際のシークレットに置き換える必要があります。また、実運用では個々のコンテナを専用ノードに移し、IPアドレスをローカルネットワークの設定に合わせて調整する必要があります。

version: '2.2'
# 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
    networks:
        default:
            ipam:
                config:
                # このサブネットはベンチマーク用に予約されたサブネットの一部です
                # https://tools.ietf.org/html/rfc2544
                # フルサブネットは198.18.0.0/15です
                # lbとdbsには198.18.0.0/24を使用してください
                # server-proには198.18.1.0/24を使用してください
                # エフェメラルコンテナには198.18.0.128/25を使用してください
                  - gateway: 198.18.0.1
                  ip_range: 198.18.0.128/25

services:
    subnet: 198.18.0.0/23
    # 実際の水平スケーリング設定：haproxyは別ホストでdocker外で実行してください。
        lb:
        image: haproxy:2.6
        user: root
        container_name: lb
            logging:
            driver: local
                options:
                max-size: 10g
        ボリューム:
            max-file: '100'
            - ./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
        # "ports"の代替：ホストネットワークを使用してdocker-proxyのオーバーヘッドを回避

        network_mode: host
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "80:80"
        #     - "443:443"
        # ports:
        # networks:
        #     default:

        #         ipv4_address: 198.18.0.2
        # 実際の水平スケーリング設定：これらは他のホストで実行されるためここから削除してください。
            depends_on:
                server-pro-ha-1:
            condition: service_started
                server-pro-ha-1:
            server-pro-ha-2:
                server-pro-ha-1:

    server-pro-ha-3:
    # 実際の水平スケーリング設定：このコンテナはserver-pro-ha-1の隣で実行してください。
    git-bridge：
        restart: always
        # Server Pro 4.0以降用。
        # タグは `server-pro-ha-1` コンテナのタグと一致する必要があります。
        ボリューム:
            image: quay.io/sharelatex/git-bridge:4.0.1
            - ~/git_bridge_data:/data/git-bridge
        container_name: git-bridge
        環境:
            # 実際の水平スケーリング設定：/data/git-bridgeを専用のローカルSSDにポイントしてください。
            GIT_BRIDGE_API_BASE_URL: "http://server-pro-ha-1/api/v0"
            GIT_BRIDGE_OAUTH2_SERVER: "http://server-pro-ha-1"
            GIT_BRIDGE_ROOT_DIR: "/data/git-bridge"
        user: root
        command: ["/server-pro-start.sh"]

        GIT_BRIDGE_POSTBACK_BASE_URL: "http://198.18.0.6:8000"
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "8000:8000"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.0.6で実行しポートを公開してください

    ipv4_address: 198.18.0.6
    # 実際の水平スケーリング設定：このコンテナは別ホストで実行してください。
        restart: always
        server-pro-ha-1: &server-pro-ha-config
        image: quay.io/sharelatex/sharelatex-pro:4.0.1
        container_name: server-pro-ha-1
        # 実際の水平スケーリング設定：これらは他のホストで実行されるためここから削除してください。
            hostname: server-pro-ha-1
            git-bridge：
                server-pro-ha-1:

            # 実際の水平スケーリング設定：このエントリは保持してください。
            mongo:
                # 実際の水平スケーリング設定：下記のものは他のホストで実行されるため削除してください。
            redis:
                server-pro-ha-1:
            condition: service_healthy
                server-pro-ha-1:
            minio:
                mongo_replica_set_setup:
            condition: service_completed_successfully
                mongo_replica_set_setup:
        minio_setup:
        ボリューム:
            stop_grace_period: 60s
            バージョン（またはそれ以前）を使用している場合、変数に適切なプレフィックスが付いていること（例：
        - /tmp/scratch-disk1:/var/lib/sharelatex
            environment: &server-pro-ha-environment
            # 実際の水平スケーリング設定：独自のドメイン／アプリ名を指定してください。
            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
            # 実際の水平スケーリング設定：安全な認証情報を選んでください。
            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
            # git-bridgeの兄弟インスタンスでのみ必要
            V1_HISTORY_URL: "http://server-pro-ha-1:3100/api"

            # /git-bridge
            # S3
            # 水平スケーリング
            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'
            # 実際の水平スケーリング設定：ロードバランサのIP
            TRUSTED_PROXY_IPS: 198.18.0.1,198.18.0.2

        # /水平スケーリング
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "80:80"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.1.1で実行しポートを公開してください

    ipv4_address: 198.18.0.6
    condition: service_started
        ipv4_address: 198.18.1.1
        <<: *server-pro-ha-config
        hostname: server-pro-ha-2
        ボリューム:
            container_name: server-pro-ha-2
            バージョン（またはそれ以前）を使用している場合、変数に適切なプレフィックスが付いていること（例：
        環境:
            - /tmp/scratch-disk2:/var/lib/sharelatex
            <<: *server-pro-ha-environment
            SANDBOXED_COMPILES_HOST_DIR: '/tmp/scratch-disk2/data/compiles'

        V1_HISTORY_URL: "http://localhost:3100/api"
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "80:80"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.1.2で実行しポートを公開してください

    ipv4_address: 198.18.0.6
    server-pro-ha-2:
        ipv4_address: 198.18.1.1
        ipv4_address: 198.18.1.2
        hostname: server-pro-ha-3
        ボリューム:
            container_name: server-pro-ha-3
            バージョン（またはそれ以前）を使用している場合、変数に適切なプレフィックスが付いていること（例：
        環境:
            - /tmp/scratch-disk2:/var/lib/sharelatex
            - /tmp/scratch-disk3:/var/lib/sharelatex
            SANDBOXED_COMPILES_HOST_DIR: '/tmp/scratch-disk2/data/compiles'

        SANDBOXED_COMPILES_HOST_DIR: '/tmp/scratch-disk3/data/compiles'
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "80:80"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.1.3で実行しポートを公開してください

    ipv4_address: 198.18.0.6
    condition: service_healthy
        ipv4_address: 198.18.1.3
        image: minio/minio:RELEASE.2023-05-18T00-05-36Z
        container_name: minio
        ボリューム:
            command: server /data
            # 実際の水平スケーリング設定：minioを複数ディスクで実行してください。詳細はminioのドキュメントを参照。
        環境:
            # S3
            - ~/minio_data:/data
            MINIO_ROOT_USER: MINIO_ROOT_USER

        MINIO_ROOT_PASSWORD: MINIO_ROOT_PASSWORD
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "9000:9000"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.0.5で実行しポートを公開してください

    ipv4_address: 198.18.0.5
    condition: service_completed_successfully
        # 実際の水平スケーリング設定：これらは他のホストで実行されるためここから削除してください。
            # 実際の水平スケーリング設定：このセットアップは別ホストで一度実行してください。
        - minio
        image: minio/mc:RELEASE.2023-05-18T16-59-00Z
        コマンド：
            entrypoint: sh
            # S3
            - |
                - '-c'
                mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD \
                - '-c'
                mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD \
                - '-c'
                mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD \
                || sleep 10 && \

                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

                mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD
                  {
                    "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/*"
                      }
                    ]
                  echo '

                mc alias set s3 http://198.18.0.5:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD
                  {
                    "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-filestore.json

                }' > policy-history.json
                # 前節のポリシーの内容をpolicy-filestore.jsonに入れてください
                mc admin policy create s3 overleaf-filestore policy-filestore.json
                mc admin policy attach s3 overleaf-filestore \
                  # 注意：バケット名を適宜置き換えてください。

                mc admin policy create s3 overleaf-history policy-history.json
                mc admin policy attach s3 overleaf-history \
                  --user=OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID || true

    ipv4_address: 198.18.0.6
    mongo:
        restart: always
        --user=OVERLEAF_HISTORY_S3_ACCESS_KEY_ID || true
        image: mongo:4.4
        container_name: mongo
        expose:
            - 27017
        ボリューム:
            command: "--replSet overleaf"
        - ~/mongo_data:/data/db
            healthcheck:
            test: echo 'db.stats().ok' | mongo localhost:27017/test --quiet
            interval: 10s
            timeout: 10s

        retries: 5
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "27017:27017"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.0.3で実行しポートを公開してください

    minio:
        --user=OVERLEAF_HISTORY_S3_ACCESS_KEY_ID || true
        image: minio/mc:RELEASE.2023-05-18T16-59-00Z
        # 実際の水平スケーリング設定：これらは他のホストで実行されるためここから削除してください。
            mongo:
                # 実際の水平スケーリング設定：下記のものは他のホストで実行されるため削除してください。
        コマンド：
            entrypoint: sh
            - |
                ipv4_address: 198.18.0.3

    ipv4_address: 198.18.0.6
    redis:
        restart: always
        mongo 198.18.0.3 --eval "rs.initiate({ _id: \"overleaf\", members: [ { _id: 0, host: \"198.18.0.3:27017\" } ] })"
        image: redis:6.2
        expose:
            - 6379
        ボリューム:
            container_name: redis

        - ~/redis_data:/data
        # "network_mode: host"の代替：ネットワーク分離のためにdocker-proxyを使用
        #     - "6379:6379"
        # 実際の水平スケーリング設定：独自のネットワークを選び、設定内のIPを置き換えてください。
            networks:
                # 実際の水平スケーリング設定：ホスト198.18.0.4で実行しポートを公開してください

ipv4_address: 198.18.0.4

ハードウェア

水平スケーリングに参加するすべてのServer Proインスタンスで同じハードウェア仕様を使用することを推奨します。 一般的な推奨事項は Server Proインスタンス向けのハードウェア仕様

に適用されます。

Server Proのアップグレード 使用してはいけません アップグレードの一環として、Server Proは自動的にデータベースマイグレーションを実行します。これらのマイグレーションは

並列に複数インスタンスから実行されることを想定して設計されています。 マイグレーションは実際のウェブアプリケーションが起動する前に終了する必要があります。ログに Finished migrations

のエントリがあるかを確認するか、アプリケーションがトラフィックを受け入れるまで待つことができます。

1. アップグレード手順は次のようになります：

2. メンテナンス時間を予定する

3. すべてのServer Proインスタンスを停止する 一貫性のあるバックアップを取り（ドキュメントに記載の方法で）、

4. ドキュメント

5. を参照してください。

6. 新バージョンで単一のServer Proインスタンスを起動する。」「t393":"新しいインスタンスが期待通りに動作することを検証する。","t394":"他のインスタンスを新バージョンで起動する"}