> 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/on-premises-cs/konfigurace/overleaf-toolkit/git-integration.md).

# integrace s Gitem

Integrace Git je dostupná pouze na [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) aktuálně.

{% hint style="info" %}
Tato funkce byla původně vyvinuta společností [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% stepper %}
{% step %}

### Povolte git-bridge (pouze pro uživatele Toolkitu)

Pokud používáte Toolkit, povolte `git-bridge` takto v konfiguraci svého `config/overleaf.rc`:

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

```
GIT_BRIDGE_ENABLED=true
```

{% endcode %}
{% endstep %}

{% step %}

### Přidejte kontejner git-bridge (pouze pro uživatele Docker Compose)

Pro uživatele provozující vlastní `docker-compose.yml`přidejte do souboru compose následující konfiguraci kontejneru:

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

```yaml
git-bridge:
    restart: always
    image: quay.io/sharelatex/git-bridge:4.0.0 # značka by měla odpovídat značce kontejneru `sharelatex`
    svazky:
        - ~/git_bridge_data:/data/git-bridge
    container_name: git-bridge
    expose:
        - "8000"
    prostředí:
        GIT_BRIDGE_API_BASE_URL: "http://sharelatex:3000/api/v0/" 
        # "http://sharelatex/api/v0/" pro verzi 4.1.6 a starší
        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 %}

### Aktualizujte konfiguraci kontejneru sharelatex

Budete také muset propojit `git-bridge` kontejner v `sharelatex` kontejneru a definovat následující proměnné prostředí, věnujte prosím pozornost `V1_HISTORY_URL`:

<pre class="language-yaml" data-title="docker-compose.yml (služba sharelatex)"><code class="lang-yaml">sharelatex:
    links:
        - git-bridge
    prostředí:
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
<strong>         # Nyní používáme v1, pokud jste dříve nastavovali V1_HISTORY_URL, aktualizujte to nyní
</strong><strong>         V1_HISTORY_URL: "http://sharelatex:3054"
</strong></code></pre>

{% endstep %}

{% step %}

### Autentizace

Při autentizaci gitového klienta potřebují uživatelé osobní přístupový token. Uživatelé mohou osobní přístupové tokeny spravovat prostřednictvím uživatelského rozhraní aplikace (viz dokumentace):

<figure><img src="/files/57b745611ecfe22232f59d1165edf0d4da4a99b7" alt=""><figcaption><p>Osobní přístupový token pro integraci Git</p></figcaption></figure>
{% endstep %}

{% step %}

### Monitorování a úvahy o prostředcích

Doporučujeme sledovat prostředky hostitele po povolení `git-bridge`. Nárůst zátěže bude záviset na:

* počtu uživatelů, kteří k této funkci přistupují
* typech projektů hostovaných ve vaší instanci (větší projekty jsou obecně náročnější na prostředky)
  {% endstep %}
  {% endstepper %}

### Přesun projektů na S3

Integrace Git ukládá na disk kompletní gitový repozitář pro každý projekt, který uživatel naklonuje. Pokud máte omezené místo na disku, můžete aktivovat úlohu přesunu, která přesune méně používané repozitáře do AWS S3. Pokud je přesunutý repozitář znovu potřeba, přesune se zpět na disk. Úlohu přesunu řídí následující proměnné prostředí:

| Název                                 | Popis                                                                                                                                                                 |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GIT_BRIDGE_SWAPSTORE_TYPE`           | Nastavte na "s3", chcete-li aktivovat úlohu přesunu.                                                                                                                  |
| `GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY` | Váš přístupový klíč AWS                                                                                                                                               |
| `GIT_BRIDGE_SWAPSTORE_AWS_SECRET`     | Váš tajný klíč AWS                                                                                                                                                    |
| `GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME` | Tento bucket bude obsahovat zazipované gitové repozitáře                                                                                                              |
| `GIT_BRIDGE_SWAPSTORE_AWS_REGION`     | Region bucketu                                                                                                                                                        |
| `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS`     | <p>Kolik projektů se má minimálně ponechat na disku.<br><br><strong>- Výchozí hodnota:</strong> 50</p>                                                                |
| `GIT_BRIDGE_SWAPJOB_LOW_GIB`          | <p>Dolní práh pro přesun. Úloha přesunu bude přesouvat projekty, dokud využití disku neklesne pod tuto hodnotu.<br><br><strong>- Výchozí hodnota:</strong> 128 GB</p> |
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB`         | <p>Horní práh pro přesun. Úloha přesunu začne přesouvat, když využití disku dosáhne této hodnoty.<br><br><strong>- Výchozí hodnota:</strong> 256 GB</p>               |
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS`  | <p>Časový interval mezi kontrolou využití disku a spuštěním úlohy přesunu.<br><br><strong>- Výchozí hodnota:</strong> 3600000 ms = 1 hodina</p>                       |

### Otázky a odpovědi

<details>

<summary>Pokud svůj projekt sdílím s někým jiným, jak funguje model oprávnění Git Bridge?</summary>

Uživatelé s přístupem jen pro čtení mohou tento projekt pouze naklonovat; uživatelé s přístupem pro čtení i zápis mohou projekty klonovat a pushovat. Poznámka: Uživatelé se musí k připojení k tomuto projektu přihlásit.

</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/on-premises-cs/konfigurace/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.
