Go to file
Mitchell Hashimoto e476bca29c Add tfplan to gitignore 2014-07-11 22:05:13 -07:00
builtin providers/aws: route table association tests 2014-07-11 13:10:09 -07:00
command command/refresh: better comment 2014-07-11 22:01:33 -07:00
config config: LoadDir with no matching files errors 2014-07-11 21:04:59 -07:00
depgraph terraform: turn multi-counts into multiple nodes 2014-07-03 20:42:29 -07:00
digraph digraph: fix flaky test 2014-07-02 11:30:09 -07:00
flatmap flatmap: deterministic tests 2014-07-10 13:32:16 -07:00
helper helper/diff: if attribute is set and also computed, don't mark computed 2014-07-11 11:46:21 -07:00
plugin plugin: Adding support for provisioners 2014-07-10 11:38:56 -07:00
rpc rpc: Cleanup imports 2014-07-10 11:38:57 -07:00
scripts scripts: unix line endings 2014-06-26 10:07:31 -07:00
terraform terraform: plan read/write sets magic bytes so we can test format 2014-07-11 21:43:24 -07:00
test-fixtures main: add main config 2014-05-25 17:39:44 -07:00
.gitignore Add tfplan to gitignore 2014-07-11 22:05:13 -07:00
Makefile testrace won't run acceptance tests 2014-07-10 13:33:57 -07:00
README.md update readme 2014-06-26 10:34:49 -07:00
TODO.md Update TODO 2014-07-09 18:52:41 -07:00
commands.go Compile 2014-07-03 12:01:20 -07:00
config.go Setup provisioners for CLI 2014-07-10 11:38:57 -07:00
config_test.go Update config test to handle provisioners 2014-07-10 11:38:57 -07:00
log.go Setup panicwrap 2014-05-30 16:07:26 -07:00
main.go Setup provisioners for CLI 2014-07-10 11:38:57 -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
...