Πώς να εγκαταστήσετε το Directus 6.4 CMS σε ένα FreeBSD 11 FAMP VPS

Το Directus 6.4 CMS είναι ένα ισχυρό και ευέλικτο, δωρεάν και ανοιχτού κώδικα Headless Content Management System (CMS) που παρέχει στους προγραμματιστές μια απλή και διαισθητική διεπαφή ιστού για τη διαχείριση περιεχομένου βάσης δεδομένων με εντελώς προσαρμοσμένες αρχιτεκτονικές. Τα παραδοσιακά CMS είναι κατασκευασμένα ως κλειστές πλατφόρμες ειδικά για γρήγορη ανάπτυξη και διαχείριση ιστοτόπων – συνήθως απλών τοποθεσιών και ιστολογίων. Ωστόσο, το σημερινό περιεχόμενο καταναλώνεται από ένα πολύ ευρύτερο φάσμα εφαρμογών, συμπεριλαμβανομένων πολύπλοκων πλατφορμών ιστού, εγγενών εφαρμογών, φορητών συσκευών, περιπτέρων, συσκευών IoT και άλλων έργων που βασίζονται σε δεδομένα. Το Directus 6.4 Headless CMS επιτρέπει τη διαχείριση του περιεχομένου ανεξάρτητα από το μέρος που θα χρησιμοποιηθεί. Με την αποσύνδεση και τη σύνταξη αγνωστικού περιεχομένου εφαρμογής,

Σε αυτό το σεμινάριο θα εγκαταστήσουμε το Directus 6.4 CMS σε ένα FreeBSD 11 FAMP VPS χρησιμοποιώντας διακομιστή ιστού Apache, PHP 7.1 και μια βάση δεδομένων MariaDB.

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

• Μια καθαρή παρουσία διακομιστή Vultr FreeBSD 11 με πρόσβαση SSH

Βήμα 1: Προσθήκη χρήστη Sudo

Θα ξεκινήσουμε προσθέτοντας έναν νέο sudoχρήστη.

Πρώτα, συνδεθείτε στον διακομιστή σας ως root:

ssh root@YOUR_VULTR_IP_ADDRESS

Η sudoεντολή δεν είναι εγκατεστημένη από προεπιλογή στην παρουσία διακομιστή Vultr FreeBSD 11, επομένως θα εγκαταστήσουμε πρώτα sudo:

pkg install sudo

Τώρα προσθέστε έναν νέο χρήστη που ονομάζεται user1(ή το όνομα χρήστη που προτιμάτε):

adduser user1

Η adduserεντολή θα σας ζητήσει πολλές λεπτομέρειες για τον λογαριασμό χρήστη, επομένως απλώς επιλέξτε τις προεπιλογές για τα περισσότερα από αυτά όταν είναι λογικό να το κάνετε. Όταν ερωτηθείτε εάν να Invite user1 into any other groups?, θα πρέπει να εισάγετε wheelγια να προσθέσετε user1στην wheelομάδα.

Τώρα ελέγξτε το /etc/sudoersαρχείο για να βεβαιωθείτε ότι η sudoersομάδα είναι ενεργοποιημένη:

visudo

Αναζητήστε μια ενότητα όπως αυτή:

# %wheel        ALL=(ALL)       ALL

Αυτή η γραμμή μας λέει ότι οι χρήστες που είναι μέλη της wheelομάδας μπορούν να χρησιμοποιήσουν την sudoεντολή για να αποκτήσουν rootπρονόμια. Θα σχολιαστεί από προεπιλογή, επομένως θα χρειαστεί να το αποσχολιάσετε και στη συνέχεια να το αποθηκεύσετε και να βγείτε από το αρχείο.

Μπορούμε να επαληθεύσουμε τη user1συμμετοχή στην ομάδα με την groupsεντολή:

groups user1

Εάν user1δεν wheelείστε μέλος της ομάδας, μπορείτε να χρησιμοποιήσετε αυτήν την εντολή για να ενημερώσετε τη user1συνδρομή της ομάδας:

pw group mod wheel -m user1 

