Git 統合

Git 統合は現在次でのみ利用可能です ayaka-notes/overleaf 。

この機能は最初に開発されました ayaka-notes/overleaf-pro.

1

git-bridge を有効にする（Toolkit ユーザーのみ）

Toolkit を使用している場合、次を有効にします git-bridge あなたの中で次を設定することにより Toolkit が使用する config/overleaf.rc:

Toolkit が使用する config/overleaf.rc

GIT_BRIDGE_ENABLED=true

2

git-bridge コンテナを追加する（Docker-compose ユーザーのみ）

カスタムを実行しているユーザー向け docker-compose.yml、compose ファイルに次のコンテナ設定を追加してください：

docker-compose.yml（git-bridge サービス）

git-bridge：
    restart: always
    image: quay.io/sharelatex/git-bridge:4.0.0 # タグは `sharelatex` コンテナのタグと一致する必要があります
    volumes：
        - ~/git_bridge_data:/data/git-bridge
    container_name: git-bridge
    expose：
        - "8000"
    environment：
        GIT_BRIDGE_API_BASE_URL: "http://sharelatex:3000/api/v0/" 
        # バージョン 4.1.6 およびそれ以前では "http://sharelatex/api/v0/"
        GIT_BRIDGE_OAUTH2_SERVER: "http://sharelatex"
        GIT_BRIDGE_POSTBACK_BASE_URL: "http://git-bridge:8000"
        GIT_BRIDGE_ROOT_DIR: "/data/git-bridge"
    user: root
    command: ["/server-pro-start.sh"]

3

sharelatex コンテナの設定を更新する

また、次をリンクする必要があります git-bridge コンテナを sharelatex コンテナで、次の環境変数を定義してください。特に注意してください V2_HISTORY_URL:

docker-compose.yml（sharelatex サービス）

sharelatex:
    links：
        - git-bridge
    environment：
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
         # 現在は v1 を使用しています。以前に V1_HISTORY_URL を設定していた場合は、今すぐ更新してください
         V1_HISTORY_URL: "http://sharelatex:3054"

4

認証

git クライアントを認証する際、ユーザーはパーソナルアクセストークンが必要です。ユーザーはアプリケーションの UI を通じてパーソナルアクセストークンを管理できます（ドキュメント参照）：

Git 統合用パーソナルアクセストークン

5

監視とリソースに関する注意事項

有効にした後、ホストのリソースを監視することを推奨します git-bridge。負荷の増加は次に依存します：

• 機能にアクセスするユーザーの数

• インスタンスにホストされているプロジェクトの種類（大きなプロジェクトは一般によりリソースを消費します）

プロジェクトを S3 にスワップする

Git 統合は、ユーザーによってクローンされた各プロジェクトの完全な git リポジトリをディスクに保存します。ディスク容量が限られている場合、使用頻度の低いリポジトリを AWS S3 に移動するスワップジョブを有効にできます。スワップされたリポジトリが再度必要になった場合、それはディスクに戻されます。次の環境変数がスワップジョブを制御します：

名前	説明
GIT_BRIDGE_SWAPSTORE_TYPE	これを "s3" に設定するとスワップジョブが有効になります。
GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY	あなたの AWS アクセスキー
GIT_BRIDGE_SWAPSTORE_AWS_SECRET	あなたの AWS シークレット
GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME	このバケットには圧縮された git リポジトリが格納されます
GIT_BRIDGE_SWAPSTORE_AWS_REGION	バケットのリージョン
GIT_BRIDGE_SWAPJOB_MIN_PROJECTS	ディスク上に最低限保持するプロジェクト数。 - デフォルト： 50
GIT_BRIDGE_SWAPJOB_LOW_GIB	スワップの低水位。スワップジョブはディスク使用量がこの値を下回るまでプロジェクトを移動します。 - デフォルト： 128 GB
GIT_BRIDGE_SWAPJOB_HIGH_GIB	スワップの高水位。ディスク使用量がこの値に達するとスワップジョブが開始されます。 - デフォルト： 256 GB
GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS	ディスク使用量をチェックしてスワップジョブを実行するまでの間隔時間。 - デフォルト： 3600000 ms = 1 時間