amazon/amazon-ec2-instance-selector pulls statistics

Amazon EC2 Instance Selector

A CLI tool and go library which recommends instance types based on resource criteria like vcpus and memory.

Summary

There are over 270 different instance types available on EC2 which can make the process of selecting appropriate instance types difficult. Instance Selector helps you select compatible instance types for your application to run on. The command line interface can be passed resource criteria like vcpus, memory, network performance, and much more and then return the available, matching instance types.

If you are using spot instances to save on costs, it is a best practice to use multiple instances types within your auto-scaling group (ASG) to ensure your application doesn't experience downtime due to one instance type being interrupted. Instance Selector will help to find a set of instance types that your application can run on.

Instance Selector can also be consumed as a go library for direct integration into your go code.

Major Features

• Filter AWS Instance Types using declarative resource criteria like vcpus, memory, network performance, and much more! • Aggregate filters allow for more opinionated instance selections like --base-instance-type and --flexible • Consumable as a go library

Installation and Configuration

Install w/ Homebrew

Install w/ Curl for Linux/Mac

To execute the CLI, you will need AWS credentials configured. Take a look at the AWS CLI configuration documentation for details on the various ways to configure credentials. An easy way to try out the ec2-instance-selector CLI is to populate the following environment variables with your AWS API credentials.

If you already have an AWS CLI profile setup, you can pass that directly into ec2-instance-selector:

You can set the AWS_REGION environment variable if you don't want to pass in --region on each run.

Examples

CLI

Find Instance Types with 4 GiB of memory, 2 vcpus, and runs on the x86_64 CPU architecture

Find instance types that support 100GB/s networking

Short Table Output

Wide Table Output

All CLI Options

Go Library

This is a minimal example of using the instance selector go package directly:

cmd/examples/example1.go

Execute the example:

*NOTE: Make sure you have AWS credentials setup*

Building

For build instructions please consult BUILD.md.

Communication

If you've run into a bug or have a new feature request, please open an issue.

Check out the open source Amazon EC2 Spot Instances Integrations Roadmap to see what we're working on and give us feedback!

Contributing

Contributions are welcome! Please read our guidelines and our Code of Conduct.

License

This project is licensed under the Apache-2.0 License.

Description from the Docker Hub listing.