This is an experimental repository, a number of scripts will help you to build and deploy a serverless application to AWS or to localstack.

This serverless application contains:

• An API endpoint
• A lambda that responds to the API endpoint
• An SQS queue
• An SNS topic
• A lambda that reads from the SQS queue and posts to an SNS topic

A number of scripts provided in this repository illustrate how to perform common serverless build and deploy actions.

This actually contains 2 lambda functions:

• ApiGatewayrespondingApp - responds to GET method at an http endpoint.
• QueueIOApp - copies SQS queue messages into an SNS topic.

Assumed, you already have Docker installed.

• install-prerequisites-aws-sam-cli.sh
• install-prerequisites-localstack-cli.sh

The AWS Toolkit provides an easy way to select a current AWS profile in the bottom right corner of IntelliJ. It has a handy menu option called Edit Credential Files.

If you haven't already, create an IAM User with an access key. This will be used in a named profile that the AWS CLI and IntelliJ AWS Toolkit plugin can use to deploy your application for you.

Put it in a group with the following policies:

• AdministratorAccess - allows it to create and deploy resources.
• AmazonS3FullAccess - allows it to create, read and write to S3 buckets.

Now put this user's credentials into a named profile on your system:

• Documentation: Connect to an AWS account
• Edit the credentials and config files, and add a named profile.
• This profile should provide the aws_access_key_id and aws_secret_access_key for an IAM user in your account (not the root user).

NB. these files can also be found in: ~/.aws

Validate the SAM template.yaml against a named AWS profile with:

• validate-remote.sh

Either build the project within IntelliJ, or:

cd HelloWorldFunction
gradle build

or

sam build

cd HelloWorldFunction
gradle test

Build, and test by providing a custom event, with sam local invoke:

sam build
sam local invoke HelloWorldFunction --event events/event.json

To emulate the API, use sam local start-api. It'll run on port 3000:

sam local start-api
curl http://localhost:3000/

Either, use the AWS Toolkit which provides a Deploy Serverless Application option:

Alternatively:

• deploy-remote.sh

This will offer a guided deployment, and save configuration to: samconfig.toml

After deployment, you'll be given a list of resources in the new stack.

You can also explore the AWS account using the web interface, or AWS Explorer in IntelliJ (provided by the AWS Toolkit).

• start-localstack.sh
• deploy-localstack.sh

Tail remote logs with sam logs:

sam logs -n QueueIOFunction --stack-name aws-sam-lambda --tail

This uses the logical name of the function (as found in template.yaml) to look up and tail the appropriate logs from CloudWatch.

You could also do it through the AWS web interface.

To delete the sample application that you created, use the AWS CLI. Assuming you used your project name for the stack name, you can run the following:

aws cloudformation delete-stack --stack-name aws-sam-lambda