> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/tr/yapilandirma/overleaf-toolkit/git-integration.md).

# Git entegrasyonu

Git entegrasyonu yalnızca şu adreste kullanılabilir [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) şu anda.

{% hint style="info" %}
Bu özellik başlangıçta geliştirildi [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% stepper %}
{% step %}

### git-bridge'i etkinleştirin (Yalnızca Toolkit kullanıcıları için)

Toolkit'i kullanıyorsanız, şunu etkinleştirin `git-bridge` aşağıdakileri şuraya ekleyerek `config/overleaf.rc`:

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

```
GIT_BRIDGE_ENABLED=true
```

{% endcode %}
{% endstep %}

{% step %}

### git-bridge kapsayıcısını ekleyin (Yalnızca Docker Compose kullanıcıları için)

Özel bir `docker-compose.yml`, compose dosyanıza aşağıdaki kapsayıcı yapılandırmasını ekleyin:

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

```yaml
git-bridge:
    restart: always
    image: quay.io/sharelatex/git-bridge:4.0.0 # etiket, `sharelatex` kapsayıcı etiketleriyle eşleşmelidir
    birimler:
        - ~/git_bridge_data:/data/git-bridge
    container_name: git-bridge
    expose:
        - "8000"
    ortam:
        GIT_BRIDGE_API_BASE_URL: "http://sharelatex:3000/api/v0/" 
        # 4.1.6 ve daha önceki sürümler için "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 kapsayıcısı yapılandırmasını güncelleyin

Ayrıca şunu da bağlamanız gerekir: `git-bridge` kapsayıcısını `sharelatex` kapsayıcısını bağlayın ve aşağıdaki ortam değişkenlerini tanımlayın, lütfen şuna dikkat edin: `V1_HISTORY_URL`:

<pre class="language-yaml" data-title="docker-compose.yml (sharelatex hizmeti)"><code class="lang-yaml">sharelatex:
    links:
        - git-bridge
    ortam:
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
<strong>         # Artık v1 kullanıyoruz; daha önce V1_HISTORY_URL ayarladıysanız, lütfen şimdi güncelleyin
</strong><strong>         V1_HISTORY_URL: "http://sharelatex:3054"
</strong></code></pre>

{% endstep %}

{% step %}

### Kimlik Doğrulama

Bir git istemcisinin kimliğini doğrularken kullanıcıların Kişisel Erişim Belirteci gerekir. Kullanıcılar Kişisel Erişim Belirteçlerini uygulama arayüzü üzerinden yönetebilirler (belgelere bakın):

<figure><img src="/files/b94e7ec1a5eb7e1ae70235e87f9cc6275ea7aaa9" alt=""><figcaption><p>Git entegrasyonu Kişisel Erişim Belirteci</p></figcaption></figure>
{% endstep %}

{% step %}

### İzleme ve kaynak hususları

şunu etkinleştirdikten sonra ana makine kaynaklarınızı izlemenizi öneririz `git-bridge`. Yük artışı şunlara bağlı olacaktır:

* özelliğe erişen kullanıcı sayısı
* örneğinizde barındırılan proje türleri (daha büyük projeler genellikle daha fazla kaynak tüketir)
  {% endstep %}
  {% endstepper %}

### Projeleri S3'e taşıma

Git entegrasyonu, bir kullanıcı tarafından klonlanan her proje için diskte eksiksiz bir git deposu saklar. Disk alanınız sınırlıysa, daha az kullanılan depoları AWS S3'e taşıyan bir takas işi etkinleştirebilirsiniz. Taşınmış bir depoya yeniden ihtiyaç duyulursa, tekrar diske taşınır. Aşağıdaki ortam değişkenleri takas işini kontrol eder:

| Ad                                    | Açıklama                                                                                                                                                    |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GIT_BRIDGE_SWAPSTORE_TYPE`           | Takas işini etkinleştirmek için bunu "s3" olarak ayarlayın.                                                                                                 |
| `GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY` | AWS erişim anahtarınız                                                                                                                                      |
| `GIT_BRIDGE_SWAPSTORE_AWS_SECRET`     | AWS gizli anahtarınız                                                                                                                                       |
| `GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME` | Bu bucket, sıkıştırılmış git depolarını içerecektir                                                                                                         |
| `GIT_BRIDGE_SWAPSTORE_AWS_REGION`     | Bucket'ın bölgesi                                                                                                                                           |
| `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS`     | <p>En az kaç projenin diskte tutulacağı.<br><br><strong>- Varsayılan:</strong> 50</p>                                                                       |
| `GIT_BRIDGE_SWAPJOB_LOW_GIB`          | <p>Takas için düşük eşik. Takas işi, disk kullanımı bu değerin altına düşene kadar projeleri taşıyacaktır.<br><br><strong>- Varsayılan:</strong> 128 GB</p> |
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB`         | <p>Takas için yüksek eşik. Disk kullanımı bu değere ulaştığında takas işi taşımaya başlayacaktır.<br><br><strong>- Varsayılan:</strong> 256 GB</p>          |
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS`  | <p>Disk kullanımı kontrolü ile takas işinin çalıştırılması arasındaki süre.<br><br><strong>- Varsayılan:</strong> 3600000 ms = 1 saat</p>                   |

### Soru-Cevap

<details>

<summary>Projemi başka biriyle paylaşırsam, Git Bridge izin modeli nasıl çalışır?</summary>

Salt okunur erişimi olan kullanıcılar bu projeyi yalnızca klonlayabilir; okuma-yazma erişimi olan kullanıcılar projeleri klonlayıp push edebilir. Not: Kullanıcıların bu projeye katılabilmesi için giriş yapmış olmaları gerekir.

</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://overleaf-pro.ayaka.space/on-premises/tr/yapilandirma/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.
