Hvernig á að setja upp Monica á Ubuntu 18.04 LTS

Monica er opinn uppspretta persónuleg tengslastjórnunarkerfi. Hugsaðu um það sem CRM (vinsælt tól notað af söluteymum í fyrirtækjaheiminum) fyrir vini þína eða fjölskyldu. Frumkóði hans er hýst opinberlega á GitHub . Í þessari handbók munum við fara yfir uppsetningarferlið Monica forrits.

Kröfur

• Ubuntu Server 18.04 LTS (Bionic Beaver)
• Git
• NPM (Node Package Manager)
• PHP 7.1+ eða nýrri
• MySQL
• Nginx
• Tónskáld

Athugasemd um Git : Git mun líklegast vera þegar uppsett á Ubuntu þjóninum. Ef það er ekki, geturðu auðveldlega sett það upp með því að keyra:sudo apt install -y git

Athugaðu Ubuntu útgáfuna.

lsb_release -ds
# Ubuntu 18.04 LTS

Búðu til nýjan non-rootnotandareikning með sudoaðgangi og skiptu yfir í hann.

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

ATH : Skiptu út johndoefyrir notendanafnið þitt .

Settu upp tímabeltið.

sudo dpkg-reconfigure tzdata

Gakktu úr skugga um að kerfið þitt sé uppfært.

sudo apt update && sudo apt upgrade -y

Settu upp build-essentialog libpng-dev.

sudo apt install -y build-essential libpng-dev

Settu upp PHP

Settu upp PHP 7.2 og nauðsynlegar PHP viðbætur.

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

Athugaðu útgáfuna.

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

Settu upp MySQL og settu upp gagnagrunn

Settu upp MySQL.

sudo apt install -y mysql-server

Athugaðu útgáfuna.

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

Keyrðu mysql_secure installationhandritið til að bæta MySQL öryggi og stilltu lykilorðið fyrir MySQL rootnotandann.

sudo mysql_secure_installation

Tengstu við MySQL skel sem rót notandi.

sudo mysql -u root -p
# Enter password

Búðu til tóman MySQL gagnagrunn og notanda fyrir Monica og mundu skilríkin.

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

Settu upp og stilltu Nginx

Settu upp Nginx.

sudo apt install -y nginx

Athugaðu útgáfuna.

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

Keyra sudo vim /etc/nginx/sites-available/monica.confog stilla Nginx fyrir 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;
    }
}

Vistaðu skrána og hættu.

Virkjaðu nýju monica.confstillingarnar með því að tengja skrána við sites-enabledmöppuna.

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

Prófaðu stillinguna.

sudo nginx -t

Endurhlaða Nginx.

sudo systemctl reload nginx.service

Settu upp Node.js og NPM

Settu upp Node.js.

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

Athugaðu Node.js og npm útgáfurnar.

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

Settu upp Composer

Settu upp 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

Athugaðu útgáfuna.

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

Settu upp og stilltu Monica

Búðu til tóma skjalrótarmöppu þar sem Monica ætti að vera uppsett.

sudo mkdir -p /var/www/monica

Farðu í rótarmöppuna skjalsins.

cd /var/www/monica

Breyttu eignarhaldi á /var/www/monicamöppu í notanda johndoe.

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

Klónaðu Monica geymsluna við það.

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

ATH : Finndu nýjustu opinberu útgáfuna á útgáfusíðunni á GitHub og uppfærðu útgáfunúmerið hér að ofan í nýjustu útgáfuna.

Keyrðu eftirfarandi til að búa til þína eigin útgáfu af umhverfisbreytunum sem þarf fyrir verkefnið.

cp .env.example .env

Uppfærðu .envskrána að sérstökum þörfum þínum. Ekki gleyma að stilla DB_USERNAMEog DB_PASSWORDmeð stillingunum sem notaðar voru áður.

Settu upp alla pakka.

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

Settu upp allar framhliðarósjár og verkfæri sem þarf til að safna saman eignum.

npm install yarn
npm install

Settu saman JS og CSS eignirnar.

npm run production

Búðu til forritalykil. Þetta mun APP_KEYsjálfkrafa stilla á rétt gildi.

php artisan key:generate

Keyrðu flutningana og sáðu gagnagrunninn og samtengingarmöppurnar.

php artisan setup:production

Breyttu eignarhaldi /var/www/monicamöppunnar í www-data.

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

Hugsanlegt mál: Möppuuppbyggingu NPM pakkans vue-directive-tooltiphefur verið breytt, en monicahqstillingar hafa ekki breytt því ennþá (frá og með 09/2019). Til að laga það /var/www/monica/resources/assets/js/app.jsþarf að breyta eftirfarandi línu úr:

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

Uppsetningunni er lokið. Opnaðu lénið þitt í vafranum þínum og fylgdu leiðbeiningunum sem sýndar eru á skjánum.