The Companies House web application for handling company accounts These screens allow clients to interact with company accounts data.
- Java 21
- Maven
- Git
- Accounts platform
- Start Docker
- On the command line, export the intended AWS profile using command: 'export AWS_PROFILE={development-eu-west-2}'
- Login to AWS using Single-sign-on: 'AWS SSO LOGIN'
- Then run 'aws ecr get-login-password --region eu-west-1 | docker login --username AWS --password-stdin 169942020521.dkr.ecr.eu-west-1.amazonaws.com'
- To enable the accounts module when you are tilting up, run the command: './bin/chs-dev modules enable accounts'
- To enable development workflow and make changes to company-accounts-web, run the command: './bin/chs-dev development enable company-accounts-web-ch-gov-uk'
- To start up the services enabled through the accounts module activation, run the command: 'tilt up' and stop them using 'tilt down'
- When services are up and running, open http://chs.local in the browser and log in to CHS platform using username demo@ch.gov.uk and password.
Go to Concourse (https://ci.platform.aws.chdev.org/teams/team-aardvark/pipelines/company-accounts.web.ch.gov.uk), select CIDEV to take you to the builds, and when you are ready to deploy - click the (+) button on the green banner in the top right of the page.
If you cannot access the builds, you may require access rights to be granted. Raise a ticket for these and follow the steps below for manual deployment.
- login to AWS
- Go to the development release bucket in the S3 folder - development-eu-west-2.release.ch.gov.uk
- Within this bucket, navigate to the company-accounts.web.ch.gov.uk/ folder
- Use the ‘Last modified’ tab to sort the zip files by date and select the most recent (verifying that the release number is the same as the artefact on github)
- Select this file, click ‘actions’ and ‘copy’ - then copy this to the release folder titled - release.ch.gov.uk
- The go to the CIDEV deployer, select ‘deploy an app’ at the top, select company-accounts-web and put in the release number
- You can use Marathon to verify that the service is running and suspend or destroy any old version of the service which are still running
Use command ‘make test’ to run test suite locally
The code present in this repository is used to define and deploy a dockerised container in AWS ECS. This is done by calling a module from terraform-modules. Application specific attributes are injected and the service is then deployed using Terraform via the CICD platform 'Concourse'.
| Application specific attributes | Value | Description |
|---|---|---|
| ECS Cluster | filing-maintain | ECS cluster (stack) the service belongs to |
| Load balancer | {env}-chs-chgovuk | The load balancer that sits in front of the service |
| Concourse pipeline | Pipeline link Pipeline code |
Concourse pipeline link in shared services |
- Please refer to the ECS Development and Infrastructure Documentation for detailed information on the infrastructure being deployed.
- Ensure the terraform runner local plan executes without issues. For information on terraform runners please see the Terraform Runner Quickstart guide.
- If you encounter any issues or have questions, reach out to the team on the #platform slack channel.
- Any secrets required for this service will be stored in Vault. For any updates to the Vault configuration, please consult with the #platform team and submit a workflow request.