Skip to content

Latest commit

 

History

History
93 lines (56 loc) · 2.46 KB

developing-using-vm.md

File metadata and controls

93 lines (56 loc) · 2.46 KB
Raw

Developing using the VM

Installing

NB: this assumes you are running on the GOV.UK virtual machine, not your host.

./install # git fetch from each dependency dir and bundle install

Installing dependencies

Clone the following repositories:

If you want to run the Whitehall app locally (to provide the server side of the Worldwide API), then you also need to clone its repository:

Then run bundle install for each application.

If you're running the Whitehall app locally, you'll need to setup its database and import some suitable data. There's a data replication job that imports production data which includes Whitehall data.

Running the application

Without local Whitehall app

Add PLEK_SERVICE_WHITEHALL_ADMIN_URI=https://www.gov.uk to a .env file in /var/govuk/development to point the Smart Answers app at the production instance of the Whitehall app.

Run using bowler on VM from /var/govuk/development:

bowl smartanswers

With local Whitehall app

Run using bowler on VM from ``/var/govuk/development`:

bowl smartanswers whitehall

Viewing a Smart Answer

To view a smart answer locally if running using bowler http://smartanswers.dev.gov.uk/register-a-birth

Troubleshooting

Ruby version error

Check the available versions of ruby by running:

rbenv versions

If the required version of ruby is not available in the list, your virtual machine may be out of date.

To update the GOV.UK virtual machine first pull the latest version of the govuk-puppet repository, then run:

vagrant provision

DNS cannot resolve host smartanswers.dev.gov.uk

The vagrant-dns plugin may be missing, or may not have installed correctly.

On your base machine, go to the govuk-puppet repository and check the available vagrant plugins:

vagrant plugin list

If the vagrant-dns plugin exists, first uninstall it:

vagrant plugin uninstall vagrant-dns

Then install it again:

vagrant plugin install vagrant-dns

N.B. If the plugin was missing, you just need to follow the install step.

Finally, restart vagrant by running vagrant halt followed by vagrant up.