Τώρα χρησιμοποιήστε την suεντολή για να μεταβείτε στον νέο user1λογαριασμό χρήστη sudo :

su - user1

Η γραμμή εντολών θα ενημερωθεί για να υποδείξει ότι είστε πλέον συνδεδεμένοι στο user1λογαριασμό. Μπορείτε να το επαληθεύσετε με την whoamiεντολή:

whoami

Τώρα επανεκκινήστε την sshdυπηρεσία, ώστε να μπορείτε να συνδεθείτε μέσω sshτου νέου λογαριασμού χρήστη sudo που δεν είναι root που μόλις δημιουργήσατε:

sudo /etc/rc.d/sshd restart

Έξοδος από τον user1λογαριασμό:

exit

Έξοδος από τον rootλογαριασμό (που θα αποσυνδέσει τη sshσυνεδρία σας ):

exit

Μπορείτε τώρα να εισέλθετε sshστην παρουσία διακομιστή από τον τοπικό σας κεντρικό υπολογιστή χρησιμοποιώντας τον νέο user1λογαριασμό χρήστη sudo που δεν είναι root :

ssh user1@YOUR_VULTR_IP_ADDRESS

Εάν θέλετε να εκτελέσετε sudo χωρίς να χρειάζεται να πληκτρολογείτε κωδικό πρόσβασης κάθε φορά, ανοίξτε /etc/sudoersξανά το αρχείο χρησιμοποιώντας visudo:

sudo visudo

Επεξεργαστείτε την ενότητα για την wheelομάδα έτσι ώστε να μοιάζει με αυτό:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Σημείωση: Η απενεργοποίηση της απαίτησης κωδικού πρόσβασης για τον χρήστη sudo δεν είναι μια συνιστώμενη πρακτική, αλλά περιλαμβάνεται εδώ, καθώς μπορεί να κάνει τη διαμόρφωση του διακομιστή πολύ πιο βολική και λιγότερο ενοχλητική, ειδικά κατά τη διάρκεια μεγαλύτερων περιόδων διαχείρισης συστημάτων. Εάν ανησυχείτε για τις επιπτώσεις στην ασφάλεια, μπορείτε πάντα να επαναφέρετε την αλλαγή διαμόρφωσης στην αρχική, αφού ολοκληρώσετε τις εργασίες διαχείρισης.

Κάθε φορά που θέλετε να συνδεθείτε στον rootλογαριασμό χρήστη μέσα από τον sudoλογαριασμό χρήστη, μπορείτε να χρησιμοποιήσετε μία από τις ακόλουθες εντολές:

sudo -i
sudo su -

Μπορείτε να βγείτε από τον rootλογαριασμό και να επιστρέψετε στον sudoλογαριασμό χρήστη σας ανά πάσα στιγμή πληκτρολογώντας απλώς:

exit

Βήμα 2: Ενημερώστε το σύστημα FreeBSD 11

Πριν εγκαταστήσουμε οποιοδήποτε πακέτο στην παρουσία του διακομιστή FreeBSD, θα ενημερώσουμε πρώτα το σύστημα.

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

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Βήμα 3: Εγκαταστήστε τον διακομιστή Web Apache

Εγκαταστήστε τον διακομιστή ιστού Apache:

sudo pkg install apache24

Εισαγάγετε yόταν σας ζητηθεί.

Τώρα χρησιμοποιήστε την sysrcεντολή για να ενεργοποιήσετε την υπηρεσία Apache να εκτελείται αυτόματα κατά την εκκίνηση:

sudo sysrc apache24_enable=yes

Η sysrcεντολή ενημερώνει το /etc/rc.confαρχείο διαμόρφωσης, επομένως εάν θέλετε να επαληθεύσετε την ενημέρωση διαμόρφωσης με μη αυτόματο τρόπο, μπορείτε απλώς να ανοίξετε το /etc/rc.confαρχείο με τον αγαπημένο σας επεξεργαστή τερματικού:

vi /etc/rc.conf

Τώρα ξεκινήστε την υπηρεσία Apache:

sudo service apache24 start

