Πώς να εγκαταστήσετε τη Monica στο Ubuntu 18.04 LTS

Η Monica είναι ένα σύστημα διαχείρισης προσωπικών σχέσεων ανοιχτού κώδικα. Σκεφτείτε το ως ένα CRM (ένα δημοφιλές εργαλείο που χρησιμοποιείται από τις ομάδες πωλήσεων στον εταιρικό κόσμο) για τους φίλους ή την οικογένειά σας. Ο πηγαίος του κώδικας φιλοξενείται δημόσια στο GitHub . Σε αυτόν τον οδηγό, θα εξετάσουμε τη διαδικασία εγκατάστασης μιας εφαρμογής Monica.

Απαιτήσεις

• Ubuntu Server 18.04 LTS (Bionic Beaver)
• Git
• NPM (Node Package Manager)
• PHP 7.1+ ή νεότερη
• MySQL
• Nginx
• Συνθέτης

Σημείωση σχετικά με το Git : Το Git πιθανότατα θα είναι ήδη εγκατεστημένο στον διακομιστή Ubuntu. Σε περίπτωση που δεν είναι, μπορείτε εύκολα να το εγκαταστήσετε εκτελώντας:sudo apt install -y git

Ελέγξτε την έκδοση του Ubuntu.

lsb_release -ds
# Ubuntu 18.04 LTS

Δημιουργήστε έναν νέο non-rootλογαριασμό χρήστη με sudoπρόσβαση και μεταβείτε σε αυτόν.

adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe

ΣΗΜΕΙΩΣΗ : Αντικαταστήστε το johndoeμε το όνομα χρήστη σας .

Ρυθμίστε τη ζώνη ώρας.

sudo dpkg-reconfigure tzdata

Βεβαιωθείτε ότι το σύστημά σας είναι ενημερωμένο.

sudo apt update && sudo apt upgrade -y

Εγκαταστήστε build-essentialκαι libpng-dev.

sudo apt install -y build-essential libpng-dev

Εγκαταστήστε την PHP

Εγκαταστήστε την PHP 7.2 και τις απαιτούμενες επεκτάσεις PHP.

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-xml php7.2-mysql php7.2-curl php7.2-zip php7.2-intl

Ελέγξτε την έκδοση.

php --version

# PHP 7.2.5-0ubuntu0.18.04.1 (cli) (built: May  9 2018 17:21:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.5-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

Εγκαταστήστε τη MySQL και δημιουργήστε μια βάση δεδομένων

Εγκαταστήστε MySQL.

sudo apt install -y mysql-server

Ελέγξτε την έκδοση.

mysql --version
# mysql  Ver 14.14 Distrib 5.7.22, for Linux (x86_64) using  EditLine wrapper

Εκτελέστε το mysql_secure installationσενάριο για να βελτιώσετε την ασφάλεια MySQL και ορίστε τον κωδικό πρόσβασης για τον rootχρήστη MySQL .

sudo mysql_secure_installation

Συνδεθείτε στο κέλυφος MySQL ως χρήστης ρίζας.

sudo mysql -u root -p
# Enter password

Δημιουργήστε μια κενή βάση δεδομένων MySQL και χρήστη για τη Monica και θυμηθείτε τα διαπιστευτήρια.

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;

Εγκαταστήστε και ρυθμίστε το Nginx

Εγκαταστήστε το Nginx.

sudo apt install -y nginx

Ελέγξτε την έκδοση.

sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)

Εκτελέστε sudo vim /etc/nginx/sites-available/monica.confκαι ρυθμίστε το Nginx για τη Monica.

server {
    listen 80;
    listen [::]:80;

    server_name example.com;
    root /var/www/monica/public;

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    }
}

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

Ενεργοποιήστε τη νέα monica.confδιαμόρφωση συνδέοντας το αρχείο στον sites-enabledκατάλογο.

sudo ln -s /etc/nginx/sites-available/monica.conf /etc/nginx/sites-enabled/

Δοκιμάστε τη διαμόρφωση.

sudo nginx -t

Επαναφόρτωση Nginx.

sudo systemctl reload nginx.service

Εγκαταστήστε το Node.js και το NPM

Εγκαταστήστε το Node.js.

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs

Ελέγξτε τις εκδόσεις Node.js και npm.

node -v && npm -v
# v10.2.1
# 5.6.0

Εγκαταστήστε το Composer

Εγκαταστήστε το Composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

Ελέγξτε την έκδοση.

composer --version
# Composer version 1.6.5 2018-05-04 11:44:59

Εγκαταστήστε και διαμορφώστε τη Monica

Δημιουργήστε έναν κενό ριζικό φάκελο εγγράφων όπου θα πρέπει να εγκατασταθεί η Monica.

sudo mkdir -p /var/www/monica

Μεταβείτε στον ριζικό φάκελο του εγγράφου.

cd /var/www/monica

Αλλαγή ιδιοκτησίας /var/www/monicaφακέλου σε χρήστη johndoe.

sudo chown -R johndoe:johndoe /var/www/monica

Κλωνοποιήστε το αποθετήριο Monica σε αυτό.

git clone https://github.com/monicahq/monica.git .
git checkout tags/v2.1.1

ΣΗΜΕΙΩΣΗ : Βρείτε την πιο πρόσφατη επίσημη έκδοση στη σελίδα εκδόσεων στο GitHub και ενημερώστε τον παραπάνω αριθμό έκδοσης στην πιο πρόσφατη έκδοση.

Εκτελέστε τα παρακάτω για να δημιουργήσετε τη δική σας έκδοση των μεταβλητών περιβάλλοντος που απαιτούνται για το έργο.

cp .env.example .env

Ενημερώστε το .envαρχείο στις συγκεκριμένες ανάγκες σας. Μην ξεχάσετε να ορίσετε DB_USERNAMEκαι DB_PASSWORDμε τις ρυθμίσεις που χρησιμοποιήθηκαν προηγουμένως.

Εγκαταστήστε όλα τα πακέτα.

composer install --no-interaction --no-suggest --no-dev --ignore-platform-reqs

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

npm install yarn
npm install

Μεταγλώττιση των στοιχείων JS και CSS.

npm run production

Δημιουργήστε ένα κλειδί εφαρμογής. Αυτό θα ρυθμιστεί APP_KEYαυτόματα στη σωστή τιμή.

php artisan key:generate

Εκτελέστε τις μετεγκαταστάσεις και δημιουργήστε τη βάση δεδομένων και τους φακέλους συμβολικών συνδέσμων.

php artisan setup:production

Αλλάξτε την ιδιοκτησία του /var/www/monicaκαταλόγου σε www-data.

sudo chown -R www-data:www-data /var/www/monica

Πιθανό πρόβλημα: Το πακέτο NPM vue-directive-tooltipάλλαξε τη δομή του καταλόγου του, αλλά η διαμόρφωση monicahqδεν το έχει αλλάξει ακόμα (από τις 09/2019). Για να διορθωθεί αυτό, η ακόλουθη γραμμή /var/www/monica/resources/assets/js/app.jsπρέπει να αλλάξει από:

import 'vue-directive-tooltip/css/index.css'
to
import 'vue-directive-tooltip/src/css/index.css'

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