Skip to content
A chef cookbook to keep your AWS autoscaling groups running cheaper than demand prices (like a boss)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

aws_see_spots_run Cookbook


A chef cookbook to manage Amazon Web Services spot instances within autoscaling groups via Chef, cron jobs, aws APIs, glitter, and magic.

See the wiki for details. aws_ssr is officially released on the chef supermarket.



  • Chef 11+

Cookbook dependencies


  • Debian, Ubuntu
  • CentOS, Red Hat, Fedora, Amazon Linux


Extended info on the Cookbook details wiki page.

Attribute Description Type Default
['exec_path'] Path where the scripts will live String '/usr/local/bin'
['excluded_regions'] Regions to exclude from ssr management String 'cn-north-1 us-gov-west-1'
['spot_request_killer']['interval'] Minutes between runs of spot_request_killer Integer 2
['spot_request_killer']['minutes_before_stale'] Minutes before an unfulfilled spot request is considered stale and tested for cancellation Integer 8
['price_monitor']['interval'] Minutes between runs of price_monitor Integer 6
['ASG_tagger']['interval'] Minutes between runs of ASG_tagger Integer 30
['ASG_tagger']['min_healthy_AZs'] Minumum number of availability zones to require in good health before bid is adjusted Integer 1
['health_enforcer']['interval'] Minutes between runs of health_enforcer Integer 10
['health_enforcer']['demand_expiration'] Minutes before an ASG which is temporarily using demand will be checked for return to spots Integer 50
['health_enforcer']['min_health_threshold'] Number of healthy checks required for an AZ to be considered healthy for an ASG (1, 2, or 3) Integer 3

Bugs / Development / Contributing

  • Report issues/questions/feature requests on in the Issues section.
  • Feel free to ask questions via email.

Pull requests are welcome! Ideally create a topic branch for every separate change you make. For example:

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Connect the existing git hooks (./bin/
  4. If possible, write some tests.
  5. Commit your awesome changes (git commit -am 'Added some feature')
  6. Push to the branch (git push origin my-new-feature)
  7. Create a new Pull Request and tell us about your changes.


Copyright 2015 Dreambox Learning, Inc.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.