> 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/nl/configuratie/overleaf-toolkit/git-integration.md).
# Git-integratie
Git-integratie is momenteel alleen beschikbaar op [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) momenteel.
{% hint style="info" %}
Deze functie is oorspronkelijk ontwikkeld door [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}
{% stepper %}
{% step %}
### Schakel de git-bridge in (alleen voor Toolkit-gebruikers)
Als je de Toolkit gebruikt, schakel dan de `git-bridge` in door het volgende in je `config/overleaf.rc`:
{% code title="config/overleaf.rc" %}
```
GIT_BRIDGE_ENABLED=true
```
{% endcode %}
{% endstep %}
{% step %}
### Voeg de git-bridge-container toe (alleen voor Docker-compose-gebruikers)
Voor gebruikers die een aangepaste `docker-compose.yml`gebruiken, voeg de volgende containerconfiguratie toe aan je compose-bestand:
{% code title="docker-compose.yml (git-bridge-service)" overflow="wrap" %}
```yaml
git-bridge:
restart: always
image: quay.io/sharelatex/git-bridge:4.0.0 # de tag moet overeenkomen met de `sharelatex`-containertag
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/" voor versie 4.1.6 en eerder
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 %}
### Werk de configuratie van de sharelatex-container bij
Je moet ook de `git-bridge` container koppelen in de `sharelatex` container en de volgende omgevingsvariabelen definiëren, let alstublieft op `V1_HISTORY_URL`:
sharelatex:
links:
- git-bridge
environment:
GIT_BRIDGE_ENABLED: true
GIT_BRIDGE_HOST: "git-bridge"
GIT_BRIDGE_PORT: "8000"
# We gebruiken nu v1; als je eerder V1_HISTORY_URL hebt ingesteld, werk dit dan nu bij
V1_HISTORY_URL: "http://sharelatex:3054"
{% endstep %}
{% step %}
### Authenticatie
Bij het authenticeren van een git-client hebben gebruikers een Personal Access Token nodig. Gebruikers kunnen Personal Access Tokens beheren via de app-interface (zie de documentatie):
Git-integratie Personal Access Token
{% endstep %}
{% step %}
### Monitoring en aandachtspunten voor resources
We raden aan je host-resources te monitoren nadat je de `git-bridge`hebt ingeschakeld. De toename van de belasting hangt af van:
* het aantal gebruikers dat toegang heeft tot de functie
* de soorten projecten die op je instantie worden gehost (grotere projecten vragen doorgaans meer resources)
{% endstep %}
{% endstepper %}
### Projecten naar S3 verplaatsen
De Git-integratie slaat voor elk project dat door een gebruiker wordt gekloond een complete git-repository op schijf op. Als je beperkte schijfruimte hebt, kun je een swap-taak activeren die minder gebruikte repositories naar AWS S3 verplaatst. Als een verplaatste repository opnieuw nodig is, wordt deze terug naar de schijf verplaatst. De volgende omgevingsvariabelen bepalen de swap-taak:
| Naam | Beschrijving |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `GIT_BRIDGE_SWAPSTORE_TYPE` | Stel dit in op "s3" om de swap-taak te activeren. |
| `GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY` | Je AWS-toegangssleutel |
| `GIT_BRIDGE_SWAPSTORE_AWS_SECRET` | Je AWS-geheim |
| `GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME` | Deze bucket bevat de gecomprimeerde git-repositories |
| `GIT_BRIDGE_SWAPSTORE_AWS_REGION` | De regio van de bucket |
| `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS` |
Hoeveel projecten er minimaal op schijf moeten blijven.
- Standaard: 50
|
| `GIT_BRIDGE_SWAPJOB_LOW_GIB` |
Ondergrens voor verplaatsen. De swap-taak verplaatst projecten totdat het schijfgebruik onder deze waarde ligt.
- Standaard: 128 GB
|
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB` |
Bovengrens voor verplaatsen. De swap-taak begint te verplaatsen wanneer het schijfgebruik deze waarde bereikt.
- Standaard: 256 GB
|
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS` |
De tijd tussen het controleren van schijfgebruik en het uitvoeren van de swap-taak.
- Standaard: 3600000 ms = 1 uur
|
### V\&A
Als ik mijn project deel met iemand anders, hoe werkt het machtigingsmodel van Git Bridge dan?
Gebruikers met alleen-lezen-toegang kunnen dit project alleen klonen; gebruikers met lees- en schrijfrechten kunnen projecten klonen en pushen. Let op: gebruikers moeten ingelogd zijn om aan dit project deel te nemen.
---
# 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/nl/configuratie/overleaf-toolkit/git-integration.md?ask=&goal=
```
`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.