Μπορείτε να ελέγξετε γρήγορα ότι ο apache εκτελείται μεταβαίνοντας στη διεύθυνση IP ή τον τομέα του στιγμιότυπου διακομιστή στο πρόγραμμα περιήγησής σας:

http://YOUR_VULTR_IP_ADDRESS/

Θα δείτε την προεπιλεγμένη σελίδα FreeBSD Apache που εμφανίζει το κείμενο:

It works!

Ελέγξτε το προεπιλεγμένο αρχείο ρυθμίσεων του Apache για να βεβαιωθείτε ότι η DocumentRootοδηγία οδηγεί στον σωστό κατάλογο:

sudo vi /usr/local/etc/apache24/httpd.conf

Η DocumentRootεπιλογή διαμόρφωσης θα μοιάζει με αυτό:

DocumentRoot "/usr/local/www/apache24/data"

Τώρα πρέπει να ενεργοποιήσουμε τη mod_rewriteλειτουργική μονάδα Apache. Μπορούμε να το κάνουμε αυτό κάνοντας αναζήτηση στο προεπιλεγμένο αρχείο διαμόρφωσης του Apache για τον όρο mod_rewrite.

Από προεπιλογή, η mod_rewriteμονάδα Apache θα σχολιαστεί (που σημαίνει ότι είναι απενεργοποιημένη). Η γραμμή διαμόρφωσης σε μια καθαρή παρουσία του Vultr FreeBSD 11 θα μοιάζει με αυτό:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Απλώς αφαιρέστε το σύμβολο κατακερματισμού για να αποσχολιάσετε τη γραμμή και να φορτώσετε τη μονάδα. Αυτό, φυσικά, ισχύει και για οποιεσδήποτε άλλες απαιτούμενες μονάδες Apache:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Τώρα πρέπει να επεξεργαστούμε την Directoryοδηγία Apache στο ίδιο αρχείο ρυθμίσεων, ώστε mod_rewriteνα λειτουργεί σωστά με το Directus CMS.

Βρείτε την ενότητα του αρχείου διαμόρφωσης που ξεκινά με <Directory "/usr/local/www/apache24/data">και αλλάξτε AllowOverride noneσε AllowOverride All. Το τελικό αποτέλεσμα (με όλα τα σχόλια αφαιρεμένα) θα μοιάζει κάπως έτσι:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Τώρα αποθηκεύστε και βγείτε από το αρχείο διαμόρφωσης Apache.

Θα κάνουμε επανεκκίνηση του Apache στο τέλος αυτού του σεμιναρίου, αλλά η τακτική επανεκκίνηση του Apache κατά την εγκατάσταση και τη ρύθμιση παραμέτρων είναι σίγουρα μια καλή συνήθεια, οπότε ας το κάνουμε τώρα:

sudo service apache24 restart

Βήμα 4: Εγκαταστήστε την PHP 7.1

Μπορούμε τώρα να εγκαταστήσουμε την PHP 7.1 μαζί με όλες τις απαραίτητες ενότητες PHP που απαιτούνται από το Directus CMS:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar 

Το FreeBSD 11 μας δίνει την επιλογή να χρησιμοποιήσουμε μια ανάπτυξη php.iniή μια παραγωγή php.ini. Εφόσον πρόκειται να εγκαταστήσουμε το Directus σε έναν δημόσιο διακομιστή ιστού, θα χρησιμοποιήσουμε την έκδοση παραγωγής. Πρώτα, δημιουργήστε αντίγραφα ασφαλείας php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

Στη συνέχεια, συνδέστε απαλά php.ini-productionμε php.ini:

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Πρέπει να ρυθμίσουμε τον Apache ώστε να χρησιμοποιεί πραγματικά την PHP, οπότε ας δημιουργήσουμε ένα νέο αρχείο που ονομάζεται php.confστον Includesκατάλογο Apache :

sudo vi /usr/local/etc/apache24/Includes/php.conf

Εισαγάγετε το ακόλουθο κείμενο στο νέο αρχείο:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

Αποθηκεύστε και βγείτε από το αρχείο.

