Αυτός ο οδηγός σάς καθοδηγεί στην ανάπτυξη αυτο-φιλοξενούμενης εγκατάστασης rtCloud σε διακομιστή Linux από μηδενική βάση. Στο τέλος, θα έχετε ένα λειτουργικό rtCloud προσβάσιμο μέσω του προγράμματος περιήγησής σας.

Προαπαιτούμενα

Βεβαιωθείτε ότι ο διακομιστής σας πληροί τις ακόλουθες απαιτήσεις πριν ξεκινήσετε:

Υλικό

ΠόροςΕλάχιστοΣυνιστώμενο
RAM2 GB4 GB
Δίσκος10 GB40 GB
CPU1 vCPU2 vCPUs

Λογισμικό

ΛογισμικόΈκδοση
ΛΣUbuntu 20.04 LTS ή νεότερο (ή οποιοδήποτε Linux με υποστήριξη Docker)
Docker20.10 ή νεότερο
Docker Composev2.x (docker compose) ή v1.x (docker-compose)

Εγκατάσταση Docker στο Ubuntu:

  curl -fsSL https://get.docker.com | sh

Επαλήθευση εγκατάστασης:

  docker --version
docker compose version

Βήμα 1 — Λήψη αρχείων

Κλωνοποιήστε το αποθετήριο ανάπτυξης στον διακομιστή σας:

  git clone ssh://git@rtgit.rta.vn:2224/rtlab/rtwebteam/rta-smart-survey-docker.git rtcloud
cd rtcloud

Βήμα 2 — Διαμόρφωση περιβάλλοντος

Αντιγράψτε το δείγμα αρχείου διαμόρφωσης:

  cp .env.production.sample .env

Ανοίξτε το .env σε έναν επεξεργαστή κειμένου και συμπληρώστε τις απαιτούμενες τιμές:

  # Μοναδικό αναγνωριστικό για αυτή την ανάπτυξη (χωρίς κενά ή ειδικούς χαρακτήρες)
PROJECT_ID=myproject

# Τομέας ή διεύθυνση IP όπου οι χρήστες θα έχουν πρόσβαση στην εφαρμογή
# Παράδειγμα: rtcloud.example.com  ή  192.168.1.100
PROJECT_URL=rtcloud.example.com

# Πρωτόκολλο: χρησιμοποιήστε "https" εάν έχετε τομέα με SSL, αλλιώς "http"
HTTP_PROTOCOL=https

# Ισχυροί, μοναδικοί κωδικοί — αλλάξτε και τους τρεις πριν ξεκινήσετε
MYSQL_PASSWORD=change_me_strong_password
MYSQL_ROOT_PASSWORD=change_me_root_password
ADMIN_PASSWORD=change_me_admin_password

Σημαντικό: Μόνο το .env διαβάζεται αυτόματα από το Docker Compose. Μην δημιουργείτε αρχείο με όνομα .env.production. Το ADMIN_PASSWORD εφαρμόζεται μόνο κατά την πρώτη εκκίνηση σε νέα βάση δεδομένων.

Βήμα 3 — Εκκίνηση κοντέινερ

Εκκινήστε όλες τις υπηρεσίες στο παρασκήνιο:

  docker compose -f docker-compose.production.yml up -d

Η πρώτη εκκίνηση διαρκεί 3–5 λεπτά ενώ το Docker:

  1. Κατεβάζει την εικόνα εφαρμογής rtCloud (~1 GB λήψη)
  2. Αρχικοποιεί τη βάση δεδομένων MySQL
  3. Φορτώνει το βασικό σχήμα
  4. Εκτελεί όλες τις εκκρεμείς μετεγκαταστάσεις βάσης δεδομένων

Παρακολουθήστε την πρόοδο εκκίνησης σε πραγματικό χρόνο:

  docker compose -f docker-compose.production.yml logs -f rtcloud

Αναμείνετε έως ότου δείτε αποτέλεσμα που υποδηλώνει ότι η εφαρμογή είναι έτοιμη. Μπορείτε επίσης να παρακολουθήσετε την κατάσταση υγείας κοντέινερ:

  watch docker compose -f docker-compose.production.yml ps

Βήμα 4 — Πρόσβαση στην εφαρμογή

Μόλις και τα δύο κοντέινερ εμφανίσουν Up (healthy), ανοίξτε το πρόγραμμα περιήγησής σας:

  http://<PROJECT_URL>:8080

Συνδεθείτε χρησιμοποιώντας τον λογαριασμό διαχειριστή:

ΠεδίοΤιμή
Όνομα χρήστηadmin
ΚωδικόςΗ τιμή που ορίσατε για ADMIN_PASSWORD στο .env

Αλλάξτε τον κωδικό διαχειριστή αμέσως μετά την πρώτη σύνδεση από τη σελίδα ρυθμίσεων λογαριασμού.

Βήμα 5 — Επαλήθευση όλων των υπηρεσιών

Ελέγξτε ότι όλα τα κοντέινερ εκτελούνται και είναι υγιή:

  docker compose -f docker-compose.production.yml ps

Αναμενόμενο αποτέλεσμα:

  NAME                    IMAGE                                   STATUS
rtcloud-app             rtawebteam/rta-smartsurvey:...          Up (healthy)
rtcloud-mysql           mysql:8.0                               Up (healthy)

Εάν ένα κοντέινερ εμφανίζει Up (starting) ή Up (unhealthy), αναμείνετε 30–60 δευτερόλεπτα και ελέγξτε ξανά. Το MySQL μπορεί να χρειαστεί έως ένα λεπτό για πλήρη αρχικοποίηση κατά την πρώτη εκκίνηση.

Αναφορά θυρών

ΘύραΥπηρεσίαΠεριγραφή
8080Εφαρμογή rtCloudΚύρια διεπαφή χρήστη web (ρυθμιζόμενη μέσω APP_PORT)
3838Διακομιστής ShinyΑναλύσεις και οπτικοποιήσεις βασισμένες σε R (ρυθμιζόμενη μέσω SHINY_PORT)

Η MySQL (θύρα 3306) και τυχόν προαιρετικές υπηρεσίες (Keycloak) είναι μόνο εσωτερικές και δεν εκτίθενται στον κεντρικό υπολογιστή από προεπιλογή.

Επόμενα βήματα

Η εγκατάσταση rtCloud εκτελείται τώρα. Εξετάστε αυτές τις επακόλουθες εργασίες:

  • Ενεργοποίηση HTTPS — Κατευθύνετε έναν τομέα στον διακομιστή σας και διαμορφώστε SSL με Let’s Encrypt. Δείτε Ανάπτυξη στο cloud για αυτόματη ρύθμιση HTTPS.
  • Έλεγχος όλων των ρυθμίσεων — Περιηγηθείτε στην Αναφορά διαμόρφωσης για ρύθμιση ανάπτυξης παραγωγής.
  • Ρύθμιση SSO — Συνδέστε έναν πάροχο ταυτοτήτων για κεντρική ταυτοποίηση χρηστών. Δείτε Ταυτοποίηση SSO.
  • Σχεδιασμός αντιγράφων ασφαλείας — Ελέγξτε τη σελίδα Συντήρηση για διαδικασίες αντιγράφων ασφαλείας και αναβάθμισης.
Ήταν χρήσιμη αυτή η σελίδα;