Skip to content

Commit d154ff6

Browse files
authored
docs: Add RunsOn regional availability guidance to primary region decision (#851)
1 parent 1d1dc67 commit d154ff6

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

docs/layers/network/design-decisions/decide-on-primary-aws-region.mdx

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,33 @@ certain regions receive platform infrastructure updates slower than others. Also
4949
[Local Zones](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/#AWS_Local_Zones) (e.g.
5050
`us-west-2-lax-1a`) which operate a subset of AWS services.
5151

52+
See [AWS Regional Services List](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) for
53+
a complete breakdown of service availability by region.
54+
55+
### Reference Architecture Component Availability
56+
57+
Beyond standard AWS services, certain components in the reference architecture have their own regional constraints that
58+
should factor into your primary region decision.
59+
60+
#### RunsOn (Self-Hosted GitHub Runners)
61+
62+
[RunsOn](/layers/github-actions/runs-on/) is our recommended solution for self-hosted GitHub runners. It relies on
63+
[AWS App Runner](https://aws.amazon.com/apprunner/), which is only available in a subset of AWS regions:
64+
65+
- `us-east-1`, `us-east-2`, `us-west-2`
66+
- `eu-central-1`, `eu-west-1`, `eu-west-2`, `eu-west-3`
67+
- `ap-south-1`, `ap-southeast-1`, `ap-southeast-2`, `ap-northeast-1`
68+
69+
Notably, **`us-west-1` does not support App Runner**, and therefore RunsOn cannot be deployed there directly.
70+
71+
If your primary region doesn't support App Runner but you still want to use that region, you'll need to deploy RunsOn
72+
in a supported region and connect it to your primary region. We recommend using Transit Gateway with a cross-region
73+
peering connection for this, though other connectivity options exist. This adds approximately **$80/month** in Transit
74+
Gateway cross-region data transfer costs.
75+
76+
For most deployments, we recommend choosing a primary region that supports App Runner to avoid this additional
77+
complexity and cost.
78+
5279
### Instance Types
5380

5481
Not all instance types are available in all regions

0 commit comments

Comments
 (0)