Установка Vagrant

В Ubuntu это должно быть так же просто, как:

sudo apt-get install vagrant

Другие дистрибутивы Linux должны иметь аналогичные инструкции по установке с использованием dnf, pacman или аналогичных.

Установщики доступны для Mac OS X и Windows, дополнительную информацию см. на странице загрузки проекта Vagrant.

Обратите внимание, что пока не появятся подходящие xenial64 коробки Vagrant для других провайдеров, единственным поддерживаемым провайдером виртуализации является virtualbox. Возможно, вам потребуется установить его и указать --provider virtualbox при настройке среды.

Настройка openstreetmap-website

После установки Vagrant вы можете запустить среду, проверив код openstreetmap-website, если вы ещё этого не сделали, а затем перейти в каталог, содержащий Vagrantfile, набрав:

git clone git@github.com:openstreetmap/openstreetmap-website.git
cd openstreetmap-website
vagrant up

Это займёт несколько минут, чтобы загрузить необходимое программное обеспечение из интернета и настроить его как работающую систему. Как только это будет сделано, вы сможете войти в работающую виртуальную машину, набрав:

vagrant ssh

Внутри этой оболочки входа вы можете заниматься разработкой, запускать сервер или тесты. Например, чтобы запустить тесты:

cd /srv/openstreetmap-website/
rake test

Чтобы получить доступ к веб-страницам, выполните следующие команды, а затем откройте сайт в своём локальном браузере:

vagrant ssh
cd /srv/openstreetmap-website/
rails server --binding=0.0.0.0

Вы редактируете код на своём компьютере с помощью используемого вами редактора кода, затем через общие папки код мгновенно обновляется на виртуальной машине.

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