Σε αυτόν τον οδηγό θα μάθετε πώς να ρυθμίσετε και να εκτελέσετε εφαρμογές Node.js στη φιλοξενία σας στη HOSTDOG. Θα δείτε πώς να δημιουργήσετε μια εφαρμογή Node.js μέσω του πίνακα ελέγχου, να διαμορφώσετε το entry point, να εγκαταστήσετε dependencies και να διαχειριστείτε την εφαρμογή σας.
Τι θα χρειαστείτε
- Ενεργό λογαριασμό φιλοξενίας στη HOSTDOG
- Πρόσβαση στον πίνακα ελέγχου της φιλοξενίας σας (πώς να συνδεθείτε)
- Μια εφαρμογή Node.js έτοιμη για deploy (με αρχείο
package.json) - Πρόσβαση SSH (προαιρετικά, για διαχείριση μέσω γραμμής εντολών)
Ρύθμιση εφαρμογής Node.js
Συνδεθείτε στον πίνακα ελέγχου και βρείτε την ενότητα Software. Πατήστε Setup Node.js App. Αυτό το εργαλείο διαχειρίζεται τις εφαρμογές Node.js στον λογαριασμό φιλοξενίας σας.
Πατήστε Create Application και διαμορφώστε τις παρακάτω ρυθμίσεις:
| Ρύθμιση | Περιγραφή |
|---|---|
| Node.js version | Επιλέξτε την έκδοση που απαιτεί η εφαρμογή σας (π.χ. 18, 20, 22) |
| Application mode | Ορίστε Production για ιστοσελίδες σε παραγωγή, Development για δοκιμές |
| Application root | Ο κατάλογος που περιέχει τα αρχεία της εφαρμογής (π.χ. /home/yourusername/myapp) |
| Application URL | Το domain ή subdomain που εξυπηρετεί την εφαρμογή |
| Application startup file | Το αρχείο εκκίνησης (π.χ. app.js, server.js, index.js) |
Ανεβάστε την εφαρμογή Node.js στον κατάλογο application root χρησιμοποιώντας FTP/SFTP, Διαχείριση Αρχείων ή Git. Βεβαιωθείτε ότι το package.json βρίσκεται στον κατάλογο application root.
Στη σελίδα διαχείρισης της εφαρμογής Node.js, πατήστε Run NPM Install για να εγκαταστήσετε τα πακέτα που ορίζονται στο package.json. Εναλλακτικά, συνδεθείτε μέσω SSH, μεταβείτε στον κατάλογο της εφαρμογής και εκτελέστε:
cd ~/myapp
source /home/yourusername/nodevenv/myapp/18/bin/activate
npm installsource ... activate ενεργοποιεί το virtual environment της εφαρμογής Node.js. Το ακριβές path εξαρτάται από τον κατάλογο της εφαρμογής και την έκδοση Node.js. Ο πίνακας ελέγχου εμφανίζει τη σωστή εντολή ενεργοποίησης στη σελίδα διαχείρισης της εφαρμογής.
Πατήστε Start App (ή Restart αν εκτελείται ήδη). Ο πίνακας ελέγχου δημιουργεί μια διεργασία Passenger που διατηρεί την εφαρμογή σας σε λειτουργία και δρομολογεί τα εισερχόμενα αιτήματα. Επισκεφθείτε το domain σας για να επιβεβαιώσετε ότι η εφαρμογή λειτουργεί.
Διαχείριση της εφαρμογής Node.js
Από τη σελίδα διαχείρισης της εφαρμογής Node.js, μπορείτε να:
- Κάνετε Stop και Restart στην εφαρμογή
- Αλλάξετε την έκδοση Node.js (επιλέξτε διαφορετική έκδοση από το dropdown και αποθηκεύστε)
- Ορίσετε environment variables — προσθέστε ζεύγη key-value στα οποία η εφαρμογή σας έχει πρόσβαση μέσω
process.env - Εκτελέσετε Run NPM Install ξανά μετά την ενημέρωση του
package.json - Διαγράψετε την εφαρμογή όταν δεν τη χρειάζεστε πλέον
app.listen(port), ο Passenger το παρακάμπτει αυτόματα.
Αντιμετώπιση προβλημάτων
Ελέγξτε το error log της εφαρμογής στο αρχείο stderr.log μέσα στον κατάλογο application root. Συχνές αιτίες περιλαμβάνουν ελλείποντα dependencies (εκτελέστε NPM Install), λανθασμένο path αρχείου εκκίνησης ή συντακτικά σφάλματα στον κώδικά σας. Βεβαιωθείτε επίσης ότι η έκδοση Node.js αντιστοιχεί στις απαιτήσεις της εφαρμογής σας.
Συνδεθείτε μέσω SSH, ενεργοποιήστε το Node.js environment και εκτελέστε npm install χειροκίνητα για να δείτε το πλήρες μήνυμα σφάλματος. Συχνά προβλήματα περιλαμβάνουν παρωχημένα lock files (package-lock.json) — δοκιμάστε να διαγράψετε αυτό και τον φάκελο node_modules και εκτελέστε npm install ξανά. Αν κάποιο πακέτο απαιτεί νεότερη έκδοση Node.js, αλλάξτε την έκδοση στις ρυθμίσεις της εφαρμογής.
Αν οι αλλαγές στον κώδικα δεν εμφανίζονται μετά από restart, δημιουργήστε ή ενημερώστε το αρχείο tmp/restart.txt στον κατάλογο application root: touch tmp/restart.txt. Ο Passenger παρακολουθεί αυτό το αρχείο και επανεκκινεί την εφαρμογή όταν ανιχνεύσει αλλαγή. Μπορείτε επίσης να δοκιμάσετε να σταματήσετε την εφαρμογή, να περιμένετε μερικά δευτερόλεπτα και να την ξεκινήσετε ξανά από τον πίνακα ελέγχου.