Kërkesat
Instaloni PHP
Instaloni MySQL dhe konfiguroni një bazë të dhënash
Instaloni dhe konfiguroni Nginx
Instaloni Node.js dhe NPM
Instaloni Composer
Instaloni dhe konfiguroni Monica
Monica është një sistem i menaxhimit të marrëdhënieve personale me burim të hapur. Mendoni si një CRM (një mjet popullor i përdorur nga ekipet e shitjeve në botën e korporatave) për miqtë ose familjen tuaj. Kodi burimor i tij është i pritur publikisht në GitHub . Në këtë udhëzues, ne do të shqyrtojmë procesin e instalimit të një aplikacioni Monica.
Kërkesat
- Serveri Ubuntu 18.04 LTS (Bionic Beaver)
- Git
- NPM (Menaxheri i paketës së nyjeve)
- PHP 7.1+ ose më i ri
- MySQL
- Nginx
- Kompozitor
Shënim rreth Git : Git ka shumë të ngjarë të jetë i instaluar tashmë në serverin Ubuntu. Në rast se nuk është, mund ta instaloni lehtësisht duke ekzekutuar:sudo apt install -y git
Kontrolloni versionin e Ubuntu.
lsb_release -ds
# Ubuntu 18.04 LTS
Krijoni një non-rootllogari të re përdoruesi me sudoakses dhe kaloni në të.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
SHËNIM : Zëvendësojeni johndoeme emrin tuaj të përdoruesit .
Vendosni zonën kohore.
sudo dpkg-reconfigure tzdata
Sigurohuni që sistemi juaj të jetë i përditësuar.
sudo apt update && sudo apt upgrade -y
Instaloni build-essentialdhe libpng-dev.
sudo apt install -y build-essential libpng-dev
Instaloni PHP
Instaloni PHP 7.2 dhe shtesat e kërkuara 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
Kontrolloni versionin.
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
Instaloni MySQL dhe konfiguroni një bazë të dhënash
Instaloni MySQL.
sudo apt install -y mysql-server
Kontrolloni versionin.
mysql --version
# mysql Ver 14.14 Distrib 5.7.22, for Linux (x86_64) using EditLine wrapper
Ekzekutoni mysql_secure installationskriptin për të përmirësuar sigurinë e MySQL dhe vendosni fjalëkalimin për rootpërdoruesin e MySQL .
sudo mysql_secure_installation
Lidhu me guaskën MySQL si përdorues rrënjë.
sudo mysql -u root -p
# Enter password
Krijoni një bazë të dhënash dhe përdorues bosh MySQL për Monica dhe mbani mend kredencialet.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;
Instaloni Nginx.
sudo apt install -y nginx
Kontrolloni versionin.
sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)
Ekzekutoni sudo vim /etc/nginx/sites-available/monica.confdhe konfiguroni Nginx për 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;
}
}
Ruani skedarin dhe dilni.
Aktivizoni monica.confkonfigurimin e ri duke e lidhur skedarin me sites-enableddrejtorinë.
sudo ln -s /etc/nginx/sites-available/monica.conf /etc/nginx/sites-enabled/
Testoni konfigurimin.
sudo nginx -t
Rifresko Nginx.
sudo systemctl reload nginx.service
Instaloni Node.js dhe NPM
Instaloni Node.js.
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt install -y nodejs
Kontrolloni versionet Node.js dhe npm.
node -v && npm -v
# v10.2.1
# 5.6.0
Instaloni Composer
Instaloni 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
Kontrolloni versionin.
composer --version
# Composer version 1.6.5 2018-05-04 11:44:59
Krijoni një dosje të zbrazët rrënjësore të dokumentit ku duhet të instalohet Monica.
sudo mkdir -p /var/www/monica
Navigoni te dosja rrënjë e dokumentit.
cd /var/www/monica
Ndrysho pronësinë e /var/www/monicadosjes në përdorues johndoe.
sudo chown -R johndoe:johndoe /var/www/monica
Klononi depon e Monica në të.
git clone https://github.com/monicahq/monica.git .
git checkout tags/v2.1.1
SHËNIM : Gjeni versionin më të fundit zyrtar në faqen e publikimeve në GitHub dhe përditësoni numrin e versionit të mësipërm në versionin më të fundit.
Ekzekutoni sa vijon për të krijuar versionin tuaj të variablave të mjedisit të nevojshëm për projektin.
cp .env.example .env
Përditësoni .envskedarin sipas nevojave tuaja specifike. Mos harroni të vendosni DB_USERNAMEdhe DB_PASSWORDme cilësimet e përdorura më parë.
Instaloni të gjitha paketat.
composer install --no-interaction --no-suggest --no-dev --ignore-platform-reqs
Instaloni të gjitha varësitë dhe mjetet e nevojshme për përpilimin e aseteve.
npm install yarn
npm install
Përpiloni asetet JS dhe CSS.
npm run production
Gjeneroni një çelës aplikacioni. Kjo do të vendoset APP_KEYnë vlerën e saktë automatikisht.
php artisan key:generate
Ekzekutoni migrimet dhe vendosni bazën e të dhënave dhe dosjet e lidhjeve simbolike.
php artisan setup:production
Ndrysho pronësinë e /var/www/monicadrejtorisë në www-data.
sudo chown -R www-data:www-data /var/www/monica
Problem i mundshëm: Paketa NPM vue-directive-tooltipka ndryshuar strukturën e drejtorisë së saj, por monicahqkonfigurimi nuk e ka ndryshuar ende atë (që nga 09/2019). Për ta rregulluar këtë, linja e mëposhtme /var/www/monica/resources/assets/js/app.jsduhet të ndryshohet nga:
import 'vue-directive-tooltip/css/index.css'
to
import 'vue-directive-tooltip/src/css/index.css'
Instalimi ka përfunduar. Hapni domenin tuaj në shfletuesin tuaj të internetit dhe ndiqni udhëzimet e shfaqura në ekran.