Skip to main content

Creating private Route53 DNS zones

Private DNS zones are created in the Modernisation Platform core-network-services account through Terraform. We provide modernisation-platform.service.justice.gov.uk and modernisation-platform.internal to customers on a per-business unit basis.

This new service allows for the creation of custom private DNS zones. This has to be done in two pull requests the first one to create the zone and a second associate the zone with additional VPCs.

Creating new private zones

New DNS zones are added in code here.

Using the example code below will create the new private DNS record.

In the pull request add a name and supply the DNS name for the private zone you want to create.

Example

  private-application-zones  = {
    example = "example.gov.uk"
    test    = "development.internal"
  }
}

Extending the newly created private DNS zone

To extend DNS zones amend the options for the relevant $business_unit-$environment.json here.

The new zone must be created first before adding it to the VPC options.

The below example shows the configuration needed for the association of two private zones with a VPC.

Example

 {
  "cidr": {
    ...
  },
  "options": {
    ...
    "additional_private_zones": ["example.gov.uk", "development.internal"],
    ...
  }
}
This page was last reviewed on 1 August 2024. It needs to be reviewed again on 1 February 2025 by the page owner #modernisation-platform .
This page was set to be reviewed before 1 February 2025 by the page owner #modernisation-platform. This might mean the content is out of date.