"QAE" is the application which powers the application process for The King's Awards for Enterprise.
- Ruby 3.2.4
gem install bundler -v 2.5.6
- Node.js LTS
- Rails 7.0
- Postgresql 9.5+ with
hstoreextension - Redis 4+
- Docker
There are environment variables that you may want to modify in the .env file.
cp .env.example .env
This ensures the necessary environment variables set before running the Docker commands.
-
Build the containers:
docker-compose build -
In a new terminal, set up and migrate the database:
docker-compose run --rm web bundle exec rails db:prepare -
Run the containers:
docker-compose up
Your application should now be running at http://localhost:3000
Locally the docker image will run Rails in development, if you need to run as production
then specify the production file docker-compose -f docker-compose.prod.yml
You will need to generate a local ssl certificate for nginx. openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ./certs/privkey.pem -out ./certs/fullchain.pem
Your application should now be running at https://localhost/
If you need to test collaborators editing the application at the same time, install poxa.
Files are uploaded to S3 and then scanned with ClamAV via the Vigilion service.
If you need to test malware scanning locally, install Vigilion and set the VIGILION_ACCESS_KEY_ID and VIGILION_SECRET_ACCESS_KEY and DISABLE_VIRUS_SCANNER to false in the .env file.
$ bundle exec rspec
We have documentation within the doc folder. Architecture decisions and technical diagrams are stored within doc/architecture/decisions and doc/architecture/diagrams respectively.
We use adr-tools to manage our architecture decisions.
Diagrams are written using PlantUML and C4 notation.
If you're using an IDE or editor with a PlantUML plugin, there's often a setting to specify the format (png) and output directory. For example, in VS Code with the PlantUML extension, you can add this to your settings.json:
"plantuml.outputDirectory": "."Continuous Deployment is setup and the application will automatically deploy after passing CI on the target branch (main, staging). Production deployment is a manually triggered action (production branch). For more details see the Github Actions.
CF based GOV.UK PaaS is used for hosting https://cloud.service.gov.uk.
QAE is Copyright © 2014 Crown Copyright & Bit Zesty. It is free software, and may be redistributed under the terms specified in the LICENSE file.
QAE is maintained by Bit Zesty Limited.