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

Jump to bottom

Update instance_groups.md #9072

Merged
merged 2 commits into from
May 8, 2020
Merged

Update instance_groups.md #9072

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
49e3ab5
Update instance_groups.md
May 6, 2020
5e3cd0c
Update instance_groups.md
May 6, 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
49 changes: 42 additions & 7 deletions docs/instance_groups.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -143,9 +143,45 @@ which would end up in a drop-in file on nodes of the instance group in question.

## mixedInstancePolicy (AWS Only)

### Example

```
apiVersion: kops.k8s.io/v1alpha2
kind: InstanceGroup
metadata:
generation: 2
labels:
kops.k8s.io/cluster: <clustername>
name: spot-4vcpu-16gb
spec:
cloudLabels:
autoscaler: enabled
cluster: kops-cluster
image: kope.io/k8s-1.16-debian-stretch-amd64-hvm-ebs-2020-01-17
maxSize: 5
minSize: 1
machineType: m5.xlarge
mixedInstancesPolicy:
instances:
- m5.xlarge
- m5d.xlarge
- m4.xlarge
- t3.xlarge
- t3a.xlarge
- m5a.xlarge
- m5ad.xlarge
- m5n.xlarge
- m5dn.xlarge
onDemandBase: 0
onDemandAboveBase: 0
spotAllocationStrategy: capacity-optimized
nodeLabels:
lifecycle: Ec2Spot
```

### Instances

Instances is a list of instance types which we are willing to run in the EC2 fleet
Instances is a list of instance types which we are willing to run in the EC2 Auto Scaling group

### onDemandAllocationStrategy

Expand All @@ -164,12 +200,11 @@ leave this parameter set to 100, the percentages are 100% for On-Demand Instance
Spot Instances.

### spotAllocationStrategy
SpotAllocationStrategy Indicates how to allocate instances across Spot Instance pools.

SpotAllocationStrategy diversifies your Spot capacity across multiple instance types to
find the best pricing. Higher Spot availability may result from a larger number of
instance types to choose from https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-fleet.html#spot-fleet-allocation-strategy
If the allocation strategy is lowest-price, the Auto Scaling group launches instances using the Spot pools with the lowest price, and evenly allocates your instances across the number of Spot pools that you specify in spotInstancePools. If the allocation strategy is [capacity-optimized](https://aws.amazon.com/blogs/compute/introducing-the-capacity-optimized-allocation-strategy-for-amazon-ec2-spot-instances/), the Auto Scaling group launches instances using Spot pools that are optimally chosen based on the available Spot capacity.
https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_InstancesDistribution.html

### spotInstancePools

SpotInstancePools is the number of Spot pools to use to allocate your Spot capacity (defaults to 2)
pools are determined from the different instance types in the Overrides array of LaunchTemplate
Used only when the Spot allocation strategy is lowest-price.
The number of Spot Instance pools across which to allocate your Spot Instances. The Spot pools are determined from the different instance types in the Overrides array of LaunchTemplate. Default if not set is 2.