gecco

README

gecco helps teams optimise their cloud resource costs. Locate abandoned, idle, and inefficiently configured resources quickly. gecco helps teams build a culture of cost optimisation awareness in an easy-to-use and feature-rich tool.

Install gecco

Install go, then install gecco

go install github.com/aeihr/gecco@latest

Set your go/bin in your $PATH

export PATH=$PATH:$(go env GOPATH)/bin

gecco is now available from anywhere in your terminal

gecco --version

Getting Started

Login to gcloud

gecco makes use of your gcloud credentials for a secure authentication process

gcloud init

Provision your Application Default Credentials (ADC)

gcloud auth application-default login

You're all set, now you can run commands against projects you have access to:

gecco instances idle --project myproject

If you need to run commands against a billing project while targetting a project, simple

gecco instances idle --project myproject --billing-project anotherproject

Commands

To learn more about gecco commands read the user guide here or

gecco [COMMAND] help

Features

Locate

Instances

• List abandoned instances
• List idle instances
• List resizeable instances

Images

• List idle images

Disks

• List abandoned disks

Snapshots

• List stale/old snapshots

Addresses

• List idle external addresses

Catalogue

• List resource pricing
• List services

Coming...

• Storage bucket optimisations
• GKE cluster optimisations

Operation

• Utilise as a CLI tool for daily auditing
• As a standalone automated service with logging for event driven services (Container) (coming soon)

Contributing

• Uses the Cobra CLI framework
• Create a branch and open a descriptive PR