exec:go

Background

This is the builder for the local:exec runner. This builder produces binaries specific to the host system using the user's local Go installation. This is a faster-but-less-portable cousin of the docker:go builder. It supports the same replacement semantics as you expect but without the containerization.

Features

  • Produces system-specific binary executable. (i.e. ELF, PE32+, PEF)

  • Linkage with a custom sync service SDK via --link-sdk flag

  • Simple command-line dependency mapping using the --dep flag

Troubleshooting

Most build failures are caused by a problem with the plan code rather than the build process. Here are a few tips to help figure out what's going on when there are build failures.

  1. Try to build the plan yourself. These are just executable files after all! Frequently, build problems can be revealed by simply trying to run the plan as it is. If you can't build it like this, then the builder won't be able to either.

    cd <plan_directory>
    export GOMOD111MODULE=on go build .
  2. Make sure you have correctly initialized go.mod. The builder may throw errors when doing module replacements not used correctly.

  3. Remove any custom module replace lines you have in go.mod. The builder will do this for you with appropriate flags.

Learn More

Interested in how this works? All the Testground builders can be seen here‚Äč