Τώρα ας κάνουμε επανεκκίνηση του Apache για να μπορέσει να φορτώσει ξανά τις αλλαγές διαμόρφωσης:

sudo service apache24 restart

Βήμα 5: Εγκαταστήστε το διακομιστή MariaDB (MySQL).

Το FreeBSD 11 χρησιμοποιεί ως προεπιλογή τον διακομιστή βάσης δεδομένων MariaDB, ο οποίος είναι ένας βελτιωμένος, πλήρως ανοιχτού κώδικα, αναπτυγμένος από την κοινότητα, drop-in αντικατάσταση του διακομιστή MySQL.

Εγκαταστήστε την πιο πρόσφατη έκδοση του διακομιστή βάσης δεδομένων MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Ξεκινήστε και ενεργοποιήστε τον διακομιστή MariaDB να εκτελείται αυτόματα κατά την εκκίνηση:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Ασφαλίστε την εγκατάσταση του διακομιστή MariaDB:

sudo mysql_secure_installation

Όταν σας ζητηθεί να δημιουργήσετε έναν rootχρήστη MariaDB/MySQL , επιλέξτε "Y" (για ναι) και, στη συνέχεια, εισαγάγετε έναν ασφαλή rootκωδικό πρόσβασης. Απλώς απαντήστε "Y" σε όλες τις άλλες ερωτήσεις ναι/όχι καθώς οι προεπιλεγμένες προτάσεις είναι οι πιο ασφαλείς επιλογές.

Βήμα 6: Δημιουργία βάσης δεδομένων για Directus CMS

Συνδεθείτε στο κέλυφος MariaDB ως rootχρήστης MariaDB εκτελώντας την ακόλουθη εντολή:

sudo mysql -u root -p

Για πρόσβαση στη γραμμή εντολών MariaDB, απλώς εισαγάγετε τον rootκωδικό πρόσβασης MariaDB όταν σας ζητηθεί.

Εκτελέστε τα ακόλουθα ερωτήματα για να δημιουργήσετε μια βάση δεδομένων MariaDB και χρήστη βάσης δεδομένων για το Directus CMS:

CREATE DATABASE directus_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'directus_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON directus_db.* TO 'directus_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Μπορείτε να αντικαταστήσετε το όνομα της βάσης δεδομένων directus_dbκαι το όνομα χρήστη directus_userμε κάτι περισσότερο της αρεσκείας σας, αν προτιμάτε. Επίσης, βεβαιωθείτε ότι έχετε αντικαταστήσει τον "UltraSecurePassword" με έναν πραγματικά ασφαλή κωδικό πρόσβασης.

Βήμα 7: Εγκαταστήστε τα αρχεία Directus CMS

Αλλάξτε τον τρέχοντα κατάλογο εργασίας σας στον προεπιλεγμένο κατάλογο ιστού:

cd /usr/local/www/apache24/data

Ο τρέχων κατάλογος εργασίας σας θα είναι τώρα: /usr/local/www/apache24/data. Μπορείτε να το ελέγξετε με την pwdεντολή (print working directory):

pwd

Τώρα χρησιμοποιήστε το wgetγια λήψη του πακέτου εγκατάστασης του Directus CMS:

sudo wget https://github.com/directus/directus/releases/download/6.4.4/directus-build-6.4.4-20171120114156.zip

Σημείωση: Πρέπει οπωσδήποτε να ελέγξετε για την πιο πρόσφατη έκδοση μεταβαίνοντας στη σελίδα λήψης του Directus CMS .

Καταχωρίστε τον τρέχοντα κατάλογο για να ελέγξετε ότι κατεβάσατε με επιτυχία το αρχείο:

ls -la

Αφαίρεση index.html:

sudo rm index.html

Τώρα αποσυμπιέστε το αρχείο zip:

sudo unzip directus-build-6.4.4-20171120114156.zip

Μετακινήστε όλα τα αρχεία εγκατάστασης στον ριζικό κατάλογο ιστού:

