Skip to content

companieshouse/limited-partnerships-api

Repository files navigation

limited-partnerships-api

Overview

API service for limited partnerships

Requirements

In order to run the service locally you will need the following:

Getting started

To check out and build the service:

  1. Clone Docker CHS Development and follow the steps in the README.
  2. Run chs-dev modules enable limited-partnerships
  3. Run chs-dev development enable limited-partnerships-api (this will allow you to make changes).
  4. Run docker using "chs-dev up" in the docker-chs-development directory.
  5. If you are using the api directly, then use this url: http://api.chs.local/limited-partnership

Endpoints

The full path for each public endpoint begins with the url: ${API_URL}/limited-partnership

Localhost API_URL = http://localhost:8080
Docker API_URL = http://api.chs.local

Method Path Description
GET /healthcheck The health check endpoint for this service

Terraform ECS

What does this code do?

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-apichgovuk
{env}-chs-apichgovuk-private
The load balancer that sits in front of the service
Concourse pipeline Pipeline link
Pipeline code
Concourse pipeline link in shared services

Contributing

Testing

  • 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.

Vault Configuration Updates

  • 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.

Useful Links