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

# ενσωμάτωση Git

Η ενσωμάτωση Git είναι διαθέσιμη μόνο στο [ayaka-notes/overleaf](https://github.com/ayaka-notes/overleaf) προς το παρόν.

{% hint style="info" %}
Αυτή η δυνατότητα αναπτύχθηκε αρχικά από [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro).
{% endhint %}

{% stepper %}
{% step %}

### Ενεργοποιήστε το git-bridge (Μόνο για χρήστες Toolkit)

Αν χρησιμοποιείτε το Toolkit, ενεργοποιήστε το `git-bridge` ορίζοντας τα παρακάτω στο `config/overleaf.rc`:

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

```
GIT_BRIDGE_ENABLED=true
```

{% endcode %}
{% endstep %}

{% step %}

### Προσθέστε το κοντέινερ git-bridge (Μόνο για χρήστες Docker-compose)

Για χρήστες που εκτελούν ένα προσαρμοσμένο `docker-compose.yml`, προσθέστε την παρακάτω ρύθμιση κοντέινερ στο αρχείο compose σας:

{% code title="docker-compose.yml (υπηρεσία git-bridge)" overflow="wrap" %}

```yaml
git-bridge:
    restart: always
    image: quay.io/sharelatex/git-bridge:4.0.0 # η ετικέτα πρέπει να ταιριάζει με την ετικέτα του κοντέινερ `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/" για την έκδοση 4.1.6 και παλαιότερες
        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 %}

### Ενημερώστε τη ρύθμιση του κοντέινερ sharelatex

Θα χρειαστεί επίσης να συνδέσετε το `git-bridge` κοντέινερ στο `sharelatex` κοντέινερ και να ορίσετε τις ακόλουθες μεταβλητές περιβάλλοντος, δώστε προσοχή στο `V1_HISTORY_URL`:

<pre class="language-yaml" data-title="docker-compose.yml (υπηρεσία sharelatex)"><code class="lang-yaml">sharelatex:
    links:
        - git-bridge
    environment:
         GIT_BRIDGE_ENABLED: true
         GIT_BRIDGE_HOST: "git-bridge"
         GIT_BRIDGE_PORT: "8000"
<strong>         # Χρησιμοποιούμε πλέον το v1, αν είχατε ορίσει το V1_HISTORY_URL, ενημερώστε το τώρα
</strong><strong>         V1_HISTORY_URL: "http://sharelatex:3054"
</strong></code></pre>

{% endstep %}

{% step %}

### Ταυτοποίηση

Κατά την ταυτοποίηση ενός git client, οι χρήστες χρειάζονται ένα Personal Access Token. Οι χρήστες μπορούν να διαχειρίζονται τα Personal Access Tokens μέσω του UI της εφαρμογής (δείτε την τεκμηρίωση):

<figure><img src="/files/1438166a198de71ca48e37fb53daccc1986fb705" alt=""><figcaption><p>Personal Access Token για την ενσωμάτωση Git</p></figcaption></figure>
{% endstep %}

{% step %}

### Παρακολούθηση και ζητήματα πόρων

Συνιστούμε να παρακολουθείτε τους πόρους του host σας μετά την ενεργοποίηση του `git-bridge`. Η αύξηση του φορτίου θα εξαρτηθεί από:

* τον αριθμό των χρηστών που έχουν πρόσβαση στη λειτουργία
* τους τύπους έργων που φιλοξενούνται στο instance σας (τα μεγαλύτερα έργα είναι γενικά πιο απαιτητικά σε πόρους)
  {% endstep %}
  {% endstepper %}

### Μεταφορά έργων στο S3

Η ενσωμάτωση Git αποθηκεύει ένα πλήρες git repository στον δίσκο για κάθε έργο που κλωνοποιείται από έναν χρήστη. Αν έχετε περιορισμένο χώρο στο δίσκο, μπορείτε να ενεργοποιήσετε μια διεργασία swap που θα μεταφέρει τα repositories που χρησιμοποιούνται λιγότερο στο AWS S3. Αν χρειαστεί ξανά ένα μεταφερμένο repository, μεταφέρεται πίσω στον δίσκο. Οι ακόλουθες μεταβλητές περιβάλλοντος ελέγχουν τη διεργασία swap:

| Όνομα                                 | Περιγραφή                                                                                                                                                                  |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GIT_BRIDGE_SWAPSTORE_TYPE`           | Ορίστε το σε "s3" για να ενεργοποιήσετε τη διεργασία swap.                                                                                                                 |
| `GIT_BRIDGE_SWAPSTORE_AWS_ACCESS_KEY` | Το κλειδί πρόσβασής σας στο AWS                                                                                                                                            |
| `GIT_BRIDGE_SWAPSTORE_AWS_SECRET`     | Το μυστικό σας στο AWS                                                                                                                                                     |
| `GIT_BRIDGE_SWAPSTORE_S3_BUCKET_NAME` | Αυτό το bucket θα περιέχει τα συμπιεσμένα git repositories                                                                                                                 |
| `GIT_BRIDGE_SWAPSTORE_AWS_REGION`     | Η περιοχή του bucket                                                                                                                                                       |
| `GIT_BRIDGE_SWAPJOB_MIN_PROJECTS`     | <p>Πόσα έργα να διατηρούνται στον δίσκο, τουλάχιστον.<br><br><strong>- Προεπιλογή:</strong> 50</p>                                                                         |
| `GIT_BRIDGE_SWAPJOB_LOW_GIB`          | <p>Χαμηλό όριο για τη μεταφορά. Η διεργασία swap θα μετακινεί έργα μέχρι η χρήση δίσκου να πέσει κάτω από αυτήν την τιμή.<br><br><strong>- Προεπιλογή:</strong> 128 GB</p> |
| `GIT_BRIDGE_SWAPJOB_HIGH_GIB`         | <p>Υψηλό όριο για τη μεταφορά. Η διεργασία swap θα ξεκινήσει τη μεταφορά όταν η χρήση δίσκου φτάσει αυτήν την τιμή.<br><br><strong>- Προεπιλογή:</strong> 256 GB</p>       |
| `GIT_BRIDGE_SWAPJOB_INTERVAL_MILLIS`  | <p>Το διάστημα χρόνου μεταξύ του ελέγχου της χρήσης δίσκου και της εκτέλεσης της διεργασίας swap.<br><br><strong>- Προεπιλογή:</strong> 3600000 ms = 1 ώρα</p>             |

### Ερωτήσεις και απαντήσεις

<details>

<summary>Αν μοιραστώ το έργο μου με κάποιον άλλον, πώς λειτουργεί το μοντέλο δικαιωμάτων του Git Bridge;</summary>

Οι χρήστες με πρόσβαση μόνο για ανάγνωση μπορούν μόνο να κάνουν clone αυτού του έργου· οι χρήστες με πρόσβαση ανάγνωσης-εγγραφής μπορούν να κάνουν clone και push έργων. Σημείωση: Οι χρήστες πρέπει να είναι συνδεδεμένοι για να συμμετάσχουν σε αυτό το έργο.

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