Skip to content

Saves up to 90% of AWS EC2 costs by automating the use of spot instances on existing AutoScaling groups. Installs in minutes using CloudFormation or Terraform. Convenient to deploy at scale using StackSets. Uses tagging to avoid launch configuration changes. Automated spot termination handling. Reliable fallback to on-demand instances.

License

Notifications You must be signed in to change notification settings

vicgud/AutoSpotting

Repository files navigation

AutoSpotting

A simple tool designed to significantly lower your Amazon AWS costs by automating the use of the spot market. It can often achieve savings up to 90% off the usual on-demand prices, like shown in the screenshot below.

When enabled on your existing on-demand AutoScaling group, it starts launching EC2 spot instances that are cheaper, at least as powerful and configured as closely as possible as your existing on-demand instances.

It then gradually swaps them with your existing on-demand instances, which can then be terminated.

Launch

Features and Benefits

  • Easy to install and set up on existing environments based on AutoScaling

    • you can literally get started within 5 minutes, unlike SpotFleets or other tools which may require a considerable migration effort.
    • only needs to be installed once, in a single region, and can handle all other regions without any additional configuration, see the installation steps below for more details.
    • easy to enable and disable for reverting to the initial configuration based on resource tagging, if you decide you don't want to use it anymore.
    • easy to automate migration of multiple existing stacks, simply using scripts that set the expected tag on multiple AutoScaling groups.
  • Designed for use against AutoScaling groups with relatively long-running instances

    • for use cases where it is acceptable to run costlier on-demand instances from time to time.
    • for short-term batch processing use cases you should have a look into the spot blocks instead.
  • It doesn't interfere with the group's original launch configuration

    • any instance replacement or scaling done by AutoScaling would still launch your previously configured on-demand instances.
    • on-demand instances often launch faster than spot ones so you don't need to wait for potentially slower spot instance fulfilment when you need to scale out or when you eventually lose some of the spot capacity, which may happen when using spot fleets or other similar tools.
  • Supports any higher level AWS services internally backed by AutoScaling

    • services such as ECS or Elastic Beanstalk work out of the box.
    • with minimal configuration changes, unlike spot fleets or other tools.
  • Compatible out of the box with most AWS services that integrate with AutoScaling groups

    • services such as ELB, ALB, CodeDeploy, CloudWatch, etc. should work out of the box or at most require minimal configuration changes.
    • as long as they support instances attached later to existing groups.
    • this may be problematic for some (some Code Deploy use scenarios come to mind) but in general it works.
  • Can automatically replace any instance types with any instance types available on the spot market

    • as long as they are cheaper and at least as big as the original instances.
    • it doesn't matter if the original instance is available on the spot market: for example it is often replacing t2.medium with better m4.large instances, as long as they happen to be cheaper.
  • Self-hosted

    • has no runtime dependencies on external infrastructure except for the regional EC2 and AutoScaling API endpoints.
    • it's not a SaaS, it fully runs within your AWS account.
    • it doesn't gather/persist/export any information about the resources running in your AWS account.
  • Free and open source

    • there are no service fees at install time or run time.
    • you only pay for the small runtime costs it generates.
    • open source, so it is fully auditable and you can see the logs of everything it does.
    • the code is relatively small and simple so in case of bugs or missing features you may even be able to fix it yourself.
  • Negligible runtime costs

    • you only pay for the bandwidth consumed performing API calls against AWS services across different regions.
    • backed by Lambda, with typical monthly execution time well within the Lambda free tier plan.
  • Minimalist and simple implementation

    • currently about 1000 CLOC of relatively readable Golang code.
    • stateless, and without many moving parts.
    • leveraging and relying on battle-tested AWS services - namely AutoScaling - for most mission-critical things, such as instance health checks, horizontal scaling, replacement of terminated instances, integration with, ELB, ALB and CloudWatch.
  • Relatively safe and secure

    • most runtime failures or crashes(quite rare nowadays) tend to be harmless.
    • often only result in failing to start new spot instances so your group will simply remain or fall back to on-demand capacity, just as it was before.
    • in most cases it is not impacting your running instances nor the ability to launch new ones.
    • only needs the minimum set of IAM permissions needed for it to do its job.
    • does not delegate any IAM permissions to resources outside of your AWS account.
  • Optimizes for high availability over cost whenever possible

    • it tries to diversify the instance types.
    • when having enough desired capacity, it is often spreading over four different spot pricing zones (instance type/availability zone combinations).
  • Significant cost savings compared to on-demand or reserved instances

    • up to 90% cost reduction compared to on-demand instances.
    • up to 75% cost reduction compared to reserved instances, without any down-payment or long term commitment.
    • in the screenshot below you can see the results after enabling it on an on-demand AutoScaling group.

