A demo application showcasing API Gateway (v2) endpoints with custom domain names configured through Route53 and ACM, deployed locally using LocalStack and the Serverless framework. For more details, refer to the documentation.

Under the hood, the Serverless framework uses the serverless-localstack plugin to deploy the application to LocalStack. The plugin is configured in the serverless.yml file to use the LocalStack endpoint and the custom domain name.

• A valid LocalStack for AWS license. Your license provides a LOCALSTACK_AUTH_TOKEN to activate LocalStack.
• Docker
• localstack CLI
• awslocal CLI
• Node.js 18.x with npm
• Serverless Framework 3.x
• openssl

make check

make install

export LOCALSTACK_AUTH_TOKEN=<your-auth-token>
make start

make deploy

The script:

• Generates an SSL certificate for local testing using openssl.
• Uses a predefined certificate if openssl is unavailable.
• Adds the certificate to Amazon Certificate Manager (ACM).
• Creates a Route53 hosted zone for test.example.com.
• Displays deployment logs of the Serverless application in the output section.
• Showcases API Gateway endpoints and custom domain configuration.

make run

This code is available under the Apache 2.0 license.