Skip to main content

ADR-002 Application Domain Names

Date: 02-06-2021

Status

✅ Accepted

Context

Establish a pattern for naming domains, currently we have a few variations across products and we should aim to be consistent where possible.

Decision

Reflect the MoJ security guidance and MoJ naming standards where possible.

Multiple Hosted Zones

Having multiple hosted zones is necessary if you have multiple stacks in an environment due a limitaion with Amazon Certificate Manager. See Wildcard Names

You should have a delegated hosted zone for each AWS Account, which becomes the domain for the primary environment in that account. Production will not have a account prefix and live at the root level of the services domain

Production example:

[service_name].opg.service.justice.gov.uk

Non-Production example:

preproduction.[service_name].opg.service.justice.gov.uk development.[service_name].opg.service.justice.gov.uk

Ephemeral Environments

ephemeral environments will live within the hosted zone of the account where the environment is created.

[environment_name].development.[service_name].opg.service.justice.gov.uk

No Abbreviations

Dont use abbreviations in domains names where possible, A products preproduction environment should be:

preproduction.[service_name].opg.service.justice.gov.uk not ‘pre.[service_name].opg.service.justice.gov.uk’

Consequences

Some products might have to do some slight refactoring work, however this shouldnt effect any production domains.

This page was last reviewed on 14 March 2024. It needs to be reviewed again on 14 March 2025 by the page owner #opg-webops-community .
This page was set to be reviewed before 14 March 2025 by the page owner #opg-webops-community. This might mean the content is out of date.