OPG Use My LPA: Managed by opg-org-infra & Terraform
Clone the following repository into the same base directory:
Additionally, work related to Use is done in:
- https://github.com/ministryofjustice/opg-data-lpa
- https://github.com/ministryofjustice/opg-data-lpa-codes
- https://github.com/ministryofjustice/opg-opg-data-lpa-instructions-preferences
All commands assume a working directory of opg-use-my-lpa.
A Makefile is maintained that aliases the most useful docker-compose commands.
To build the service and it's dependencies
make build_allTo start the service and its dependencies
make up_all # start ual and all dependencies then run seeding of local dataTo stop the service and its dependencies (ordering is important so that the networks are removed last)
make down_all # bring down everything including the lpa endpointThere are other make file targets for common operations such as
logs to follow docker-compose logs for the service
seed to rerun seeding scripts to put or reset fixture data
destroy to stop the service and remove all images
Build images with no cache option. Run this regularly to keep base docker images up to date, as these include potential security fixes.
make rebuild [container name]Note: this can take several minutes to run.
To bring up the local environment
make up_allIf you plan on developing the application i:e in most cases, you should also enable development mode.
make development_modeDevelopment mode is essential to run the stack locally (unless SSL is setup) as without it sessions do not function. You will be unable to login and all CSRF protected forms will be broken.
The Viewer service will be available via http://localhost:9001/home
The Actor service will be available via http://localhost:9002/home
The API service will be available via http://localhost:9003
To run all the unit tests (the command for viewer-app and actor-app will run exactly the same suite of unit tests in the front service)
make unit_test_all
# or, seperately
make unit_test_viewer_app
make unit_test_actor_app
make unit_test_javascriptTo run the Behat smoke tests
make smoke_testsThere other some other utility scripts in the composer.json for example
cd service-api/app
composer run psalm
# to pass arguments to a composer script start with a double hyphen "--".
composer run int-test -- --verboseComposer install is run when the app container is built, and on a standard docker-compose up.
It can also be run independently with:
# Arbitrary commands such as "require author/package" or "remove author/package"
make run_api_composer -- [composer command]
make run_front_composer -- [composer command]
# explicit install or update
make run_api_composer_install
make run_api_composer_update
make run_front_composer_install
make run_front_composer_updateThere are occasions when your local dev environment doesn't quite act as it should. Feel free to add further troubleshooting steps here.
Here are some common problems we've come across:
Its possible seeding of Use an LPA was not successful. make sure all docker compose services are running and have settled first, then try again. run the following command:
make seedthen try again
Ensure that the api-gateway container is running
docker ps | grep opg-use-an-lpa-codes-gatewayIf this is not running, you should re-run
make up_allif that doesn't work try running
make update_mock
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![renovate[bot] avatar](https://avatars.githubusercontent.com/in/2740?v=4 "renovate[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent