Browse the Repo

file-type-icon.circleci
file-type-icondocs
file-type-iconexamples
file-type-iconmodules
file-type-icontest
file-type-icon.gitattributes
file-type-icon.gitignore
file-type-iconCODEOWNERS
file-type-iconFORCEDEPLOY
file-type-iconLICENSE.txt
file-type-iconREADME.md

Browse the Repo

file-type-icon.circleci
file-type-icondocs
file-type-iconexamples
file-type-iconmodules
file-type-icontest
file-type-icon.gitattributes
file-type-icon.gitignore
file-type-iconCODEOWNERS
file-type-iconFORCEDEPLOY
file-type-iconLICENSE.txt
file-type-iconREADME.md
houston

houston

Code Preview

Preview the Code

mobile file icon

README.md

down

Gruntwork Houston

This repository contains modules Gruntwork customers can use to deploy Gruntwork Houston in their AWS accounts. On the surface, Gruntwork Houston is a simple web interface that a Dev team can use to deploy and manage infrastructure. Under the hood, the web interface and how it manages infrastructure are completely defined and controlled by the Ops team using infrastructure as code.

If you're a new user of Gruntwork Houston, check out our tour.

NOTE: Some of the contents of this repo are stored in Git LFS (Large File Storage), so you must install the git-lfs client before running git clone! E.g., On Mac, you can run brew install git-lfs. For other operating systems, see git-lfs installation.

Architecture

ArchitectureDiagram

Houston is a distrubuted system that is deployed as a series of AWS resources within a customer's account. Almost all of the resources that Gruntwork Houston uses are fully managed and have generous "free tiers" so it is likely it will cost very little to run Gruntwork Houston within your account. These resources include:

When deploying Gruntwork Houston, you will pick a domain name for it, so you can access it at a URL such as houston.your-company.com.

Setup Instructions

See our dedicated docs on Setting up Gruntwork Houston.

Using the CLI

See our dedicated docs on Using the CLI

Self-Service Instructions

See our dedicated docs on Using Gruntwork Houston Self-Service.

License

Please see LICENSE.txt for details on how the code in this repo is licensed.

Questions? Ask away.

We're here to talk about our services, answer any questions, give advice, or just to chat.

Ready to hand off the Gruntwork?