DEV Community

Cover image for Using .NET Core in AWS Lambda with SAM and building an Auto-Scaling Manager
Antonio Falcão Jr.
Antonio Falcão Jr.

Posted on • Updated on

Using .NET Core in AWS Lambda with SAM and building an Auto-Scaling Manager

This project demonstrates the integration with AWS Auto-Scaling service and .NET Core, using SAM for building and test.

You can find the full source project here.

GitHub logo AntonioFalcaoJr / Dotnet.AWSLambda.AutoScaling

This project demonstrates the integration with AWS Auto Scaling service and .NET Core, using SAM for building and test.

This sample contains source code and supporting files for a serverless application that you can deploy with the SAM CLI.

  • ./src - Multilayer .NET Core project for the application's Lambda function.
  • ./.events - Invocation events that you can use to invoke the function.
  • ./test - Unit tests for the application code with XUnit.
  • template.yaml - A template that defines the application's AWS resources.

How its works

Using a JSON as input is possible to suspend or resume processes from a specific auto-scaling by tag name.

Use case: SUSPEND the Terminate and Launch processes as the initial stage from Blue-Green Deploy on Code Pipeline and then, RESUME in the final stage.

JSON sample for use at AWS or in this project.

{
    "Scalings": [
        {
            "Tag": "tag-name-here",
            "Suspend": false
        }
    ]
}
Enter fullscreen mode Exit fullscreen mode

Many scalings:

{
    "Scalings": [
        {
            "Tag": "tag-name-here",
            "Suspend": false
        },
        {
            "Tag": "tag-name-here",
            "Suspend": true
        }
    ]
}
Enter fullscreen mode Exit fullscreen mode

About Processes is possible to specify, but if not it will use the default list.

{
    "Scalings": [
        {
            "Tag": "tag-name-here",
            "Suspend": false,
            "Processes": [
                "Terminate",
                "Launch"
            ]
        }
    ]
}
Enter fullscreen mode Exit fullscreen mode

Default values are defined on file ProcessService.cs:

public class ProcessService : IProcessService
{
    private static ProcessType LaunchProcessType => new ProcessType {ProcessName = "Launch"};
    private static ProcessType ScheduledActionsProcessType => new ProcessType {ProcessName = "ScheduledActions"};
    private static ProcessType TerminateProcessType => new ProcessType {ProcessName = "Terminate"};

// comment for brevity
}
Enter fullscreen mode Exit fullscreen mode

Function Project

This project consists of:

Amazon.Lambda.Tools:

Install Amazon.Lambda.Tools Global Tools if not already installed.

dotnet tool install -g Amazon.Lambda.Tools
Enter fullscreen mode Exit fullscreen mode

If already installed check if a new version is available.

dotnet tool update -g Amazon.Lambda.Tools
Enter fullscreen mode Exit fullscreen mode

About SAM

The Serverless Application Model Command Line Interface (SAM CLI) is an extension of the AWS CLI that adds functionality for building and testing Lambda applications. It uses Docker to run your functions in an Amazon Linux environment that matches Lambda. It can also emulate your application's build environment and API.

To use the SAM CLI, you need the following tools.

Use the SAM CLI to build and test locally

Build application with the sam build command.

sam build
Enter fullscreen mode Exit fullscreen mode

The SAM CLI installs dependencies defined in ./src/Dotnet.AWSLambda.AutoScaling.Application/Dotnet.AWSLambda.AutoScaling.Application.csproj, creates a deployment package, and saves it in the .aws-sam/build folder.

Events

Test a single function by invoking it directly with a test event. An event is a JSON document that represents the input that the function receives from the event source. Test events are included in the ./.events folder in this project.

json-event.json represents a simple json input.

request-event.json represents a request json input.

Run functions locally and invoke them with the sam local invoke command.

sam local invoke -e json-event.json
Enter fullscreen mode Exit fullscreen mode

OR

sam local invoke -e request-event.json
Enter fullscreen mode Exit fullscreen mode

API Request

The SAM CLI can also emulate the application's as API. Use the sam local start-api to run the API locally on port 3000.

sam local start-api
Enter fullscreen mode Exit fullscreen mode

Then, is possible to request using cURL or REST Client:

cURL

curl --header "Content-Type: application/json" -X POST -d "{ 'Scalings': [ { 'Tag': 'your-tag-name-here', 'Suspend': false }, { 'Tag': 'your-tag-name-h', 'Suspend': true } ] }" http://127.0.0.1:3000/api
Enter fullscreen mode Exit fullscreen mode

REST Client

POST http://127.0.0.1:3000/api/
content-type: application/json

{
    "Scalings": [
        {
            "Tag": "tag-name-here",
            "Suspend": false
        },
        {
            "Tag": "tag-name-here",
            "Suspend": true
        }
    ]
}
Enter fullscreen mode Exit fullscreen mode

API settings

The SAM CLI reads the application template to determine the API's routes and the functions that they invoke.

  Events:
    AutoScalingManager:
      Type: Api
      Properties:
        Path: '/api'
        Method: post
Enter fullscreen mode Exit fullscreen mode

Credentials

You can set credentials in the AWS credentials file on your local system. This file must be located in one of the following locations:

  • ~/.aws/credentials on Linux or macOS

  • C:\Users\USERNAME\.aws\credentials on Windows

This file should contain lines in the following format:

[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
Enter fullscreen mode Exit fullscreen mode
  • Environment variables – You can set the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables.

To set these variables on Linux or macOS, use the export command:

export AWS_ACCESS_KEY_ID=your_access_key_id
export AWS_SECRET_ACCESS_KEY=your_secret_access_key
Enter fullscreen mode Exit fullscreen mode

To set these variables on Windows, use the set command:

set AWS_ACCESS_KEY_ID=your_access_key_id
set AWS_SECRET_ACCESS_KEY=your_secret_access_key
Enter fullscreen mode Exit fullscreen mode

If you are testing this lambda project with SAM, is necessary to inform the credentials on template.yaml:

  Environment:
    Variables:
      AWS_ACCESS_KEY_ID: VALUE
      AWS_SECRET_ACCESS_KEY: VALUE
      AWS_DEFAULT_REGION: VALUE
Enter fullscreen mode Exit fullscreen mode

Unit tests

Tests are defined in the test folder in this project.

dotnet test
Enter fullscreen mode Exit fullscreen mode

You can find the full source project here.

GitHub logo AntonioFalcaoJr / Dotnet.AWSLambda.AutoScaling

This project demonstrates the integration with AWS Auto Scaling service and .NET Core, using SAM for building and test.

Enjoy!

Top comments (0)