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.

🔍 gecco helps you find...

• Abandoned instances
• Idle instances
• Resizeable instances
• Abandoned disks
• Stale snapshots
• Idle addresses
• Idle images

👍🏻 Getting Started

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

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 [ COMMAND ] --project [ PROJECT_ID ]

If you need to run commands against a prject while billing to another project

gecco [ COMMAND ] --project [ PROJECT_ID ] --billing-project [ PROJECT_ID ]

If you need to imerpsonate a service account

gecco [ COMMAND ] --impersonate [ SERVICE_ACCOUNT_EMAIL ]

gecco recommends applying the Token Creator role to your user account on the service account or project level. This is a much more secure method than downloading physical keys.

🧑‍💻 Commands

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

gecco [COMMAND] help

👋 Need help or want to request a feature?

If you need help getting started, want to request a feature, or if we can help in any way with GCP cost optimisation, you can start a discussion with us!

🙋‍♀️ Contributing

• Uses the Cobra CLI framework
• Create a branch and open a descriptive Pull Request
• Raise an issue and we'll work on it

Like gecco?

☕️ Shout us a coffee!