Tools and Accounts
Before deploying any pattern from the upstream demo repository, confirm your workstation and AWS accounts are ready.
Required Tools
Section titled “Required Tools”| Tool | Minimum version | Purpose |
|---|---|---|
| AWS CLI v2 | v2.x | Profile-based authentication and resource inspection |
| Terraform | >= 1.5 | Apply and destroy pattern infrastructure |
| Session Manager plugin | Latest | Interactive shell on private test EC2 instances via SSM |
Required AWS CLI Profiles
Section titled “Required AWS CLI Profiles”Configure two named profiles for SSO access to the demo accounts:
| Profile | Account role | Placeholder account ID |
|---|---|---|
shared-services | Provider account (VPC endpoint service, TGW owner, Cloud WAN core network) | 123456789012 |
dev | Consumer 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/startsso_region = ap-southeast-2sso_account_id = 123456789012sso_role_name = EXAMPLE-AdminRoleregion = ap-southeast-2
[profile dev]sso_start_url = https://EXAMPLE.awsapps.com/startsso_region = ap-southeast-2sso_account_id = 987654321098sso_role_name = EXAMPLE-AdminRoleregion = ap-southeast-2Set the default region for pattern work:
export AWS_REGION=ap-southeast-2export DEV_ACCOUNT_ID=987654321098Optional Environment File
Section titled “Optional Environment File”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.
Next Steps
Section titled “Next Steps”Continue to Pre-flight before any terraform apply.