Savings Graph

Getting Started

Requirements

  • You will need credentials to an AWS account able to start CloudFormation stacks.
  • Some of the following steps assume you have the AWS cli tool installed, but the setup can also be done manually using the AWS console or using other tools able to launch CloudFormation stacks and set tags on AutoScaling groups.

Installation

You only need to launch a CloudFormation stack in your account. Click the button below and follow the launch wizard to completion, you can safely use the default stack parameters.

Launch

If you are using the AWS command-line tool, you can use this command instead:

aws cloudformation create-stack \
--stack-name AutoSpotting \
--template-url https://s3.amazonaws.com/cloudprowess/dv/template.json \
--capabilities CAPABILITY_IAM

Notes:

  • For technical reasons the stack needs to be launched in the US-East-1(Virginia) region, so make sure it's not created in another region.
  • The AutoScaling groups it runs against can be in any region, since all regions are processed at runtime.

Configuration for an AutoScaling group

Since AutoSpotting uses an opt-in model, nothing will be touched in your AWS account if you just launch the stack. You will need to explicitly enable it for each AutoScaling group where you want it to be used.

Enabling it for an AutoScaling group is a matter of setting a tag on the group:

Key: spot-enabled
Value: true

This can be configured with the AWS console from this view,

If you use the AWS command-line tools, the same can be achieved using this command:

aws autoscaling
--region eu-west-1 \
create-or-update-tags \
--tags ResourceId=my-auto-scaling-group,ResourceType=auto-scaling-group,Key=spot-enabled,Value=true,PropagateAtLaunch=false

Note

  • the above instructions use the eu-west-1 AWS region as an example. Depending on where your groups are defined, you may need to use a different region, since as mentioned before, your environments may be located anywhere.

This needs to be done for every single AutoScaling group where you want it enabled, otherwise the group is ignored. If you have lots of groups you may want to script it in some way.

One good way to automate is using CloudFormation, using this example snippet:

"MyAutoScalingGroup": {
  "Properties": {
    "Tags":[
    {
      "Key": "spot-enabled",
      "Value": "true",
      "PropagateAtLaunch": false
    }
    ]
  }
}

Elastic Beanstalk Installation

  • In order to add tags to existing Elastic Beanstalk environment, you will need to rebuild the environment with the spot-enabled tag. Follow this guide

Updates and Downgrades

The software doesn't auto-update anymore(it used to in the first few versions), so you will need to manually perform updates using CloudFormation, based on the Travis CI build number of the version you would like to use going forward.

This method can be used both for upgrades and downgrades, so assuming you would like to switch to the build with the number 45, you will need to perform a CloudFormation stack update in which you change the "LambdaZipPath" stack parameter to a value that looks like dv/lambda_build_45.zip.

Git commit SHAs(truncated to 7 characters) are also accepted instead of the build numbers, so for example dv/lambda_build_f7f395d.zip should also be a valid parameter, as long as that build is available in the author's S3 bucket.

The full list of builds and their respective git commits can be seen on the Travis CI builds page

Compatibility notices

  • As of build 79 the CloudFormation template is also versioned for every subsequent build, but unfortunately this build also breaks compatibility with older stacks. If you run an older build you will also need to update the stack when updating to a build later than 79. Although the template rarely changes, it's recommended that you always keep it at the same build as the binary. Make sure you use the following stack parameter on any newer builds:
LambdaHandlerFunction: handler.handle

Uninstallation

If at some point you want to uninstall it, you just need to delete the CloudFormation stack.

The AutoScaling groups where it used to be enabled will keep running until their spot instances eventually get outbid and terminated, then replaced by AutoScaling with on-demand ones. This is eventually bringing the group to the initial state. If you want, you can speed up the process by gradually terminating the spot instances yourself.

The tags set on the group can be deleted at any time you want it to be disabled for that group.

Best Practices

These recommendations apply for most cloud environments, but they become especially important when using more volatile spot instances.

  • Set a non-zero grace period on the AutoScaling group

    • in order to attach spot instances only after they are fully configured.
    • otherwise they may be attached prematurely before being ready.
    • they may be also be terminated after failing load balancer health checks.
  • Check your instance storage and block device mapping configuration

    • this may be an issue if you use instances which have ephemeral instance storage, often the case on previous instance types.
    • you should only specify ephemeral instance store in the on-demand launch configuration if you do make use of it by mounting it on the filesystem.
    • the replacement algorithm tries to give you instances with as much instance storage as your original instances, since it can't tell if you did mount it.
    • this adds more constraints on the algorithm, so it reduces the number of compatible instance types it can use for launching spot instances.
    • this is fine if you actually use that instance storage, but it is reducing your options if you don't actually use it, so it may more often fail to get spot instances and fall back to on-demand capacity.
  • Don't keep state on instances

    • You should delegate all your state to external services, AWS has a wide offering of stateful services which allow your instances to become stateless.
      • Databases: RDS, DynamoDB
      • Caches: ElastiCache
      • Storage: S3, EFS
      • Queues: SQS
    • Don't attach EBS volumes to individual instances, try to use EFS instead.
  • Handle the spot instance termination signal

    • AWS informs your spot instances when they are about to be terminated, make use of that information to save whatever temporary state you may still have on your running spot instances.
    • There are existing tools which implement such an event handler, such as seespot. This will need to be added to your user_data script.

