Google Cloud Platform Pricing and Cost Calculator

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 audience

Full 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 365 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

☁️ Supported resources

The cost of a resource is calculated by multiplying its price by its usage.

Resources that gcosts supports, and Google charges for:

🧑‍🏫 Start the interactive tutorial

This guide is available as an interactive Cloud Shell tutorial. To get started, please click the following button:

🏃 Quick start

1. Get gcosts program

Download the ready complied and executable gcosts CLI program for your operating system and architecture.

2. Download price information

Download 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.

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:

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:

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:

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:

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
• Build pricing information file

🤓 Tip

Add gcosts to your Shell aliases with absolute pathnames. You can then execute gcosts anywhere.

Alias (~/.aliases):

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.
2. Fork this Git repository and make your changes.
3. Create a Pull Request.
4. Incorporate review feedback to your changes.
5. Accepted!

📜 License

All files in this repository are under the Apache License, Version 2.0 unless noted otherwise.

Portions of this repository are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.