> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/git-integration.md).

# Git 통합

Git 통합은 현재 다음에서만 사용 가능합니다 [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) 현재.

{% hint style="info" %}
이 기능은 처음에 개발되었습니다 [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% stepper %}
{% step %}

### git-bridge를 활성화하세요(툴킷 사용자만)

툴킷을 사용 중이라면, 다음을 활성화하세요 `git-bridge` 다음과 같이 설정하여 `config/overleaf.rc`:

{% code title="config/overleaf.rc" %}

```
GIT_BRIDGE_ENABLED=true
```

{% endcode %}
{% endstep %}

{% step %}

### git-bridge 컨테이너를 추가하세요(Docker Compose 사용자만)

사용자 지정 구성을 사용하는 사용자는 `docker-compose.yml`다음 컨테이너 구성을 compose 파일에 추가하세요:

{% code title="docker-compose.yml (git-bridge 서비스)" overflow="wrap" %}

```yaml
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"]
```

{% endcode %}
{% endstep %}

{% step %}

### sharelatex 컨테이너 구성을 업데이트하세요

다음도 연결해야 합니다 `git-bridge` 에서 컨테이너를 `sharelatex` 컨테이너를 연결하고 다음 환경 변수를 정의하세요. 다음 사항에 주의하세요: `V1_HISTORY_URL`:

<pre class="language-yaml" data-title="docker-compose.yml (sharelatex 서비스)"><code class="lang-yaml">sharelatex:
    links:
        - git-bridge
    environment:
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
<strong>         # 이제 v1을 사용합니다. 이전에 V1_HISTORY_URL을 설정했다면 지금 업데이트하세요
</strong><strong>         V1_HISTORY_URL: "http://sharelatex:3054"
</strong></code></pre>

{% endstep %}

{% step %}

### 인증

git 클라이언트를 인증할 때 사용자는 개인 액세스 토큰이 필요합니다. 사용자는 애플리케이션 UI(문서 참조)에서 개인 액세스 토큰을 관리할 수 있습니다:

<figure><img src="/files/7e56cc12b755658147279036d255721d7ec6683a" alt=""><figcaption><p>Git 통합 개인 액세스 토큰</p></figcaption></figure>
{% endstep %}

{% step %}

### 모니터링 및 리소스 고려 사항

다음을 활성화한 후 호스트 리소스를 모니터링할 것을 권장합니다 `git-bridge`. 부하 증가 정도는 다음에 따라 달라집니다:

* 기능에 접근하는 사용자 수
* 인스턴스에서 호스팅되는 프로젝트 유형(일반적으로 더 큰 프로젝트일수록 더 많은 리소스를 사용합니다)
  {% endstep %}
  {% endstepper %}

### 프로젝트를 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`     | <p>최소한 디스크에 유지할 프로젝트 수입니다.<br><br><strong>- 기본값:</strong> 50</p>                                          |
| `GIT_BRIDGE_SWAPJOB_LOW_GIB`          | <p>스왑을 위한 낮은 임계값입니다. 스왑 작업은 디스크 사용량이 이 값보다 낮아질 때까지 프로젝트를 이동합니다.<br><br><strong>- 기본값:</strong> 128 GB</p> |
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB`         | <p>스왑을 위한 높은 임계값입니다. 디스크 사용량이 이 값에 도달하면 스왑 작업이 시작됩니다.<br><br><strong>- 기본값:</strong> 256 GB</p>           |
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS`  | <p>디스크 사용량을 확인하고 스왑 작업을 실행하는 사이의 시간입니다.<br><br><strong>- 기본값:</strong> 3600000 ms = 1시간</p>               |

### Q\&A

<details>

<summary>프로젝트를 다른 사람과 공유하면 Git Bridge 권한 모델은 어떻게 작동하나요?</summary>

읽기 전용 권한이 있는 사용자는 이 프로젝트를 클론만 할 수 있고, 읽기/쓰기 권한이 있는 사용자는 프로젝트를 클론하고 푸시할 수 있습니다. 참고: 사용자가 이 프로젝트에 참여하려면 로그인되어 있어야 합니다.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/git-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.