Данный документ содержит информацию о том, как скачать исходный код программного обеспечения, произвести базовые настройки и запустить программное обеспечение на локальной среде.
Содержание:
Оглавление |
---|
Системные требования
Для развёртывания локального окружения убедитесь, что у вас локально:
- 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
Исходный код программного обеспечения
Для скачивания исходного кода программного обеспечения необходимо:
Создать на локальной среде директорию с проектом:
Блок кода language bash $ sudo mkdir template.helloprint.local && cd template.helloprint.local
Скачать исходный код программного обеспечения из репозитория в директорию с проектом:
Блок кода language bash $ sudo git clone --branch master https://bitbucket.hello-print.ru/scm/hel/erp.git .
Запуск программного обеспечения
Для быстрого запуска программного обеспечения необходимо выполнить следующие команды:
Установить базовые настройки:
Блок кода language bash $ sudo make SET=yes init
В диалоговом режиме необходимо заполнить следующие параметры:
- Please set environment (dev/stage/template):
template - Please set COMPOSE_HTTP_TIMEOUT (default 600s):
600 - Please set nginx port (default 80):
8080
Если по определенным причинам порт 8080 будет занят, необходимо указать любой свободный, на котором можно запустить приложение.
- Please set environment (dev/stage/template):
Запустить скачивание образов инфраструктуры, базы данных и выполнить установку и запуск программного обеспечения:
Блок кода language bash $ sudo make up
Выполнить настройку интерфейсов:
Блок кода language bash $ sudo make build
Информация |
---|
После успешного выполнения приведенных выше команд система должна быть доступна по локальному адресу и порту, которые были указаны в настройках на первом шаге: |
Обновление программного обеспечения
Для обновления программного обеспечения необходимо:
Перейти в директорию с проектом
Блок кода language bash $ cd template.helloprint.local
Выполнить обновление исходного кода системы
Блок кода language bash $ sudo git pull
Выполнить обновление инфраструктуры
Блок кода language bash $ sudo make pull
Расширенные возможности
Общий список доступных команд можно получить следующим образом:
Блок кода | ||
---|---|---|
| ||
$ make help |