Данный документ содержит информацию о том, как скачать исходный код приложения, произвести базовые настройки и запустить приложение на локальной среде.
Инструкция ниже описывает по пунктам требования к ресурсам системы, используемым инструмента, а также последовательность шагов для разворачивания проекта с нуля.
На этой странице:
Системные требования
Для развёртывания локального окружения убедитесь, что у вас локально:
- Debian >= 9 or Ubuntu >= 16.04
- docker >= 18.0 (installing manual)
- docker-compose >= 1.22 (installing manual)
- make >= 4.1(install: apt-get install make)
- git >= 2.25 (install: apt-get install git)
- Порт 8080 свободен для подключения (netstat -tulpn | grep :8080)
- Более 10G свободного дискового пространства
Реквизиты с доступами к системе
Получить у администратора:
- Доступ к репозиторию с исходными кодами:
https://bitbucket.hello-print.ru - Доступ в личный кабинет приложения после его установки:
https://template.helloprint.local
Исходный код приложения
Для скачивания исходного кода приложения необходимо:
Создать на локальной среде директорию:
$ sudo mkdir template.helloprint.local
Скачать исходный код приложения из репозитория:
$ sudo git clone --branch master https://bitbucket.hello-print.ru/scm/hel/erp.git .
Быстрый запуск
Для быстрого запуска приложения необходимо выполнить следующие команды:
Установить базовые настройки:
$ sudo make TAG=template NGINX_PORT=8080 init
Запустить скачивание образов инфраструктуры, базы данных и выполнить установку и запуск приложения:
$ sudo make TAG=template NGINX_PORT=8080 up
Выполнить настройку интерфейсов:
$ sudo make TAG=template NGINX_PORT=8080 build
После успешного выполнения приведенных выше команд система должна быть доступна по локальному адресу и порту:
Расширенные возможности
Общий список доступных команд можно получить следующим образом:
$ make help