Как установить Монику на Ubuntu 18.04 LTS

• Требования
• Установить PHP
• Установите MySQL и настройте базу данных
• Установите и настройте Nginx
• Установите Node.js и NPM
• Установите Composer
• Установите и настройте Монику

Monica - это система управления личными отношениями с открытым исходным кодом. Думайте об этом как о CRM (популярном инструменте, который используется командами по продажам в корпоративном мире) для ваших друзей или семьи. Его исходный код размещен на GitHub . В этом руководстве мы рассмотрим процесс установки приложения Monica.

Требования

• Ubuntu Server 18.04 LTS (Бионический Бобр)
• Гит
• NPM (менеджер пакетов узлов)
• 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 от имени пользователя root.

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 для Моники.

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.

sudo mkdir -p /var/www/monica

Перейдите в корневую папку документа.

cd /var/www/monica

Смена владельца /var/www/monicaпапки на пользователя johndoe.

sudo chown -R johndoe:johndoe /var/www/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'

Установка завершена. Откройте свой домен в веб-браузере и следуйте инструкциям на экране.