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

# integraci Git

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

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

{% stepper %}
{% step %}

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

Pokud používáte Toolkit, povolte `git-bridge` tím, že ve svém `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`
    volumes:
        - ~/git_bridge_data:/data/git-bridge
    container_name: git-bridge
    expose:
        - "8000"
    environment:
        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` kontejner a definovat následující proměnné prostředí, prosím věnujte pozornost `V1_HISTORY_URL`:

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

{% endstep %}

{% step %}

### Ověřování

Při ověřování klienta git 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 integrace Git</p></figcaption></figure>
{% endstep %}

{% step %}

### Monitorování a úvahy o zdrojích

Doporučujeme sledovat zdroje hostitele po zapnutí `git-bridge`. Zvýšení 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 obecně vyžadují více zdrojů)
  {% endstep %}
  {% endstepper %}

### Přesouvání projektů do S3

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

| Název                                 | Popis                                                                                                                                                            |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GIT_BRIDGE_SWAPSTORE_TYPE`           | Nastavte tuto hodnotu na "s3" pro aktivaci úlohy 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á git úložiště                                                                                                              |
| `GIT_BRIDGE_SWAPSTORE_AWS_REGION`     | Region bucketu                                                                                                                                                   |
| `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS`     | <p>Kolik projektů ponechat na disku, minimálně.<br><br><strong>- Výchozí:</strong> 50</p>                                                                        |
| `GIT_BRIDGE_SWAPJOB_LOW_GIB`          | <p>Dolní hranice pro přesun. Úloha přesunu bude přesouvat projekty, dokud využití disku neklesne pod tuto hodnotu.<br><br><strong>- Výchozí:</strong> 128 GB</p> |
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB`         | <p>Horní hranice pro přesun. Úloha přesunu začne přesouvat, když využití disku dosáhne této hodnoty.<br><br><strong>- Výchozí:</strong> 256 GB</p>               |
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS`  | <p>Časový interval mezi kontrolami využití disku a spuštěním úlohy přesunu.<br><br><strong>- Výchozí:</strong> 3600000 ms = 1 hodina</p>                         |

### Otázky a odpovědi

<details>

<summary>Když sdílím svůj projekt 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 odesílat. Poznámka: Uživatelé se musí přihlásit, aby se mohli k tomuto projektu připojit.

</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/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.
