Region enablement - Modular Cloud Studio on AWS
Enable a RegionDisable a Region

Region enablement

This section is optional and only required if you want to set up a multi-Region deployment. The solution initially deploys in a single hub Region. All additional AWS Regions enabled through this workflow become spoke Regions that can connect back to the hub Region for centralized management.

Enable a Region

  1. Navigate to the MCS web console (see Launch the stack for details).

  2. Select AWS Regions from the left navigation pane.

  3. Choose Add Region in the top right corner.

  4. Choose the spoke Region that you want to enable from the dropdown menu.

  5. Choose Enable.

  6. The Region appears in AWS Regions Enabled with an ENABLING IN PROGRESS status.

Enabling the spoke Region takes approximately 5 minutes. After the process completes, the Region status changes to ENABLED.

Note

Spoke Regions inherit the same tags as the main Solution stack.

After enabling a spoke Region, you can deploy modules to it by following the detailed steps in Module enablement and choosing the spoke Region during module deployment.

The Enable Region API does the following:

  1. Checks if the Region exists in the Regions DynamoDB table.

  2. Updates Region status to ENABLING IN PROGRESS in the Regions DynamoDB table.

  3. Provisions the spoke Region infrastructure Service Catalog product.

  4. If the previous step is successful, updates the Region provisioned_product_id attribute and status to ENABLED in the Regions DynamoDB table. Otherwise, sets the status to ENABLE FAILED.

Disable a Region

Prerequisites

Before disabling a spoke Region, you must first disable all modules deployed in that Region. The system will prevent Region disabling if any modules are still enabled.

To disable modules, see Disable a module for detailed instructions on how to disable each module in the Region.

Steps to disable a Region

  1. Navigate to the MCS web console (see Launch the stack for details).

  2. Select AWS Regions from the left navigation pane.

  3. Choose an enabled spoke Region to disable, and choose Disable Region.

  4. Choose Confirm.

  5. The Region appears in AWS Regions Enabled with a DISABLING IN PROGRESS status.

Disabling the spoke Region takes approximately 5 minutes. After the process completes, the Region becomes available for re-enablement if needed.

The Disable Region API does the following:

  1. Checks if the Region exists in the Regions DynamoDB table.

  2. Checks if there are modules enabled in the Region in the Enabled Modules DynamoDB table. If so, an error is thrown.

  3. Updates Region status to DISABLING IN PROGRESS in the Regions DynamoDB table.

  4. Terminates the provisioned Service Catalog product.

  5. If the previous step is successful, updates the Region provisioned_product_id attribute to be empty and status to DISABLED in the Regions DynamoDB table. Otherwise, sets the status to DISABLE FAILED.