Skip to main content

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

Project description

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:

WakeyWakey

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

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

arch.png

  • 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mbonig.nightynight-1.98.1.tar.gz (77.2 kB view hashes)

Uploaded Source

Built Distribution

mbonig.nightynight-1.98.1-py3-none-any.whl (75.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page