> 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/ksekinontas/what-is-the-overleaf-toolkit.md). # Τι είναι το Overleaf Toolkit; Το Overleaf Toolkit είναι η προτεινόμενη μέθοδος ανάπτυξης για εγκαταστάσεις on-premises της Community Edition, του Server Pro ή του Overleaf Pro. Έχει σχεδιαστεί για να λειτουργεί με το πιο συνηθισμένο περιβάλλον: έναν μόνο φυσικό διακομιστή ή μια εικονική μηχανή. Το Toolkit χρησιμοποιεί `docker compose` για να διαχειρίζεται τα Docker κοντέινερ του διακομιστή σας και παρέχει ένα σύνολο σεναρίων που περιβάλλουν `docker` εντολές για να βοηθήσουν με την πιο τεχνική πλευρά της διαχείρισης μιας on-premises έκδοσης του Overleaf. #### Το `bin/docker-compose` περίβλημα Το `bin/docker-compose` σενάριο είναι ένα περίβλημα γύρω από `docker compose`. Φορτώνει ρυθμίσεις από το `config/` κατάλογο, πριν καλέσει `docker compose` με όποια ορίσματα πέρασαν στο σενάριο. Μπορείτε να θεωρείτε `bin/docker-compose` ως ένα διαφανές περίβλημα για το `docker compose` πρόγραμμα που είναι εγκατεστημένο στο μηχάνημά σας. Παράδειγμα: {% code title="Ελέγξτε τα εκτελούμενα κοντέινερ" %} ```bash $ bin/docker-compose ps ``` {% endcode %} #### Βολικά βοηθητικά εργαλεία Εκτός από `bin/docker-compose`, το Toolkit παρέχει εύχρηστα σενάρια για να βοηθήσει με κοινές εργασίες: * `bin/up`: συντόμευση για `bin/docker-compose up` * `bin/start`: συντόμευση για `bin/docker-compose start` * `bin/stop`: συντόμευση για `bin/docker-compose stop` * `bin/shell`: εκκινεί ένα κέλυφος μέσα στο **sharelatex** κοντέινερ * `bin/doctor`: σενάριο που χρησιμοποιείται για τη συλλογή πληροφοριών εγκατάστασης και ανάπτυξης. Δείτε την ενότητα «Έλεγχος του διακομιστή σας» παρακάτω * `bin/mongo`: εκκινεί ένα κέλυφος μέσα στο **mongo** κοντέινερ και μεταβαίνει στη σωστή βάση δεδομένων (**sharelatex**) * `bin/backup-config`: δημιουργεί ένα αντίγραφο (zip ή tar) της τρέχουσας ρύθμισής σας και το αποθηκεύει σε έναν κατάλογο προορισμού της επιλογής σας * `bin/logs`: προβολή/παρακολούθηση των αρχείων καταγραφής της υπηρεσίας * `bin/error-logs`: προβολή/παρακολούθηση των αρχείων καταγραφής σφαλμάτων της υπηρεσίας * `bin/rename-env-vars-5-0`: σενάριο μετεγκατάστασης για την ενημέρωση μεταβλητών περιβάλλοντος στο **config/variables.env** (μετονομασία από ShareLaTeX σε Overleaf) * `bin/rename-rc-vars`: σενάριο μετεγκατάστασης για την ενημέρωση μεταβλητών περιβάλλοντος στο **config/overleaf.rc** (μετονομασία από ShareLaTeX σε Overleaf) * `bin/run-script`: βοηθητικό εργαλείο για την απλοποίηση της εκτέλεσης σεναρίων που είναι αποθηκευμένα μέσα στο **sharelatex** κοντέινερ * `bin/upgrade`: βοηθά με αναβαθμίσεις της εγκατάστασης. Το σενάριο θα ελέγξει για ενημερώσεις του Toolkit (μέσω git) και θα προσφέρει να κάνει pull τις αλλαγές, θα ελέγξει για την πιο πρόσφατη έκδοση της εικόνας Docker και θα προσφέρει να την ενημερώσει. Παρέχει επιβεβαίωση βήμα προς βήμα, τη δυνατότητα δημιουργίας αντιγράφου ασφαλείας της τρέχουσας ρύθμισης και χειρίζεται τη διακοπή/εκκίνηση των υπηρεσιών Docker. Δείτε το Upgrading your deployment για περισσότερες πληροφορίες: {% hint style="info" %} Αν προτιμάτε να εκτελείτε το instance σας χωρίς σύνδεση στα αρχεία καταγραφής του Docker, μπορείτε να εκτελέσετε `bin/up -d` για να εκτελεστεί σε αποσυνδεδεμένη λειτουργία. {% endhint %} #### Έλεγχος του διακομιστή σας Το Overleaf Toolkit περιλαμβάνει ένα χρήσιμο σενάριο με το όνομα `bin/doctor` που παράγει μια αναφορά που δείχνει οποιαδήποτε ανεκπλήρωτη εξάρτηση. Πριν συνεχίσετε, εκτελέστε το `bin/doctor` σενάριο και ελέγξτε ότι όλα λειτουργούν σωστά: {% code title="Εκτελέστε το Overleaf Doctor" %} ```bash bin/doctor ``` {% endcode %} Παράδειγμα εξόδου (κομμένη/ενδεικτική):
Δείγμα εξόδου από το bin/doctor ``` ====== Overleaf Doctor ====== - Πληροφορίες κεντρικού υπολογιστή - Linux - Έξοδος της 'lsb_release -a': Δεν υπάρχουν διαθέσιμα LSB modules. Distributor ID: Ubuntu Description: Ubuntu 22.04.5 LTS Release: 22.04 Codename: jammy - Εξαρτήσεις - bash - κατάσταση: παρούσα - πληροφορίες έκδοσης: 5.1.16(1)-release - docker - κατάσταση: παρούσα - πληροφορίες έκδοσης: Docker version 27.3.1, build ce12230 - realpath - κατάσταση: παρούσα - πληροφορίες έκδοσης: realpath (GNU coreutils) 8.32 - perl - κατάσταση: παρούσα - πληροφορίες έκδοσης: 5.034000 - awk - κατάσταση: παρούσα - πληροφορίες έκδοσης: GNU Awk 5.1.0, API: 3.0 (GNU MPFR 4.1.0, GNU MP 6.2.1) - openssl - κατάσταση: παρούσα - πληροφορίες έκδοσης: OpenSSL 3.0.2 15 Mar 2022 (Library: OpenSSL 3.0.2 15 Mar 2022) - docker compose - κατάσταση: παρούσα - πληροφορίες έκδοσης: Docker Compose version v2.29.7 - Daemon του Docker - κατάσταση: σε λειτουργία ====== Configuration ====== - config/version - κατάσταση: παρούσα - έκδοση: 5.1.1 - config/overleaf.rc - κατάσταση: παρούσα - τιμές - OVERLEAF_DATA_PATH: data/overleaf - OVERLEAF_LOG_PATH: data/overleaf/logs - SERVER_PRO: true - συνδεδεμένος στο quay.io: true - SIBLING_CONTAINERS_ENABLED: true - OVERLEAF_LISTEN_IP: 0.0.0.0 - OVERLEAF_PORT: 80 - MONGO_ENABLED: true - MONGO_IMAGE: mongo - MONGO_VERSION: 6.0 - MONGO_DATA_PATH: data/mongo - REDIS_ENABLED: true - REDIS_IMAGE: redis:6.2 - REDIS_DATA_PATH: data/redis - config/variables.env - κατάσταση: παρούσα - τιμές - OVERLEAF_FILESTORE_BACKEND: fs - OVERLEAF_HISTORY_BACKEND: fs ====== Warnings ====== - Κανένα, όλα καλά ====== End ====== ```
Αν λείπουν κάποιες εξαρτήσεις, το doctor θα εμφανίσει προειδοποιήσεις. Αν αντιμετωπίσετε προβλήματα, πρώτα εκτελέστε `bin/doctor` και ελέγξτε την έξοδό του για προειδοποιήσεις. {% hint style="info" %} * Οι χρήστες της δωρεάν Community Edition θα πρέπει να ανοίξουν ένα issue στο GitHub: * Οι χρήστες του Server Pro θα πρέπει να επικοινωνήσουν με την υποστήριξη: mailto: Και στις δύο περιπτώσεις, συμπεριλάβετε την έξοδο του `bin/doctor` στο μήνυμά σας. {% endhint %} --- # 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/ksekinontas/what-is-the-overleaf-toolkit.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.