> 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/fi/maaritys/overleaf-toolkit/git-integration.md). # Git-integraation Git-integraatio on tällä hetkellä käytettävissä vain osoitteessa [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) tällä hetkellä. {% hint style="info" %} Tämän ominaisuuden on alun perin kehittänyt [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 käyttöön `git-bridge` asettamalla seuraava tiedostossasi `config/overleaf.rc`: {% code title="config/overleaf.rc" %} ``` GIT_BRIDGE_ENABLED=true ``` {% endcode %} {% endstep %} {% step %} ### Lisää git-bridge-kontaineri (vain Docker-compose-käyttäjille) Käyttäjille, jotka käyttävät omaa `docker-compose.yml`, lisää seuraava kontainerin kokoonpano 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 # tagin tulee vastata `sharelatex`-kontainerin tagia volyymit: - ~/git_bridge_data:/data/git-bridge container_name: git-bridge expose: - "8000" ympäristö: GIT_BRIDGE_API_BASE_URL: "http://sharelatex:3000/api/v0/" # "http://sharelatex/api/v0/" versiolle 4.1.6 ja aiemmille 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-kontainerin kokoonpano Sinun täytyy myös linkittää `git-bridge` kontaineri `sharelatex` kontaineri ja määritä seuraavat ympäristömuuttujat; kiinnitä erityistä `V1_HISTORY_URL`: 
sharelatex:
    links:
        - git-bridge
    ympäristö:
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
         # Käytämme nyt v1:tä; jos käytit aiemmin asetusta V1_HISTORY_URL, päivitä se nyt
         V1_HISTORY_URL: "http://sharelatex:3054"
{% endstep %} {% step %} ### Todennus Git-asiakasta todennettaessa 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ässä (katso dokumentaatio):

Git-integraation henkilökohtainen käyttöoikeustunnus

{% endstep %} {% step %} ### Seuranta ja resurssien huomioiminen Suosittelemme, että seuraat isäntäsi resursseja otettuasi käyttöön `git-bridge`. Kuormituksen kasvu riippuu seuraavista: * ominaisuutta käyttävien käyttäjien määrä * instanssissasi isännöityjen projektien tyypit (suuremmat projektit ovat yleensä resurssi-intensiivisempiä) {% endstep %} {% endstepper %} ### Projektien siirtäminen S3:een Git-integraatio tallentaa täydellisen git-arkiston levylle jokaisesta projektista, jonka käyttäjä kloonaa. Jos levytilaa on vähän, voit aktivoida siirtotehtävän, joka siirtää harvemmin käytetyt arkistot AWS S3:een. Jos siirrettyä arkistoa tarvitaan uudelleen, se siirretään takaisin levylle. Seuraavat ympäristömuuttujat ohjaavat siirtotehtävää: | Nimi | Kuvaus | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `GIT_BRIDGE_SWAPSTORE_TYPE` | Aseta arvoksi "s3" aktivoidaksesi siirtotehtävä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ä S3-ämpäri sisältää pakatut git-arkistot | | `GIT_BRIDGE_SWAPSTORE_AWS_REGION` | Ämpärin alue | | `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS` |

Kuinka monta projektia pidetään vähintään levyllä.

- Oletus: 50

| | `GIT_BRIDGE_SWAPJOB_LOW_GIB` |

Alhainen kynnys siirrolle. Siirtotehtävä siirtää projekteja, kunnes levyn käyttö on tämän arvon alapuolella.

- Oletus: 128 GB

| | `GIT_BRIDGE_SWAPJOB_HIGH_GIB` |

Korkea kynnys siirrolle. Siirtotehtävä alkaa siirtää, kun levyn käyttö saavuttaa tämän arvon.

- Oletus: 256 GB

| | `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS` |

Aika levyn käytön tarkistusten ja siirtotehtävän suorittamisen välillä.

- Oletus: 3600000 ms = 1 tunti

| ### Kysymykset ja vastaukset
Jos jaan projektini jonkun muun kanssa, miten Git Bridgen käyttöoikeusmalli toimii? Vain lukuoikeudella varustetut käyttäjät voivat kloonata tämän projektin; luku- ja kirjoitusoikeudella varustetut käyttäjät voivat kloonata ja pushata projekteja. Huomaa: Käyttäjien täytyy olla kirjautuneita liittyäkseen tähän projektiin.
--- # 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/fi/maaritys/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.