> 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/fi/konfiguraatio/overleaf-toolkit/git-integration.md).

# Git-integraatio

Git-integraatio on saatavilla vain [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) tällä hetkellä.

{% hint style="info" %}
Tämän ominaisuuden kehitti alun perin [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% stepper %}
{% step %}

### Ota git-bridge käyttöön (vain Toolkitin käyttäjille)

Jos käytät Toolkitia, ota `git-bridge` käyttöön asettamalla seuraava `config/overleaf.rc`:

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

```
GIT_BRIDGE_ENABLED=true
```

{% endcode %}
{% endstep %}

{% step %}

### Lisää git-bridge-säilö (vain Docker Compose -käyttäjille)

Mukautettua `docker-compose.yml`käyttävien käyttäjien osalta lisää seuraava säilömääritys compose-tiedostoosi:

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

```yaml
git-bridge:
    restart: always
    image: quay.io/sharelatex/git-bridge:4.0.0 # tunnisteen pitäisi vastata `sharelatex`-säilön tunnistetta
    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/" versiolle 4.1.6 ja sitä aikaisemmille
        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 %}

### Päivitä sharelatex-säilön määritys

Sinun täytyy myös linkittää `git-bridge` säilö `sharelatex` säilössä ja määrittää seuraavat ympäristömuuttujat; kiinnitä huomiota `V1_HISTORY_URL`:

<pre class="language-yaml" data-title="docker-compose.yml (sharelatex-palvelu)"><code class="lang-yaml">sharelatex:
    links:
        - git-bridge
    environment:
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
<strong>         # Käytämme nyt versiota v1; jos olet aiemmin asettanut V1_HISTORY_URL:n, päivitä se nyt
</strong><strong>         V1_HISTORY_URL: "http://sharelatex:3054"
</strong></code></pre>

{% endstep %}

{% step %}

### Todennus

Kun git-asiakasohjelmaa todennetaan, käyttäjät tarvitsevat henkilökohtaisen käyttöoikeustunnuksen. Käyttäjät voivat hallita henkilökohtaisia käyttöoikeustunnuksia sovelluksen käyttöliittymän kautta (katso dokumentaatio):

<figure><img src="/files/8a56013e751b7d5401e20ef8c3b4114405f403fe" alt=""><figcaption><p>Git-integraation henkilökohtainen käyttöoikeustunnus</p></figcaption></figure>
{% endstep %}

{% step %}

### Seuranta ja resurssien huomioiminen

Suosittelemme, että valvot isäntäresurssejasi sen jälkeen, kun olet ottanut `git-bridge`käyttöön. Kuorman kasvu riippuu seuraavista:

* ominaisuutta käyttävien käyttäjien määrästä
* instanssissasi isännöityjen projektien tyypeistä (suuremmat projektit vaativat yleensä enemmän resursseja)
  {% endstep %}
  {% endstepper %}

### Projektien siirtäminen S3:een

Git-integraatio tallentaa täydellisen git-varaston levylle jokaisesta projektista, jonka käyttäjä kloonaa. Jos levytilaa on vähän, voit aktivoida vaihtotyön, joka siirtää vähemmän käytetyt varastot AWS S3:een. Jos siirrettyä varastoa tarvitaan uudelleen, se siirretään takaisin levylle. Seuraavat ympäristömuuttujat ohjaavat vaihtotyötä:

| Nimi                                  | Kuvaus                                                                                                                                                         |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GIT_BRIDGE_SWAPSTORE_TYPE`           | Aseta tämä arvoon "s3" aktivoidaksesi vaihtotyön.                                                                                                              |
| `GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY` | AWS-käyttöavaimesi                                                                                                                                             |
| `GIT_BRIDGE_SWAPSTORE_AWS_SECRET`     | AWS-salaisuutesi                                                                                                                                               |
| `GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME` | Tämä säilö sisältää zip-pakatut git-varastot                                                                                                                   |
| `GIT_BRIDGE_SWAPSTORE_AWS_REGION`     | Säilön alue                                                                                                                                                    |
| `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS`     | <p>Kuinka monta projektia pidetään vähintään levyllä.<br><br><strong>- Oletus:</strong> 50</p>                                                                 |
| `GIT_BRIDGE_SWAPJOB_LOW_GIB`          | <p>Alempi kynnysarvo vaihtamiselle. Vaihtotyö siirtää projekteja, kunnes levyn käyttö on tämän arvon alapuolella.<br><br><strong>- Oletus:</strong> 128 GB</p> |
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB`         | <p>Ylempi kynnysarvo vaihtamiselle. Vaihtotyö alkaa siirtää, kun levyn käyttö saavuttaa tämän arvon.<br><br><strong>- Oletus:</strong> 256 GB</p>              |
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS`  | <p>Aika levytilan käytön tarkistamisen ja vaihtotyön suorittamisen välillä.<br><br><strong>- Oletus:</strong> 3600000 ms = 1 tunti</p>                         |

### Kysymykset ja vastaukset

<details>

<summary>Jos jaan projektini jonkun muun kanssa, miten Git Bridge -käyttöoikeusmalli toimii?</summary>

Vain lukuoikeudella varustetut käyttäjät voivat ainoastaan kloonata tämän projektin; luku- ja kirjoitusoikeudella varustetut käyttäjät voivat kloonata ja pushata projekteja. Huom: Käyttäjien on oltava kirjautuneina liittyäkseen tähän projektiin.

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