Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator
πΈ Calculate estimated monthly costs of Google Cloud Platform products and resources via YAML files and CLI program (Linux, macOS, Windows)
https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator
billing cloud cloud-cost-estimates compute-engine cost-estimation cost-management cost-optimization finops gcp google-cloud google-cloud-platform google-compute-engine google-compute-instance infrastructure infrastructure-as-code invoice linux-cli linux-shell macos-cli usage
Last synced: 8 days ago
JSON representation
πΈ Calculate estimated monthly costs of Google Cloud Platform products and resources via YAML files and CLI program (Linux, macOS, Windows)
- Host: GitHub
- URL: https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator
- Owner: Cyclenerd
- License: apache-2.0
- Created: 2022-02-09T13:15:00.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-01T02:35:15.000Z (6 months ago)
- Last Synced: 2024-05-01T20:02:42.898Z (6 months ago)
- Topics: billing, cloud, cloud-cost-estimates, compute-engine, cost-estimation, cost-management, cost-optimization, finops, gcp, google-cloud, google-cloud-platform, google-compute-engine, google-compute-instance, infrastructure, infrastructure-as-code, invoice, linux-cli, linux-shell, macos-cli, usage
- Language: Go
- Homepage: https://gcloud-compute.com/gcosts.html
- Size: 11.8 MB
- Stars: 118
- Watchers: 6
- Forks: 17
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Google Cloud Platform Pricing and Cost Calculator
[![Badge: Google Cloud](https://img.shields.io/badge/Google%20Cloud-%234285F4.svg?logo=google-cloud&logoColor=white)](#readme)
[![Badge: Linux](https://img.shields.io/badge/Linux-FCC624.svg?logo=linux&logoColor=black)](#-quick-start)
[![Badge: macOS](https://img.shields.io/badge/macOS-000000.svg?logo=apple&logoColor=white)](#-quick-start)
[![Badge: Windows](https://img.shields.io/badge/Windows-008080.svg?logoColor=white)](#-quick-start)
[![Badge: Go](https://img.shields.io/badge/Go-%2300ADD8.svg?logo=go&logoColor=white)](#readme)
[![Go Report Card](https://goreportcard.com/badge/github.com/Cyclenerd/google-cloud-pricing-cost-calculator/gcosts)](https://goreportcard.com/report/github.com/Cyclenerd/google-cloud-pricing-cost-calculator/gcosts)
[![Badge: CI](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/actions/workflows/test.yml/badge.svg)](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/actions/workflows/test.yml)
[![Badge: GitHub](https://img.shields.io/github/license/cyclenerd/google-cloud-pricing-cost-calculator)](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/blob/master/LICENSE)
[![Badge: Downloads](https://img.shields.io/github/downloads/Cyclenerd/google-cloud-pricing-cost-calculator/total)](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases)| π Awarded |
|------------|
| This project was the winner of the [Google Open Source Peer Bonus](https://opensource.googleblog.com/2022/09/announcing-the-second-group-of-open-source-peer-bonus-winners-in-2022.html) in 2022 π₯³ |Calculate estimated monthly costs of Google Cloud Platform products and resources.
Optimized for DevOps, architects and engineers to quickly see a cost breakdown and compare different options upfront:* Mapping of resource usage is done in easy to learn **YAML** usage files
* Price information is read from a local file (`pricing.yml`)
* Calculation is done via `gcosts` **CLI** program
* Calculated costs are saved in **CSV** file optimized for non-technical audienceFull control and no disclosure of any information and costs to third parties.
Everything is calculated on your local computer.
No need to have a connection to the Internet.
Everything tested and matched against the actual invoice in large Google Cloud migration projects.
Over **438 automated tests** ensure `gcosts` reliability.
`gcosts` works on various OS and terminals, including Windows CMD, macOS iTerm2, and in CI systems like GitHub Actions.| 1οΈβ£ Create YAML file | 2οΈβ£ Run `gcosts` CLI program | 3οΈβ£ Open CSV file |
|---------------------|-----------------------------|------------------|
| ![Screenshot: YAML usage file](./img/usage.png) | ![Screenshot: gcosts CLI program](./img/gcosts.png) | ![Screenshot: CSV file](./img/csv.png) |## βοΈ Supported resources
The cost of a resource is calculated by multiplying its price by its usage.
| π‘ Google Cloud Free Program |
|------------------------------------------------|
| Free tiers and free trial (90-day, $300), which are usually not a significant part of cloud costs, are ignored. For example: 1x free non-preemptible `e2-micro` VM instance per month, free NAT for 32 VMs, 30 GB-months standard persistent disk, 1 GB network egress and everything [else](https://cloud.google.com/free/docs/gcp-free-tier/#compute) are not taken into account. |Resources that `gcosts` supports, and Google charges for:
π₯οΈ Compute Engine Instances
- [x] All machine types are supported
- [x] `A2` and `G2` accelerator optimized machines
- [x] `C2`, `C2D` and `H3` compute optimized machine series
- [x] `M1`, `M2` and `M3` memory optimized machine series
- [x] `C3`, `C3D`, `C4`, `C4A`, `E2`, `N1`, `N2`, `N4`, `N2D`, `T2D` and `T2A` general purpose machine series
- [x] Sustained use discounts (SUD) are applied to monthly costs
- [x] Spot provisioning model (Spot VM) is supported
- [ ] Flexible committed use discounts (Flexible CUD) are not supported
- [x] 1 year and 3 year committed use discounts (CUD) are supported
- [x] Paid "premium" operating system licenses (paid images) are supported
- [x] SUSE Linux Enterprise Server
- [x] SLES for SAP (1y and 3y committed use discounts (CUD) are also supported)
- [x] Red Hat Enterprise Linux (1y and 3y committed use discounts (CUD) are also supported)
- [x] RHEL for SAP (1y and 3y committed use discounts (CUD) are also supported)
- [x] Windows Server
- [x] Custom machine types are supported (have to be created manually)
- [ ] Sole-tenant VMs are not supportedπΎ Compute Engine Disks
- [x] All persistent disk (PD) types are supported
- [x] Zonal persistent disk
- [x] Regional persistent disk
- [x] Local SSD
- [ ] Provisioned IOPSπͺ£ Cloud Storage
- [x] All storage classes and location types are supported
- [x] region
- [x] dual-region
- [x] multi-region
- [x] Retrieval fees are calulatedπ Hybrid Connectivity
- [x] VPN tunnel
- [ ] Interconnect is currently not calculatedπ Cloud NAT
- [x] NAT gateway
- [x] Data processing (both egress and ingress)π¦ Cloud Monitoring (Operations Suite)
- [x] Monitoring data
πΈοΈ Network
- [x] Premium Tier internet egress
- [x] Worldwide destinations (excluding China & Australia, but including Hong Kong)
- [x] China destinations (excluding Hong Kong)
- [x] Australia destinationsποΈ TODO
The following services are not currently supported, but are on the TODO list:
- [ ] BigQuery
- [ ] Cloud SQLPlease suggest other resources worth covering by upvoting existing issue or opening new issue.
## π§βπ« Start the interactive tutorial
This guide is available as an interactive Cloud Shell tutorial.
To get started, please click the following button:[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.png)](https://shell.cloud.google.com/cloudshell/open?cloudshell_git_repo=https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator&cloudshell_git_branch=master&cloudshell_tutorial=cloud-shell-tutorial.md)
## π Quick start
### 1. Get `gcosts` program
[Download](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest) the ready complied and executable `gcosts` CLI program for your operating system and architecture.
Linux
Download:
* [x86_64](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-linux-x86_64) Intel or AMD 64-Bit CPU
```bash
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-linux-x86_64" \
-o "gcosts" && \
chmod +x "gcosts"
```
* [arm64](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-linux-arm64) Arm-based 64-Bit CPU (i.e. in Raspberry Pi)
```bash
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-linux-arm64" \
-o "gcosts" && \
chmod +x "gcosts"
```To determine your OS version, run `getconf LONG_BIT` or `uname -m` at the command line.
Execute `gcosts`:
```bash
./gcosts help
```macOS
Download:
* [x86_64](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-macos-x86_64) Intel 64-bit
```bash
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-macos-x86_64" \
-o "gcosts" && \
chmod +x "gcosts"
```
* [arm64](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-macos-arm64) Apple silicon 64-bit
```bash
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-macos-arm64" \
-o "gcosts" && \
chmod +x "gcosts"
```To determine your OS version, run `uname -m` at the command line.
Execute `gcosts`:
```bash
./gcosts help
```Windows
Download:
* [x86_64](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-windows-x86_64.exe) Intel or AMD 64-Bit CPU
```powershell
Invoke-WebRequest -Uri "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-windows-x86_64.exe" -OutFile "gcosts.exe"
```
* [arm64](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-windows-arm64.exe) Arm-based 64-Bit CPU
```powershell
Invoke-WebRequest -Uri "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/releases/latest/download/gcosts-windows-arm64.exe" -OutFile "gcosts.exe"
```
To determine your OS version, run `echo %PROCESSOR_ARCHITECTURE%` at the command line.Execute `gcosts.exe`:
```powershell
.\gcosts.exe help
```### 2. Download price information
[Download](https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml) the latest and tested price information file `pricing.yml`.
The price information is automatically regenerated on a weekly basis.
Download the updated pricing file regularly.Linux
Download `pricing.yml`:
```bash
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml" \
-o "pricing.yml"
```macOS
Download `pricing.yml`:
```bash
curl -L "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml" \
-o "pricing.yml"
```Windows
Download `pricing.yml`:
```powershell
Invoke-WebRequest -Uri "https://github.com/Cyclenerd/google-cloud-pricing-cost-calculator/raw/master/pricing.yml" -OutFile "pricing.yml"
```### 3. Run it
Prepare a separate directory (i.e. `usage`) just for your YAML usage files and create your first YAML usage file (`resources.yml`) in this directory:
```yml
region: europe-west4
project: my-first-project
instances:
- name: app-server
type: e2-standard-8
os: rhel
commitment: 3
disks:
- name: disk-boot
type: ssd
data: 75
```> **Warning**
> If the price list (`pricing.yml`) is in the same directory, errors occur because the YAML file is also parsed.Execute the CLI program:
Linux
Execute `gcosts`:
```bash
./gcosts calc --pricing YML-PRICING-PATH
```macOS
Execute `gcosts`:
```bash
./gcosts calc --pricing YML-PRICING-PATH
```Windows
Execute `gcosts.exe`:
```powershell
.\gcosts.exe calc --pricing YML-PRICING-PATH
```Without extra specification of the directory all YAML files (`*.yml`) of the current directory are imported and the costs of the resources are calculated.
You can specify the directory:
```bash
gcosts calc --dir DIRECTORY-PATH --pricing YML-PRICING-PATH
```The calculated costs are exported to one CSV (comma-separated values) file.
Without specifying the file location, the file is named `costs.csv` and is saved in the current directory.
You can specify the CSV export file:
```bash
gcosts calc --csv CSV-EXPORT-FILE-PATH --pricing YML-PRICING-PATH
```You can import the CSV file with MS Excel, Apple Numbers, LibreOffice or Google Sheets.
### 4. Get familiar
Continue to familiarize yourself with the options. The following documentations are prepared for this purpose:
* [Create usage files](usage/README.md)
* [Build pricing information file](build/README.md)**π€ Tip**
Add `gcosts` to your Shell aliases with absolute pathnames.
You can then execute `gcosts` anywhere.Alias (`~/.aliases`):
```bash
alias gcosts='/your-pathname/gcosts --pricing /your-pathname/pricing.yml'
```## β€οΈ Contributing
Have a patch that will benefit this project?
Awesome! Follow these steps to have it accepted.1. Please read [how to contribute](CONTRIBUTING.md).
1. Fork this Git repository and make your changes.
1. Create a Pull Request.
1. Incorporate review feedback to your changes.
1. Accepted!## π License
All files in this repository are under the [Apache License, Version 2.0](LICENSE) unless noted otherwise.
Portions of this repository are modifications based on work created and shared by [Google](https://developers.google.com/readme/policies)
and used according to terms described in the [Creative Commons 4.0 Attribution License](https://creativecommons.org/licenses/by/4.0/).