Building from source

Installation from a binary is recommended for normal kops operation. However, if you want to build from source, it is straightforward:

If you don't have a GOPATH:

mkdir ~/kops
cd ~/kops
export GOPATH=`pwd`

Check out and build the code:

go get -d k8s.io/kops
cd ${GOPATH}/src/k8s.io/kops/
git checkout release
make
  • The release branch is where releases are taken from. This is the stable code branch.
  • The master branch should also be functional, but is where active development happens, so may be less stable.

Cross Compiling

Cross compiling for things like nodeup are now done automatically via make nodeup. make push-aws-run TARGET=admin@$TARGET will automatically choose the linux amd64 build from your .build directory.

Debugging

To enable interactive debugging, the kops binary needs to be specially compiled to include debugging symbols. Add DEBUGGING=true to the make invocation to set the compile flags appropriately.

For example, DEBUGGING=true make will produce a kops binary that can be interactively debugged.

Interactive debugging with Delve

Delve can be used to interactively debug the kops binary. After installing Delve, you can use it directly, or run it in headless mode for use with an Interactive Development Environment (IDE).

For example, run dlv --listen=:2345 --headless=true --api-version=2 exec ${GOPATH}/bin/kops -- <kops command>, and then configure your IDE to connect its debugger to port 2345 on localhost.

Troubleshooting

  • Make sure $GOPATH is set, and your workspace is configured.
  • kops will not compile with symlinks in $GOPATH. See issue go issue 17451 for more information
  • building kops requires go 1.12 or 1.13
  • Kops will only compile if the source is checked out in $GOPATH/src/k8s.io/kops. If you try to use $GOPATH/src/github.com/kubernetes/kops you will run into issues with package imports not working as expected.