Key Concepts of Kubernetes explained the basic fundamentals of Kubernetes. Binary distributions of Kubernetes on Linux can be downloaded from Continuous Integration builds. But it needs to manually built on other platforms, for example Mac. Building Kubernetes on Mac is straightforward as long as you know the steps.

This Tech Tip explains how to build Kubernetes on Mac.

Lets get started!

1. Kubernetes is written using Go programming language. So you’ll need to download the tools/compilers to build Kubernetes.Install Go (golang.org/doc/install). For example Go 1.4 package for 64-bit Mac OS X can be downloaded from storage.googleapis.com/golang/go1.4.darwin-amd64-osx10.8.pkg.
2. Configure Go. GOROOT is directory of Go installation is done and contains compiler/tools. GOPATH is directory for your Go projects / 3rd party libraries (downloaded with “go get”).Setup environment variables GOPATH and GOROOT. For example, on my environment they are:
   
   ~> echo $GOPATH /Users/arungupta/workspaces ~> echo $GOROOT /usr/local/go

   1 2 3 4 5 6

   ~> echo $GOPATH /Users/arungupta/workspaces          ~> echo $GOROOT          /usr/local/go

   Make sure $GOROOT/bin is in $PATH.
3. Install Gnutar:
   
   > brew install gnu-tar ==> Downloading https://downloads.sf.net/project/machomebrew/Bottles/gnu-tar-1.28.yosemite.bottle.2.tar.gz Already downloaded: /Library/Caches/Homebrew/gnu-tar-1.28.yosemite.bottle.2.tar.gz ==> Pouring gnu-tar-1.28.yosemite.bottle.2.tar.gz ==> Caveats gnu-tar has been installed as "gtar". If you really need to use it as "tar", you can add a "gnubin" directory to your PATH from your bashrc like: PATH="/usr/local/opt/gnu-tar/libexec/gnubin:$PATH" ==> Summary /usr/local/Cellar/gnu-tar/1.28: 13 files, 1.6M

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

   > brew install gnu-tar ==> Downloading https://downloads.sf.net/project/machomebrew/Bottles/gnu-tar-1.28.yosemite.bottle.2.tar.gz Already downloaded: /Library/Caches/Homebrew/gnu-tar-1.28.yosemite.bottle.2.tar.gz ==> Pouring gnu-tar-1.28.yosemite.bottle.2.tar.gz ==> Caveats gnu-tar has been installed as "gtar".   If you really need to use it as "tar", you can add a "gnubin" directory to your PATH from your bashrc like:       PATH="/usr/local/opt/gnu-tar/libexec/gnubin:$PATH" ==> Summary   /usr/local/Cellar/gnu-tar/1.28: 13 files, 1.6M

   Without this, the following message will be shown:
   
   +++ Output directory is local. No need to copy results out. +++ Building tarball: client darwin-386 !!! GNU tar not available. User names will be embedded in output and release tars are not official. Build on Linux or install GNU tar on Mac OS X (brew install gnu-tar)

   1 2 3 4 5 6 7

   +++ Output directory is local.  No need to copy results out. +++ Building tarball: client darwin-386   !!! GNU tar not available.  User names will be embedded in output and       release tars are not official. Build on Linux or install GNU tar       on Mac OS X (brew install gnu-tar)

4. Tech Tip #39 shows how to get stared with Docker on Mac using boot2docker. Download boot2docker for Mac from github.com/boot2docker/osx-installer/releases and install.
5. Git clone Kubernetes repo:
   
   workspaces> git clone https://github.com/GoogleCloudPlatform/kubernetes.git Cloning into 'kubernetes'... remote: Counting objects: 36775, done. remote: Compressing objects: 100% (39/39), done. remote: Total 36775 (delta 11), reused 10 (delta 2) Receiving objects: 100% (36775/36775), 23.52 MiB | 1.72 MiB/s, done. Resolving deltas: 100% (24015/24015), done. Checking connectivity... done.

   1 2 3 4 5 6 7 8 9 10

   workspaces> git clone https://github.com/GoogleCloudPlatform/kubernetes.git Cloning into 'kubernetes'... remote: Counting objects: 36775, done. remote: Compressing objects: 100% (39/39), done. remote: Total 36775 (delta 11), reused 10 (delta 2) Receiving objects: 100% (36775/36775), 23.52 MiB | 1.72 MiB/s, done. Resolving deltas: 100% (24015/24015), done. Checking connectivity... done.

6. Build it. This needs to be done from within the boot2docker VM.
   
   kubernetes> ./build/release.sh +++ Verifying Prerequisites.... +++ Setting boot2docker clock +++ Building Docker image kube-build:cross. +++ Building Docker image kube-build:build-67d37. +++ Running build command.... +++ Building go targets for linux/amd64: cmd/kube-proxy cmd/kube-apiserver cmd/kube-controller-manager cmd/kubelet plugin/cmd/kube-scheduler . . . +++ Integration test cleanup complete +++ Integration test cleanup complete +++ Running build command.... +++ Output directory is local. No need to copy results out. +++ Building tarball: client darwin-386 +++ Building tarball: client darwin-amd64 +++ Building tarball: client linux-386 +++ Building tarball: client linux-amd64 +++ Building tarball: client linux-arm +++ Building tarball: client windows-amd64 +++ Building tarball: server linux-amd64 +++ Building tarball: salt +++ Building tarball: test +++ Building tarball: full

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

   kubernetes> ./build/release.sh +++ Verifying Prerequisites.... +++ Setting boot2docker clock +++ Building Docker image kube-build:cross. +++ Building Docker image kube-build:build-67d37. +++ Running build command.... +++ Building go targets for linux/amd64:     cmd/kube-proxy     cmd/kube-apiserver     cmd/kube-controller-manager     cmd/kubelet     plugin/cmd/kube-scheduler   . . .   +++ Integration test cleanup complete +++ Integration test cleanup complete +++ Running build command.... +++ Output directory is local.  No need to copy results out. +++ Building tarball: client darwin-386 +++ Building tarball: client darwin-amd64 +++ Building tarball: client linux-386 +++ Building tarball: client linux-amd64 +++ Building tarball: client linux-arm +++ Building tarball: client windows-amd64 +++ Building tarball: server linux-amd64 +++ Building tarball: salt +++ Building tarball: test +++ Building tarball: full

Enjoy!

Subsequent blogs will show how to run a Kubernetes cluster of WildFly containers. WildFly will have a Java EE 7 application deployed and persist data to MySQL containers.