Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding additional info to help understand where the values for A records come from #433

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
16 changes: 15 additions & 1 deletion source/cloud-native-platform/path-to-live/shutter.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,21 @@ For shuttering purposes if you need to shutter an A record it **must** have one
- **shutter_resource_id**
- **alias_target_resource_id**

This is a requirement and failing to set one of these values on your A record before shuttering will result in the CI pipelines failing and your site may be in a limbo state until reverted or updated and re-run.
Here you can see an example of an A record that uses [both](https://github.com/hmcts/azure-public-dns/blob/master/environments/prod/apply-to-adopt-a-child-placed-in-your-care-service-gov-uk.yml#L8).

- You can see that the A record is an Alias, because it uses **alias_target_resource_id** instead of an IP **record** and it also has a **shutter_resource_id** entry that points to an Azure Static Web App which is discussed in the [implementation](#implementation) section.

Setting **shutter_resource_id** you can use the following format:

shutter_resource_id = /subscriptions/<subId>/resourceGroups/cft-platform-shutter-webapp-<env>-rg/providers/Microsoft.Web/staticSites/<service name>

Where you should replace:

- subId = subscription Id where the static WebApp is stored, this will match the environment that you are deploying the shutter for e.g. An `sbox deployed app` = `DCD-CFTAPPS-SBOX` = `b72ab7b7-723f-4b18-b6f6-03b0f2c6a1bb`
- env - the `environment` name for the resource group that contains the web app, again this will be the same as the environment for the app being shuttered
- service name - This will match the name of your application. For example based on the example linked above, the static web app name is `adoption`

**This is a requirement and failing to set one of these values on your A record before shuttering will result in the CI pipelines failing and your site may be in a limbo state until reverted or updated and re-run.**

### Shuttering CNAME record types

Expand Down
Loading