Skip to content

Tools and Accounts

Before deploying any pattern from the upstream demo repository, confirm your workstation and AWS accounts are ready.

ToolMinimum versionPurpose
AWS CLI v2v2.xProfile-based authentication and resource inspection
Terraform>= 1.5Apply and destroy pattern infrastructure
Session Manager pluginLatestInteractive shell on private test EC2 instances via SSM

Configure two named profiles for SSO access to the demo accounts:

ProfileAccount rolePlaceholder account ID
shared-servicesProvider account (VPC endpoint service, TGW owner, Cloud WAN core network)123456789012
devConsumer account (endpoints, attachments, test EC2)987654321098

Example ~/.aws/config fragment (replace SSO URLs and role names with your organization’s values):

[profile shared-services]
sso_start_url = https://EXAMPLE.awsapps.com/start
sso_region = ap-southeast-2
sso_account_id = 123456789012
sso_role_name = EXAMPLE-AdminRole
region = ap-southeast-2
[profile dev]
sso_start_url = https://EXAMPLE.awsapps.com/start
sso_region = ap-southeast-2
sso_account_id = 987654321098
sso_role_name = EXAMPLE-AdminRole
region = ap-southeast-2

Set the default region for pattern work:

Terminal window
export AWS_REGION=ap-southeast-2
export DEV_ACCOUNT_ID=987654321098

The upstream repo provides docs/local.env.example. Copy it to docs/local.env (gitignored) and record Terraform outputs as you progress through each pattern.

Continue to Pre-flight before any terraform apply.