mbonig.nightynight 1.98.1

A CDK construct that will automatically stop a running EC2 instance at a given time.

NightyNight and WakeyWakey!

Do you have a EC2 instance or an RDS instance that you only need during certain hours of the day? Do you want to reduce it's cost? How about just stopping it every night?

That's the NightyNight construct. It's very simple. Give it an instanceId and it will create a Lambda and a CloudWatch Event Rule to fire the lambda at a specific time of day. If the instance is running, it's stopped.

There are currently two variations of the construct:

• NightyNightForEc2 - stops an EC2 instance at a given time.
• NightyNightForRds - stops an RDS instance at a given time.
• NightyNightForAsg - sets the desired capacity for an ASG at a given time.

WakeyWakey

The WakeyWakey construct (from this repository) has been integrated into this library. You don't need to install a separate dependency anymore.

• WakeyWakeyForEc2 - start an EC2 instance at a given time.
• WakeyWakeyForRds - start an RDS instance at a given time.

There isn't a specific construct for starting ASGs, since you can just set the count to whatever you want.

This is a pre-release!

This is a quick first-draft. All the options that will likely need to be added to accommodate a large number of use-cases are still needed. If you'd like to make requests or help update this construct, please open an Issue or a PR.

There are multiple versions of this library published. You should be using the v0.X.X versions for now. There are versions published that match the CDK version they depend on, but don't use those.

What it creates

• A Rule that will, on a given schedule, fire a lambda.
• A Lambda with permissions to describe ec2 instances. It will read the instance by the given instanceId and then stop the instance if it's in a running state.

Example:

import {NightyNightForEc2, WakeyWakeyForEc2} from "./ec2";

export class NightyNightStack extends Stack {

  constructor(scope: Construct, id: string, props: StackProps) {
    super(scope, id, props);

    // The code that defines your stack goes here
    new NightyNightForEc2(this, 'nighty-night', {instanceId: 'i-123123123123'});
    new WakeyWakeyForEc2(this, 'wakey-wakey', {instanceId: 'i-123123123123'})
  }
}

This will stop the instance with id i-123123123123 at (the default) 4am UTC. It will then start the instance at 12am UTC.

API Doc

See the API Docs for more info.

Contributing

Please open Pull Requests and Issues on the Github Repo.

License

MIT