How to add a custom domain for a serverless-1.0.0 framework defined/deployed API?

Serverless-1.0.0-rc.1 enables to deploy an API to be accessible via a AWS API Gateway.

The question: I need the deployed API exposed via a custom domain with SSL certificate instead of the randomly assigned one (URL https://qwertylgbtqert.execute-api....)?

Can that be done from within serverless.yml or serverless framework?

Here is my simple service serverless.yml definition:

service: my-service
  name: aws
  runtime: nodejs4.3

    handler: handler.generate
      - http:
         method: get
         path: url
         cors: true

There is an question which relates to this: the answer here, but does not provide an applicable answers. Especially how to assign the custom domain from within the serverless.yml itself.

It thought if it is possible to create a AWS::Route53 resource and leverage that, however I don't know how to do that in serverless.

Answers 1

  • You need to create the custom domain first and upload the certificates. This should not be part of this code or your deployment of this piece of software.

    After you have a custom domain you need to think in terms of CloudFormation.

    Like with everything else in Serverless Framework; you can leverage CloudFormation templates to administer resources in AWS.

    So your question becomes how can you add your API Gateway to your Custom Domain in CloudFormation (hint: there is much more help on Google if you search for CloudFormation instead of Serverless Framework)? By creating a AWS::ApiGateway::BasePathMappingin CloudFormation is the answer.

    This is done in the Resources in your serverless.yml file. Like this for example:

                Type: AWS::ApiGateway::BasePathMapping
                    BasePath: oauth2
                    DomainName: ${self:vars.domainName}
                        Ref: ApiGatewayRestApi
                    Stage: ${self:vars.stage}

    This requires you to have variables for the domainName and stageName in the serverless.env.yml file for the stages you use.

    Edit: For versions of Serverless Framework 1 before rc1 you have to add DependsOn: IamPolicyLambda to the pathmapping resource. This was fixed in:

    Before rc1 you should use RestApiApigEvent instead of ApiGatewayRestApi

Related Articles