sudo mv directus-build-6.4.4-20171120114156/* /usr/local/www/apache24/data

Αλλάξτε την ιδιοκτησία των αρχείων Ιστού για να αποφύγετε τυχόν προβλήματα αδειών:

sudo chown -R www:www * ./

Επανεκκινήστε ξανά τον Apache.

sudo service apache24 restart

Τώρα είμαστε έτοιμοι να προχωρήσουμε στο τελευταίο βήμα.

Βήμα 8: Ολοκληρώστε την εγκατάσταση του Directus CMS

Ήρθε η ώρα να επισκεφτείτε τη διεύθυνση IP της παρουσίας του διακομιστή σας στο πρόγραμμα περιήγησής σας ή εάν έχετε ήδη διαμορφώσει τις ρυθμίσεις του Vultr DNS (και του έχετε δώσει αρκετό χρόνο για να διαδοθεί), μπορείτε απλώς να επισκεφτείτε τον τομέα σας.

Για να αποκτήσετε πρόσβαση στη σελίδα εγκατάστασης του Directus CMS, εισαγάγετε τη διεύθυνση IP της παρουσίας Vultr στη γραμμή διευθύνσεων του προγράμματος περιήγησής σας, ακολουθούμενη από /installation/index.php:

http://YOUR_VULTR_IP_ADDRESS/installation/index.php

Οι περισσότερες από τις επιλογές εγκατάστασης είναι αυτονόητες, αλλά εδώ είναι μερικές υποδείξεις που θα σας βοηθήσουν:

1. Επιλέξτε τη γλώσσα σας και κάντε κλικ στο Nextκουμπί για να συνεχίσετε.

2. Εισαγάγετε τα κατάλληλα στοιχεία Project Nameκαι τα στοιχεία σύνδεσης διαχειριστή όπως φαίνεται παρακάτω:

   PROJECT NAME:           <project name>  
   ADMIN EMAIL:            <admin email>
   ADMIN PASSWORD:         <admin password>    
   

   Κάντε κλικ Nextγια να συνεχίσετε.

3. Τώρα εισαγάγετε τις ακόλουθες τιμές βάσης δεδομένων:

   DATABASE TYPE:          MySQL/Percona
   HOST:                   localhost
   PORT:                   3306
   USER:                   directus_user
   PASSWORD:               UltraSecurePassword
   DATABASE NAME:          directus_db                 
   INITIAL SCHEMA:         None Clean Database
   

   Κάντε κλικ Nextγια να συνεχίσετε.

4. Θα εμφανιστεί μια σελίδα ελέγχου προεγκατάστασης που δείχνει τις επιλογές που επιλέξατε και τυχόν προβλήματα που μπορεί να έχει εντοπίσει το πρόγραμμα εγκατάστασης. Εάν δείτε ένα σφάλμα με τη mod_rewriteμονάδα να εμφανίζεται ως απεγκατεστημένη ή απενεργοποιημένη, όταν την έχετε εγκαταστήσει και την έχετε ενεργοποιήσει, μπορείτε απλά να αγνοήσετε την προειδοποίηση, καθώς όλα θα λειτουργούν μια χαρά.

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

Μόλις ολοκληρωθεί η εγκατάσταση, θα ανακατευθυνθείτε στη σελίδα σύνδεσης διαχειριστή. Εάν δεν ανακατευθυνθείτε, μπορείτε να εισαγάγετε τη διεύθυνση σύνδεσης διαχειριστή με μη αυτόματο τρόπο:

http://YOUR_VULTR_IP_ADDRESS/login.php

Για λόγους ασφαλείας, βεβαιωθείτε ότι έχετε διαγράψει τον /installation/κατάλογο από τον κατάλογο webroot:

sudo rm -rf ./installation/

Τώρα είστε έτοιμοι να αρχίσετε να προσθέτετε το περιεχόμενό σας και να διαμορφώνετε το Headless CMS ώστε να λειτουργεί με τις διάφορες εφαρμογές σας. Βεβαιωθείτε ότι έχετε ελέγξει την εξαιρετική τεκμηρίωση του Directus CMS για περισσότερες πληροφορίες σχετικά με τον τρόπο διαμόρφωσης του Directus CMS και τη σύνδεσή του με τις διαφορετικές εφαρμογές και πλαίσια.