How it works

Once enabled on an AutoScaling group, it is gradually replacing all the on-demand instances belonging to the group with compatible and similarly configured but cheaper spot instances.

The replacements are done using the relatively new Attach/Detach actions supported by the AutoScaling API. A new compatible spot instance is launched, and after a while, at least as much as the group's grace period, it will be attached to the group, while at the same time an on-demand instance is detached from the group and terminated in order to keep the group at constant capacity.

When assessing the compatibility, it takes into account the hardware specs, such as CPU cores, RAM size, attached instance store volumes and their type and size, as well as the supported virtualization types (HVM or PV) of both instance types. The new spot instance is usually a few times cheaper than the original instance, while also often providing more computing capacity.

The new spot instance is configured with the same roles, security groups and tags and set to execute the same user data script as the original instance, so from a functionality perspective it should be indistinguishable from other instances in the group, although its hardware specs may be slightly different(again: at least the same, but often can be of bigger capacity).

When replacing multiple instances in a group, the algorithm tries to use a wide variety of instance types, in order to reduce the probability of simultaneous failures that may impact the availability of the entire group. It always tries to launch the cheapest available compatible instance type, but if the group already has a considerable amount of instances of that type in the same availability zone (currently more than 20% of the group's capacity is in that zone and of that instance type), it picks the second cheapest compatible instance, and so on.

During multiple replacements performed on a given group, it only swaps them one at a time per Lambda function invocation, in order to not change the group too fast, but instances belonging to multiple groups can be replaced concurrently. If you find this slow, the Lambda function invocation frequency (defaulting to once every 5 minutes) can be changed by updating the CloudFormation stack, which has a parameter for it.

In the (so far unlikely) case in which the market price is high enough that there are no spot instances that can be launched, (and also in case of software crashes which may still rarely happen), the group would not be changed and it would keep running as it is, but AutoSpotting will continuously attempt to replace them, until eventually the prices decrease again and replaecments may succeed again.

Internal components

When deployed, the software consists on a number of resources running in your Amazon AWS account, created automatically with CloudFormation:

Event generator

Similar in concept to @alestic's unreliable-town-clock, but internally using the new CloudWatch events just like in his later developments.

  • It is configured to generate a CloudWatch event, for triggering the Lambda function.
  • The default frequency is every 5 minutes, but it is configurable using CloudFormation

Lambda function

  • AWS Lambda function connected to the event generator, which triggers it periodically.
  • It has assigned a IAM role and policy with a set of permissions to call the APIs of various AWS services(EC2 and AutoScaling for now) within the user's account.
  • The permissions are the minimal set required for it to work without the need of passing any explicit AWS credentials or access keys.
  • Contains a handler written in Golang, built using the eawsy/aws-lambda-go library, which implements a novel aproach that allows Golang code compiled natively to be built in such a way that it can be injected into the Lambda Python runtime.
  • The handler implements all the instance replacement logic.
    • The spot instances are created by duplicating the configuration of the currently running on-demand instances as closely as possible(IAM roles, security groups, user_data script, etc.) only by adding a spot bid price attribute and eventually changing the instance type to a usually bigger, but compatible one.
    • The bid price is set to the on-demand price of the instances configured initially on the AutoScaling group.
    • The new launch configuration may also have a different instance type, determined based on compatibility with the original instance type, considering also how much redundancy we need to have in place in the current availability zone, in order to survive instance termination when outbid for a certain instance type.

Compiling and Installing your own components

It's relatively easy to build and install your own version of this tool's binaries, removing your dependency on the author's version, and allowing any customizations and improvements your organization needs.

More details here

GitHub Badges

Build Status Coverage Status Code Climate Issue Count license Chat on Gitter

About

Saves up to 90% of AWS EC2 costs by automating the use of spot instances on existing AutoScaling groups. Installs in minutes using CloudFormation or Terraform. Convenient to deploy at scale using StackSets. Uses tagging to avoid launch configuration changes. Automated spot termination handling. Reliable fallback to on-demand instances.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 97.1%
  • Makefile 1.4%
  • Python 1.4%
  • Dockerfile 0.1%