Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/powdahound/ec2instances.info
Amazon EC2 instance comparison site
https://github.com/powdahound/ec2instances.info
amazon aws cloud cloud-cost cloud-cost-intelligence cost-estimation cost-optimization ec2 finops rds
Last synced: 3 months ago
JSON representation
Amazon EC2 instance comparison site
- Host: GitHub
- URL: https://github.com/powdahound/ec2instances.info
- Owner: vantage-sh
- License: mit
- Created: 2011-11-07T04:17:15.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2024-03-07T20:33:48.000Z (8 months ago)
- Last Synced: 2024-04-10T15:06:44.914Z (7 months ago)
- Topics: amazon, aws, cloud, cloud-cost, cloud-cost-intelligence, cost-estimation, cost-optimization, ec2, finops, rds
- Language: Mako
- Homepage: https://ec2instances.info
- Size: 30.9 MB
- Stars: 4,934
- Watchers: 89
- Forks: 580
- Open Issues: 93
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - ec2instances.info - Amazon EC2 instance comparison site (HTML)
README
# EC2Instances.info
[](https://aws.amazon.com/)
[](https://www.python.org/downloads/release/python-380/)
[](https://github.com/psf/black)
> I was sick of comparing EC2 instance metrics and pricing on Amazon's site so I
> made [EC2Instances.info](https://ec2instances.info).
EC2Instances.info was originally created by [Garret
Heaton](https://github.com/powdahound), is now hosted by
[Vantage](https://vantage.sh/) and developed by the community of contributors.
## Project status
Vantage employees are actively maintaining and hosting the site with the help of contributors here. Improvements in the form of pull requests or ideas via issues are welcome!
People have suggested many neat ideas and feature requests by opening issues on this repository. We also have a [Slack
Community](https://vantage.sh/slack) for anyone to join with a devoted channel named #instances-vantage.sh.
## Running locally
First, you'll need to provide credentials so that boto can access the AWS API. [See a terraform example here](./docs/terraform/iam.tf)!
Options for setting this up are described in the [boto
docs](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html).
Ensure that your IAM user has at least the following permissions:
```json
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ec2:DescribeInstanceTypes",
"ec2:DescribeRegions",
"pricing:*",
"elasticache:DescribeEngineDefaultParameters"
],
"Resource": "*"
}
]
}
```
## Running in Docker (recommended)
1. Clone the repository, if not already done:
```bash
git clone https://github.com/vantage-sh/ec2instances.info
cd ec2instances.info
```
2. Build a `docker` image:
```bash
docker build -t ec2instances.info .
```
3. Run a container from the built `docker` image:
````bash
docker run -d --name some-container -p 8080:8080 ec2instances.info
4. Open [localhost:8080](http://localhost:8080) in your browser to see it in action.
## Docker Compose
Here's how you can build and run docker image using Docker Compose (tested with Docker Compose v2):
```bash
docker-compose up
````
4. Open [localhost:8080](http://localhost:8080) in your browser to see it in action.
## Detailed local build instructions
Note: These instructions are only kept here for reference, the Docker
instructions mentioned above hide all these details and are recommended for local execution.
Make sure you have LibXML and Python development files. On Ubuntu, run `sudo apt-get install python-dev libxml2-dev libxslt1-dev libssl-dev`.
Then:
```bash
git clone https://github.com/vantage-sh/ec2instances.info
cd ec2instances.info/
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt
invoke build
invoke serve
open http://localhost:8080
deactivate # to exit virtualenv
```
## Requirements
- Python with virtualenv
- [Invoke](http://www.pyinvoke.org/)
- [Boto](http://boto.readthedocs.org/en/latest/)
- [Mako](http://www.makotemplates.org/)
- [lxml](http://lxml.de/)
## Tips for Developing Locally
```
docker build --no-cache --build-arg AWS_ACCESS_KEY_ID= --build-arg AWS_SECRET_ACCESS_KEY= -t ec2instances.info .
docker run -it --rm --name ec2instances -v $(pwd):/opt/app --env HTTP_HOST=0.0.0.0 -p 8080:8080 ec2instances.info
docker exec -it ec2instances /bin/bash
# INSIDE CONTAINER
python3 render.py
sass --watch in/style.scss:www/style.css
```
## API Access
The data backing EC2Instances.info is available via a free API.
- To get started, create a [free API key](https://vantage.readme.io/reference/authentication).
- Review the `providers`, `services`, and `products` endpoints in the [API documentation](https://vantage.readme.io/reference/getproducts).
## Keep up-to-date
Feel free to watch/star this repo as we're looking to update the site regularly. Vantage also works on the following relevant projects:
- [The Cloud Cost Handbook](https://github.com/vantage-sh/handbook) - An
open-source set of guides for best practices of managing cloud costs.
- [The AWS Cost Leaderboard](https://leaderboard.vantage.sh/) - A hosted site of
the top AWS cost centers.
- [Vantage](https://vantage.sh/) - A cloud cost transparency platform.