seeingidog2/tfsoa

Terraform State of Awareness Dashboard

Terraform State of Awareness (TFSOA)

A dashboard that helps centralize and monitor disparate Terraform states.

TFSOA accepts pushes of Terraform states and digraph output.

• Versioned backups of state
• Generate graph visual from digraph
• Dashboard to track useful state information

The Terraform version, JSON serial, JSON version and entire state are serialized saved. TFSOA uses this information across a multitude of states to present a single dashboard interface to view statistics on all Terraform states.

Setup database

bundle exec rake db:environment:set
bundle exec rake db:setup
bundle exec rake db:migrate

Recommended setup notes

Place behind and SSL endpoint like an Nginx, ELB or Haproxy to handle SSL. Terraform states typically contain sensative information.

Start TFSOA

rackup

This will start a rack server on port 9292

Add your first Terraform state to tfsoa

Unique identifiers for state

• team (team name that owns this tf state)
• product (my companies new product this supports)
• service (service name, or project name)
• environment (dev, stage, prod)

Example state push

curl 127.0.0.1:9292/tfsoa/add_tf_state/team/product/service/environment/ \
  -H "Content-Type: application/json" \
  -X \
  POST -d @.terraform/terraform.tfstate

Example graph push

terraform graph \
| curl -d @- http://localhost:9292/tfsoa/add_tf_graph/comms/trulia/someservice/prod/

Development Notes

Current entity-relationship diagram

Thank you

Thanks to Smashing gem for providing a solid framework for tfsoa to utilize