Multi-Region Serverless deployments on AWS with custom domains

Serverless Framework Logo
Serverless Framework

In this post, I will be extending the article on Serverless Framework which we use at FINN actively, and tell you how to implement a service with custom domains and multiple regions.

What is Serverless?

Serverless is a way of providing backend services only when needed for use (AWS Lambda). We will be using the Serverless Framework described as Zero-friction development tooling for auto-scaling apps on AWS Lambda.

It simply deploys your services to AWS Lambda and creates a restful API (your choice) for your service. You can attach a custom domain to any stage of your deployment.


Now let's deploy our application to both staging and production environments with their relevant custom domains. In the end, we will have four deployments on both eu-central-1 and us-east-1 regions with the routing setting based on latency:

  • Domain: Stage: staging Region: eu-central-1
  • Domain: Stage: staging Region: us-east-1
  • Domain: Stage: production Region: eu-central-1
  • Domain: Stage: production Region: us-east-1

1) Install Serverless plugins

Assuming you already installed serverless.
In order to manage custom domains, install serverless-domain-manager:

yarn add -D serverless-domain-manager

Then install stage manager (optional):

yarn add -D serverless-stage-manager

2) Setup the serverless.yml

This is just an example.

service: multi-region-service

app: myapp
org: myorg

frameworkVersion: '2'

  name: aws
  endpointType: REGIONAL
  runtime: nodejs14.x
  memorySize: 256
  stage: ${opt:stage, 'staging'}
  region: ${opt:region, 'eu-central-1'}

    staging: staging
    production: production
    domainName: ${${self:provider.stage}}
    basePath: ''
    stage: ${self:provider.stage}
    createRoute53Record: true
    endpointType: 'regional'
    certificateRegion: ${opt:region, 'eu-central-1'}
      routingPolicy: latency
    - staging
    - production

  - serverless-domain-manager
  - serverless-stage-manager
  - serverless-offline

3) Create domains with regions

Create on eu-central-1 region:

serverless create_domain --stage staging


serverless create_domain --stage staging --region eu-central-1

Create on us-east-1 region:

serverless create_domain --stage staging --region us-east-1

Create on eu-central-1 region:

serverless create_domain --stage production


serverless create_domain --stage production --region eu-central-1

Create on us-east-1 region:

serverless create_domain --stage production --region us-east-1

4) Deploy services to AWS

Deploy staging on eu-central-1 region:

serverless deploy --stage staging


serverless deploy --stage staging --region eu-central-1

Deploy staging on us-east-1 region:

serverless deploy --stage staging --region us-east-1

Deploy production on eu-central-1 region:

serverless deploy --stage production


serverless deploy --stage production --region eu-central-1

Deploy production on us-east-1 region:

serverless deploy --stage production --region us-east-1

How to convert an existing Edge service to Regional

By default, Serverless does not deploy regional endpoints. Let's assume you have a setup like this in your serverless.yml:

    domainName: ${${self:custom.stage}}
    basePath: ''
    stage: ${self:custom.stage}
    createRoute53Record: true

Before you do any multi-region changes, you should first run the following commands and remove your custom domains because, at the moment, it's not possible to alter the endpoint type.

serverless delete_domain --stage staging
serverless delete_domain --stage production

After that, you can start steps 3 and 4 above.

Unfortunately, there will be a downtime until your deployment is done.

If you want to log the region in your lambda, the environment variable AWS_REGION is available via AWS Lambda. So you can print it with console.log(process.env.AWS_REGION). You can also check your deployments on Serverless Dashboard.

I hope you enjoyed the post. Don't forget to show some love. :)

Subscribe to Saral's Developer Experience

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.