Skip to content

Commit 1e2a6be

Browse files
committed
elaborate further on experiments and cgo
1 parent 16ae079 commit 1e2a6be

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

BUILDING.md

+7-1
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,14 @@ Experimental features of Terraform will be disabled unless `main.experimentsAllo
2929
go build -ldflags "-w -s -X 'main.experimentsAllowed=yes'" -o bin/ .
3030
```
3131

32+
In the official build process for Terraform, experiments are only allowed in alpha release builds. We recommend that third-party distributors follow that convention in order to reduce user confusion.
33+
3234
## Go Options
3335

34-
The Terraform release process uses the Go toolchain defaults for the current operating system and processor architecture.
36+
For the most part, the Terraform release process relies on the Go toolchain defaults for the target operating system and processor architecture.
37+
38+
### `CGO_ENABLED`
39+
40+
One exception is the `CGO_ENABLED` option, which is set explicitly when building Terraform binaries. For most platforms, we build with `CGO_ENABLED=0` in order to produce a statically linked binary. For MacOS/Darwin operating systems, we build with `CGO_ENABLED=1` to avoid a platform-specific issue with DNS resolution.
3541

3642

0 commit comments

Comments
 (0)