Установка всех проектов - LamronNu/i GitHub Wiki

Установить все, но ручками:

Установить все сразу, автоматически, через виртуальную среду Vagrant:

Зачем?

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

Как?

Для Windows это очень просто: https://youtu.be/9RkfcR_mrj0 - Первая часть https://youtu.be/OJWUnXOqgUY - Вторая часть (развертывания локального окружения)

Или:

  • Установить Vagrant: http://docs.vagrantup.com/v2/installation/index.html Внимание пользователям Ubuntu - предпочтительнее скачать пакет именно с сайта, т.к. бывали случаи, когда в Ubuntu'овском репозитории была устаревшая версия, не могущая скачать образ с текущей версии Vagrant Cloud.
  • Установить VirtualBox: https://www.virtualbox.org/wiki/Downloads
  • Если еще не сделали этого - (установить git), (только для windows выполнить git config --global core.autocrlf input - эсли исходники уже выкачаны придется очистить директорию и выкачать снова) выкачать с гитхаба исходники проекта https://github.com/e-government-ua/i и перейти в ветку test
  • находясь в корневой папке проекта в терминале выполнить vagrant up (!! если у вас windows 7, 8.* терминал обязательно должен быть запущен от имени администратора)
  • пойти попить кофе. Vagrant-у нужно много чего скачать и запустить. Ориентировочная продолжительность - 10 - 15 минут первый раз, 7..8 минут последующие (когда базовый образ Ubuntu уже скачан). Зависит от скорости интернета.
  • Теперь у вас в VirtualBox запущена виртуалка, в которой поднят проект. Вы можете делать следующие прикольные вещи:

добавте себе с c:\Windows\System32\drivers\etc\hosts строчки 192.168.10.10 e-gov-ua.dev 192.168.10.10 admin.e-gov-ua.dev чтобы заработали виртуальные хосты

Что если...

В любой непонятной ситуации ... $ vagrant destroy $ vagrant up Таким образом можно начать с чистого листа

... не устанавливается Virtual Box (Win) и в процессе установки выдает ошибку "Another installation is in progress..." Решение: http://www.kombitz.com/2013/07/26/how-to-fix-another-installation-is-in-progress-error-on-windows/

...сделал, а wf-region все равно не работает Бывает. Проект быстро меняется, и вы можете попасть на неудачный момент, когда что-то сломана. Нужно посмотреть логи Томкета и понять, что же именно произошло:

$ vagrant ssh
Welcome to Ubuntu 14.04.2 LTS (GNU/Linux 3.13.0-49-generic i686)
...
vagrant@vagrant-ubuntu-trusty-32:~$ cd /opt/apache-tomcat-8.0.21/logs
vagrant@vagrant-ubuntu-trusty-32:/opt/apache-tomcat-8.0.21/logs$ less catalina.out

...сделал, а central-js (центральный портал), dashboard-js (админка) все равно не работает.

$ vagrant ssh
screen -r central-js или screen -r dashboard-js  откроется вывод grunt с вероятной ошибкой (detach screen ctrl+a+d) или 
cd /project/central-js
grunt --debug

для dashboard-js
cd /project/dashboard-js
grunt serve --debug

...я вытянул свежий код и хочу чтоб он подхватился

$ vagrant up  
если выключено было через vagrant halt !!! запустит скрипты обновления (wf-region, central-js, dashboard-js не очень быстро но все обновится)

...хочу ускорить предыдущий пункт? (обновит только wf-region) Как правило, можно сделать инкрементальную сборку бекенда (mvn install) вместо полной пересборки (mvn clean install):

$ vagrant ssh
Welcome to Ubuntu 14.04.2 LTS (GNU/Linux 3.13.0-49-generic i686)
...
vagrant@vagrant-ubuntu-trusty-32:~$ /project/scripts/update_wf_fast.sh

...хочу временно погасить виртуалку, но не хочу потом создавать ее с нуля

$ vagrant suspend  
если работаете с central-js, dashboard-js лутше выключайте через vagrant halt (есть баг выхода с режима паузы при котором некоторые апи реквесты на сервер перестают работать )

Когда виртуалка снова понадобится:

$ vagrant up

Полная инициализация выполнятся не будет, поэтому виртуалка поднимется за 15-20 секунд. (если выключали halt будет дольше)

Детали имплементации:

  • Папка проекта расшарена между виртуалкой и основной машиной. В виртуалке она доступна в /project.
  • В проекте https://github.com/e-government-ua/vagrant содержится альтернативная конфигурация системы. Более сложная, зато более универсальная.