Add new region key to allow deploying to alternate regions explicitly

Author: amazon-meaisiah

BUILDING.md

@@ -57,6 +57,12 @@ This S3 bucket is used to hold all the build artifacts. Unlike everything else h
 
 This is the name of the CloudFormation stack to create and deploy. As a CloudFormation stack name, it must be unique to your account.
 
+### `region: string` (Required)
+
+This is the name of the region to deploy the CloudFormation stack to.
+
+Note: the edge lambda will always be created in us-east-1 regardless of the value of this.
+
 ### `siteAssetsBucket: string` (Required)
 
 This S3 bucket holds the site's static assets to serve from the generated CloudFront distribution. As an S3 bucket, the name must be globally unique.

dev-portal/example-deployer.config.js

@@ -16,6 +16,9 @@
 'use strict'
 
 module.exports = {
+  // Optional
+  // region: 'us-west-1',
+
   // Optional, but recommended if you have multiple active AWS CLI profiles.
   // awsSamCliProfile: 'your-profile',
 

dev-portal/example-dev-deployer.config.js

@@ -9,6 +9,9 @@
 const n = 0
 
 module.exports = {
+  // Optional
+  // region: 'us-west-1',
+
   buildAssetsBucket: 'YOUR_LAMBDA_ARTIFACTS_BUCKET_NAME',
 
   // All of these are parametric over `n` so that if you need to have multiple stacks deployed

scripts/internal/deploy-template.js

@@ -10,6 +10,7 @@ module.exports = async () => {
 
   const {
     stackName,
+    region,
     buildAssetsBucket,
     siteAssetsBucket,
     apiAssetsBucket,
@@ -36,13 +37,15 @@ module.exports = async () => {
 
   await exec('sam', [
     'package',
+    '--region', region,
     '--template-file', samTemplate,
     '--output-template-file', packageConfig,
     '--s3-bucket', buildAssetsBucket,
     ...(awsSamCliProfile ? ['--profile', awsSamCliProfile] : [])
   ])
   await exec('sam', [
     'deploy',
+    '--region', region,
     '--template-file', packageConfig,
     '--stack-name', stackName,
     '--capabilities', 'CAPABILITY_NAMED_IAM',

scripts/internal/get-deployer-config.js

@@ -42,6 +42,7 @@ exports.cognitoDomainName = getRequired('cognitoDomainName')
 // required (and defaulted) inputs
 exports.samTemplate = getOptionalPath('samTemplate', 'cloudformation/template.yaml')
 exports.packageConfig = getOptionalPath('packageConfig', 'cloudformation/packaged.yaml')
+exports.region = getOptional('region', 'us-east-1')
 exports.customersTableName = getOptional('customersTableName')
 exports.preLoginAccountsTableName = getOptional('preLoginAccountsTableName')
 exports.feedbackTableName = getOptional('feedbackTableName')