Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Spot instance documentation #967

Merged
merged 3 commits into from
Aug 14, 2020
Merged

docs: Spot instance documentation #967

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d577016
Add example for lauch config with mixed lifecycles
toneill-newinnov Aug 5, 2020
fe37324
Set what on-demand instance is
toneill-newinnov Aug 5, 2020
98c3160
Tweak wording
dpiddock Aug 14, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions docs/spot-instances.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,30 @@ Launch Template support is a recent addition to both AWS and this module. It mig
]
```

## Using Launch Templates With Both Spot and On Demand

Example launch template to launch 2 on demand instances of type m5.large, and have the ability to scale up using spot instances and on demand instances. The `node.kubernetes.io/lifecycle` node label will be set to the value queried from the EC2 meta-data service: either "on-demand" or "spot".

`on_demand_percentage_above_base_capacity` is set to 25 so 1 in 4 new nodes, when auto-scaling, will be on-demand instances. If not set, all new nodes will be spot instances. The on-demand instances will be the primary instance type (first in the array if they are not weighted).

```hcl
worker_groups_launch_template = [{
name = "mixed-demand-spot"
override_instance_types = ["m5.large", "m5a.large", "m4.large"]
root_encrypted = true
root_volume_size = 50

asg_min_size = 2
asg_desired_capacity = 2
on_demand_base_capacity = 3
on_demand_percentage_above_base_capacity = 25
asg_max_size = 20
spot_instance_pools = 3

kubelet_extra_args = "--node-labels=node.kubernetes.io/lifecycle=`curl -s http://169.254.169.254/latest/meta-data/instance-life-cycle`"
}]
```

## Important Notes

An issue with the cluster-autoscaler: https://github.com/kubernetes/autoscaler/issues/1133
Expand Down