2015-08-18 13:09:15 -05:00
|
|
|
# Building Terraform
|
2015-05-26 16:12:44 -05:00
|
|
|
|
2015-08-18 13:09:15 -05:00
|
|
|
This document contains details about the process for building binaries for
|
|
|
|
Terraform.
|
2015-05-26 16:12:44 -05:00
|
|
|
|
|
|
|
## Versioning
|
|
|
|
|
|
|
|
As a pre-1.0 project, we use the MINOR and PATCH versions as follows:
|
|
|
|
|
|
|
|
* a `MINOR` version increment indicates a release that may contain backwards
|
|
|
|
incompatible changes
|
|
|
|
* a `PATCH` version increment indicates a release that may contain bugfixes as
|
|
|
|
well as additive (backwards compatible) features and enhancements
|
|
|
|
|
|
|
|
## Process
|
|
|
|
|
2015-08-18 13:09:15 -05:00
|
|
|
If only need to build binaries for the platform you're running (Windows, Linux,
|
|
|
|
Mac OS X etc..), you can follow the instructions in the README for [Developing
|
|
|
|
Terraform][1].
|
|
|
|
|
|
|
|
The guide below outlines the steps HashiCorp takes to build the official release
|
|
|
|
binaries for Terraform. This process will generate a set of binaries for each supported
|
|
|
|
platform, using the [gox](https://github.com/mitchellh/gox) tool.
|
|
|
|
|
2015-05-26 16:12:44 -05:00
|
|
|
|
|
|
|
```sh
|
2015-08-18 13:09:15 -05:00
|
|
|
# clone the repository if needed
|
|
|
|
git clone https://github.com/hashicorp/terraform.git
|
|
|
|
cd terraform
|
|
|
|
|
2015-06-30 14:10:49 -05:00
|
|
|
# Verify unit tests pass
|
2015-05-26 16:12:44 -05:00
|
|
|
make test
|
|
|
|
|
2015-08-18 13:09:15 -05:00
|
|
|
# Build the release
|
|
|
|
# This generates binaries for each platform and places them in the pkg folder
|
2016-02-19 17:57:39 -06:00
|
|
|
make bin
|
2015-08-18 13:09:15 -05:00
|
|
|
```
|
|
|
|
|
2015-08-18 13:11:49 -05:00
|
|
|
After running these commands, you should have binaries for all supported
|
|
|
|
platforms in the `pkg` folder.
|
2015-08-18 13:09:15 -05:00
|
|
|
|
|
|
|
|
|
|
|
[1]: https://github.com/hashicorp/terraform#developing-terraform
|