Данный документ содержит информацию о том, как скачать и обновить исходный код программного обеспечения, произвести базовые настройки и запустить программное обеспечение на локальной среде.

Содержание:



Системные требования

Для развёртывания локального окружения убедитесь, что у вас локально:  

  • 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 свободного дискового пространства  

Реквизиты с доступами

Получить у администратора:

  1. Доступ к репозиторию с исходными кодами:
    https://bitbucket.hello-print.ru
  2. Доступ в личный кабинет программного обеспечения после его установки:
    https://template.helloprint.local

Исходный код программного обеспечения

Для скачивания исходного кода программного обеспечения необходимо:

  1. Создать на локальной среде директорию с проектом:

    $ sudo mkdir template.helloprint.local && cd template.helloprint.local


  2. Скачать исходный код программного обеспечения из репозитория в директорию с проектом:

    $ sudo git clone --branch master ssh://git@bitbucket.hello-print.ru:7999/hel/erp.git .


Запуск программного обеспечения

Для быстрого запуска программного обеспечения необходимо выполнить следующие команды:

  1. Установить базовые настройки:

    $ sudo make SET=yes init

    В диалоговом режиме необходимо заполнить следующие параметры:

    1. Please set environment (dev/stage/template):
      template
    2. Please set COMPOSE_HTTP_TIMEOUT (default 600s):
      600
    3. Please set nginx port (default 80):
      8080

      Если по определенным причинам порт 8080 будет занят, необходимо указать любой свободный, на котором можно запустить приложение.

  2. Запустить скачивание образов инфраструктуры, базы данных и выполнить установку и запуск программного обеспечения:

    $ sudo make up


  3. Выполнить настройку интерфейсов:

    $ sudo make build


После успешного выполнения приведенных выше команд система должна быть доступна по локальному адресу и порту, которые были указаны в настройках на первом шаге:

Обновление программного обеспечения

Для обновления программного обеспечения необходимо:

  1. Перейти в директорию с проектом

    $ cd template.helloprint.local


  2. Выполнить обновление исходного кода системы

    $ sudo git pull


  3. Выполнить обновление инфраструктуры

    $ sudo make pull


Расширенные возможности

Общий список доступных команд можно получить следующим образом:

$ make help