Skip to content

baipi/aws-lambda-ec2-start-stop

 
 

Repository files navigation

AWS EC2 - Lambda Start / Stop Build Status

AWS Lambda function that will stop or stop EC2 instances that have a tag with the key start-group or stop-group and the value the name of the lambda function.

Originally forked from SamVerschueren/aws-lambda-stop-server updates include:

  • node ^4.x.x
  • cross-region
  • removed dependancies
  • ES6 codebase
  • modular, testable, functional and importantly readable codebase

Usage

Download the /dist/build.zip file from the latest release and deploy it as a lambda function (use master at your own risk).

Lambda settings:

  • Function Name Something that relates to the schedule e.g. week-day-startup or daily-shutdown.
  • Timeout 30 seconds or above
  • Runtime Node.js 4.3 and above
  • Handler for stopping instances index.stopTaggedInstances, for starting instances index.startTaggedInstances.
  • Event Sources Choose Scheduled Event then provide a cron expression e.g. cron(15 17 ? * MON-FRI *) This expression will stop the servers every weekday, from monday to friday, at 17:15 PM (UTC time).

Tags

Tagging your instance is very important in order for the lambda function to work properly. The lambda function will retrieve all instances across all regions that have a tag with a key stop-group or start-group, and a value being the name of the lambda function you provided.

For instance, if you named your lambda function week-day-startup, make sure you add a tag with key-value start-group=week-day-startup to all the instances you want to start on that particular schedule.

IAM Role

Make sure your lambda function is able to describe, start, and stop instances.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "MyStatementId",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeRegions",
                "ec2:DescribeInstances",
                "ec2:StopInstances",
                "ec2:StartInstances"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

License

MIT © Andrew McLagan

About

AWS Lambda function that will start and stop EC2 instances

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%