Követelmények
PHP telepítése
Telepítse a MySQL-t és állítson be egy adatbázist
Telepítse és konfigurálja az Nginx-et
Telepítse a Node.js-t és az NPM-et
Telepítse a Composert
Telepítse és konfigurálja a Monicát
A Monica egy nyílt forráskódú személyes kapcsolatkezelő rendszer. Tekints rá úgy, mint egy CRM-re (az értékesítési csapatok által a vállalati világban használt népszerű eszköz) barátaid vagy családod számára. Forráskódja nyilvánosan a GitHubon található . Ebben az útmutatóban egy Monica-alkalmazás telepítési folyamatát tekintjük át.
Követelmények
- Ubuntu Server 18.04 LTS (Bionic Beaver)
- Git
- NPM (Node Package Manager)
- PHP 7.1+ vagy újabb
- MySQL
- Nginx
- Zeneszerző
Megjegyzés a Gitről : A Git valószínűleg már telepítve lesz az Ubuntu szerveren. Ha nem, akkor egyszerűen telepítheti a következő futtatásával:sudo apt install -y git
Ellenőrizze az Ubuntu verziót.
lsb_release -ds
# Ubuntu 18.04 LTS
Hozzon létre egy új non-rootfelhasználói fiókot sudohozzáféréssel, és váltson rá.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
MEGJEGYZÉS : Cserélje johndoeki a felhasználónevével .
Állítsa be az időzónát.
sudo dpkg-reconfigure tzdata
Győződjön meg arról, hogy rendszere naprakész.
sudo apt update && sudo apt upgrade -y
Telepítse build-essentialés libpng-dev.
sudo apt install -y build-essential libpng-dev
PHP telepítése
Telepítse a PHP 7.2-t és a szükséges PHP-bővítményeket.
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
Ellenőrizze a verziót.
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
Telepítse a MySQL-t és állítson be egy adatbázist
Telepítse a MySQL-t.
sudo apt install -y mysql-server
Ellenőrizze a verziót.
mysql --version
# mysql Ver 14.14 Distrib 5.7.22, for Linux (x86_64) using EditLine wrapper
Futtassa a mysql_secure installationszkriptet a MySQL biztonságának javításához, és állítsa be a MySQL- rootfelhasználó jelszavát .
sudo mysql_secure_installation
Csatlakozzon a MySQL shellhez root felhasználóként.
sudo mysql -u root -p
# Enter password
Hozzon létre egy üres MySQL adatbázist és felhasználót Monica számára, és emlékezzen a hitelesítő adatokra.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;
Telepítse az Nginx-et.
sudo apt install -y nginx
Ellenőrizze a verziót.
sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)
Futtassa sudo vim /etc/nginx/sites-available/monica.confés konfigurálja az Nginxet Monica számára.
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;
}
}
Mentse el a fájlt és lépjen ki.
Aktiválja az új monica.confkonfigurációt a fájlnak a sites-enabledkönyvtárhoz való csatolásával .
sudo ln -s /etc/nginx/sites-available/monica.conf /etc/nginx/sites-enabled/
Tesztelje a konfigurációt.
sudo nginx -t
Töltse újra az Nginxet.
sudo systemctl reload nginx.service
Telepítse a Node.js-t és az NPM-et
Telepítse a Node.js-t.
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs
Ellenőrizze a Node.js és npm verziókat.
node -v && npm -v
# v10.2.1
# 5.6.0
Telepítse a Composert
Telepítse a Composert.
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
Ellenőrizze a verziót.
composer --version
# Composer version 1.6.5 2018-05-04 11:44:59
Hozzon létre egy üres dokumentum gyökérmappát, ahová a Monica telepítenie kell.
sudo mkdir -p /var/www/monica
Navigáljon a dokumentum gyökérmappájához.
cd /var/www/monica
A /var/www/monicamappa tulajdonjogának módosítása felhasználóra johndoe.
sudo chown -R johndoe:johndoe /var/www/monica
Klónozza rá a Monica adattárat.
git clone https://github.com/monicahq/monica.git .
git checkout tags/v2.1.1
MEGJEGYZÉS : Keresse meg a legújabb hivatalos verziót a GitHub kiadási oldalán, és frissítse a fenti verziószámot a legújabb kiadásra.
Futtassa a következőket a projekthez szükséges környezeti változók saját verziójának létrehozásához.
cp .env.example .env
Frissítse a .envfájlt saját igényei szerint. Ne felejtse el beállítani DB_USERNAMEés DB_PASSWORDa korábban használt beállításokkal.
Telepítse az összes csomagot.
composer install --no-interaction --no-suggest --no-dev --ignore-platform-reqs
Telepítse az összes előtér-függőséget és eszközt, amely az eszközök fordításához szükséges.
npm install yarn
npm install
Fordítsa le a JS- és CSS-eszközöket.
npm run production
Alkalmazáskulcs létrehozása. Ez automatikusan beállítja APP_KEYa megfelelő értéket.
php artisan key:generate
Futtassa az áttelepítéseket, és indítsa el az adatbázist és a symlink mappákat.
php artisan setup:production
Módosítsa a /var/www/monicacímtár tulajdonjogát erre: www-data.
sudo chown -R www-data:www-data /var/www/monica
Lehetséges probléma: Az NPM-csomag vue-directive-tooltipkönyvtárszerkezete megváltozott, de a monicahqkonfiguráció még nem változtatta meg (2019.09.). Ennek kijavításához a következő sort /var/www/monica/resources/assets/js/app.jskell módosítani erről:
import 'vue-directive-tooltip/css/index.css'
to
import 'vue-directive-tooltip/src/css/index.css'
A telepítés befejeződött. Nyissa meg domainjét webböngészőjében, és kövesse a képernyőn megjelenő utasításokat.