> 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/enarksi/what-is-the-overleaf-toolkit.md). # Τι είναι το Ayakaleaf Toolkit; Το toolkit ayakaleaf είναι η προτεινόμενη μέθοδος ανάπτυξης για τοπικές εγκαταστάσεις της Community Edition, του Ayakaleaf Pro· έχει σχεδιαστεί για να λειτουργεί με το πιο συνηθισμένο περιβάλλον: έναν μόνο φυσικό διακομιστή ή εικονική μηχανή. Το Toolkit χρησιμοποιεί `docker compose` για τη διαχείριση των Docker containers του διακομιστή σας και παρέχει ένα σύνολο από scripts που τυλίγουν `docker` εντολές για να βοηθήσουν με την πιο τεχνική πλευρά της διαχείρισης μιας on-premises έκδοσης του Overleaf. #### Το `bin/docker-compose` περίβλημα Το `bin/docker-compose` script είναι ένα περίβλημα γύρω από `docker compose`. Φορτώνει ρυθμίσεις από τον `κατάλογο config/` πριν καλέσει το `docker compose` με όποιες παραμέτρους δόθηκαν στο script. Μπορείτε να θεωρήσετε το `bin/docker-compose` ως ένα διαφανές περίβλημα για το `docker compose` πρόγραμμα εγκατεστημένο στο μηχάνημά σας. Παράδειγμα: {% code title="Έλεγχος εκτελούμενων containers" %} ```bash $ bin/docker-compose ps ``` {% endcode %} #### Βολικά βοηθητικά εργαλεία Εκτός από το `bin/docker-compose`, το Toolkit παρέχει εύχρηστα scripts για να βοηθήσει σε κοινές εργασίες: * `bin/up`: συντόμευση για το `bin/docker-compose up` * `bin/start`: συντόμευση για το `bin/docker-compose start` * `bin/stop`: συντόμευση για το `bin/docker-compose stop` * `bin/shell`: ανοίγει ένα κέλυφος μέσα στο **sharelatex** container * `bin/doctor`: script που χρησιμοποιείται για τη συλλογή πληροφοριών εγκατάστασης και ανάπτυξης. Δείτε την παρακάτω ενότητα «Έλεγχος του διακομιστή σας» * `bin/mongo`: ανοίγει ένα κέλυφος μέσα στο **mongo** container και αλλάζει στη σωστή βάση δεδομένων (**sharelatex**) * `bin/backup-config`: δημιουργεί ένα αντίγραφο (zip ή tar) της τρέχουσας διαμόρφωσής σας και το αποθηκεύει σε έναν κατάλογο προορισμού της επιλογής σας * `bin/logs`: προβολή/tail των αρχείων καταγραφής της υπηρεσίας * `bin/error-logs`: προβολή/tail των αρχείων καταγραφής σφαλμάτων της υπηρεσίας * `bin/rename-env-vars-5-0`: script μετεγκατάστασης για ενημέρωση μεταβλητών περιβάλλοντος στο **config/variables.env** (μετονομασία από ShareLaTeX σε Overleaf) * `bin/rename-rc-vars`: script μετεγκατάστασης για ενημέρωση μεταβλητών περιβάλλοντος στο **config/overleaf.rc** (μετονομασία από ShareLaTeX σε Overleaf) * `bin/run-script`: βοηθητικό εργαλείο για να απλοποιεί την εκτέλεση scripts που είναι αποθηκευμένα μέσα στο **sharelatex** container * `bin/upgrade`: βοηθά με αναβαθμίσεις της εγκατάστασης. Το script θα ελέγξει για ενημερώσεις του Toolkit (μέσω git) και θα προτείνει να τραβήξει τις αλλαγές, θα ελέγξει την τελευταία έκδοση της εικόνας Docker και θα προτείνει να την ενημερώσει. Παρέχει επιβεβαίωση βήμα προς βήμα, την επιλογή για δημιουργία αντιγράφου ασφαλείας της τρέχουσας διαμόρφωσης και χειρίζεται τη διακοπή/εκκίνηση των υπηρεσιών Docker. Δείτε το Upgrading your deployment για περισσότερες πληροφορίες: {% hint style="info" %} Αν προτιμάτε να εκτελείτε την εγκατάστασή σας χωρίς σύνδεση με τα Docker logs, μπορείτε να εκτελέσετε το `bin/up -d` για εκτέλεση σε αποσυνδεδεμένη λειτουργία. {% endhint %} #### Έλεγχος του διακομιστή σας Το Overleaf Toolkit περιλαμβάνει ένα χρήσιμο script με το όνομα `bin/doctor` που παράγει μια αναφορά που επισημαίνει οποιαδήποτε μη ικανοποιημένη εξάρτηση. Πριν συνεχίσετε, εκτελέστε το `bin/doctor` script και ελέγξτε ότι όλα λειτουργούν σωστά: {% 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 - Docker Daemon - κατάσταση: σε λειτουργία ====== Διαμόρφωση ====== - 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 ====== Προειδοποιήσεις ====== - Καμία, όλα καλά ====== Τέλος ====== ```
Αν λείπουν κάποιες εξαρτήσεις, το doctor θα εκτυπώσει προειδοποιήσεις. Αν αντιμετωπίσετε προβλήματα, πρώτα εκτελέστε το `bin/doctor` και ελέγξτε την έξοδό του για προειδοποιήσεις. {% hint style="info" %} * Οι χρήστες της έκδοσης Ayakaleaf Pro μπορούν να ανοίξουν ένα issue στο GitHub: Και στις δύο περιπτώσεις, συμπεριλάβετε την έξοδο του `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://ayakaleaf-pro.ayaka.space/on-premises/el/enarksi/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.