> 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/el/rythmisi/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 Token μέσω του UI της εφαρμογής (βλ. την τεκμηρίωση):

<figure><img src="/files/1438166a198de71ca48e37fb53daccc1986fb705" alt=""><figcaption><p>Προσωπικό διακριτικό πρόσβασης για την ενσωμάτωση Git</p></figcaption></figure>
{% endstep %}

{% step %}

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

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

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

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

Η ενσωμάτωση Git αποθηκεύει ένα πλήρες αποθετήριο git στον δίσκο για κάθε έργο που κλωνοποιείται από έναν χρήστη. Αν έχετε περιορισμένο χώρο στο δίσκο, μπορείτε να ενεργοποιήσετε μια εργασία swap που θα μεταφέρει τα αποθετήρια που χρησιμοποιούνται λιγότερο στο AWS S3. Αν χρειαστεί ξανά ένα αποθετήριο που έχει μεταφερθεί, μεταφέρεται πίσω στον δίσκο. Οι ακόλουθες μεταβλητές περιβάλλοντος ελέγχουν την εργασία 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                                                                                                                     |
| `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>

Οι χρήστες με πρόσβαση μόνο για ανάγνωση μπορούν μόνο να κλωνοποιήσουν αυτό το έργο· οι χρήστες με πρόσβαση ανάγνωσης-εγγραφής μπορούν να κλωνοποιούν και να κάνουν 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://overleaf-pro.ayaka.space/on-premises/el/rythmisi/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.
