Go to file
Mitchell Hashimoto 5c18a6a5fe Update TODO.md 2014-06-26 11:05:54 -07:00
builtin main: fix the help output to show up 2014-06-26 10:24:51 -07:00
command command/plan: refresh by default 2014-06-26 09:56:29 -07:00
config config: remove some unused test fixtures 2014-06-24 15:02:02 -07:00
depgraph depgraph: add Noun function to get a noun 2014-06-25 11:28:00 -07:00
digraph Import @armon's depgraph/digraph 2014-05-24 12:47:04 -07:00
helper helper/resource: destroy on requiresNew 2014-06-25 18:41:40 -07:00
plugin some comments, package comments 2014-05-28 21:27:10 -07:00
rpc rpc: add Refresh method 2014-06-20 11:51:07 -07:00
scripts scripts: unix line endings 2014-06-26 10:07:31 -07:00
terraform providers/aws: if no reservations, no instance 2014-06-26 09:58:38 -07:00
test-fixtures main: add main config 2014-05-25 17:39:44 -07:00
.gitignore Add the state to the gitignore 2014-06-19 14:09:03 -07:00
Makefile update README 2014-06-26 10:33:39 -07:00
README.md update readme 2014-06-26 10:34:49 -07:00
TODO.md Update TODO.md 2014-06-26 11:05:54 -07:00
commands.go command: plan 2014-06-20 11:47:02 -07:00
config.go main: instantiate the config and set it up 2014-06-09 21:57:37 -07:00
config_test.go main: instantiate the config and set it up 2014-06-09 21:57:37 -07:00
log.go Setup panicwrap 2014-05-30 16:07:26 -07:00
main.go main: fix the help output to show up 2014-06-26 10:24:51 -07:00
panic.go Setup panicwrap 2014-05-30 16:07:26 -07:00
version.go Implement CLI, version command 2014-05-24 12:04:43 -07:00

README.md

Terraform

Terraform is a tool for building and changing infrastructure safetly and efficiently.

Developing Terraform

If you wish to work on Terraform itself or any of its built-in providers, you'll first need Go installed (version 1.2+ is required). Make sure Go is properly installed, including setting up a GOPATH. Make sure Go is compiled with cgo support. You can verify this by running go env and checking that CGOENABLED is set to "1".

Next, install Git, which is needed for some dependencies.

Then, install Gox, which is used as a compilation tool on top of Go:

$ go get -u github.com/mitchellh/gox

Next, clone this repository into $GOPATH/src/github.com/hashicorp/terraform and then just type make. This will compile some dependencies and then run the tests. If this exits with exit status 0, then everything is working!

$ make
...

To compile a development version of Terraform and the built-in plugins, run make dev. This will put Terraform binaries in the bin folder:

$ make dev
...
$ bin/terraform
...

If you're developing a specific package, you can run tests for just that package by specifying the TEST variable. For example below, only terraform package tests will be run.

$ make test TEST=./terraform
...