Skip to main content

Adding a New Business Unit

1. Request Accounts Created in Modernisation Platform

The accounts should be member accounts and should include both non-live and live environments.

For example:

container-platform-bu-nonlive

and

container-platform-bu-live

Modernisation Platform new account guide

2. Add to the CP accounts.json

Add the account to the terraform/environments/cloud-platform/accounts.json file in the Modernisation Platform Environments repo.

3. Create the Terraform Workspace

The Terraform workspace will automatically be created in the container-platform-bu application folder. However, we run Terraform from the cloud-platform application folder, so we need to create the workspace there.

This should be done using the generate-account-workspaces.sh script. This ensures workspaces are created for all of the accounts in the accounts.json file.

4. Add Root Subdomain

In the cloud-platform root folder, add the subdomain for the business unit to the environment configuration.

5. Add BU to Skip Plan Evaluator

Add the new accounts to the skip plan evaluator file in the MPE config folder.

6. Add the VPC CIDR

Add the allocated VPC CIDR to the vpc_cidr block in network locals.

7. RAM Share MP TGW to New Accounts

See code example here.

8. Add New Accounts to TGW Routes

See code example here.

9. Apply Workflows to Build Out Clusters

Apply the cloud-platform and container-platform workflows.

10. Add Route 53 Records for the New BU Subdomain

See code example here.

11. Add the New BU to External DNS

See code example here.

This page was last reviewed on 18 June 2026. It needs to be reviewed again on 18 December 2026 by the page owner #cloud-platform-notify .