From 441043a22a59d34b34cbdcdf8dc2437c552ef5c8 Mon Sep 17 00:00:00 2001
From: Justin Santa Barbara <justin@fathomdb.com>
Date: Wed, 19 Oct 2016 13:08:21 -0400
Subject: [PATCH] Instructions for how to download kubectl

---
 _data/guides.yml                       |  2 +
 docs/getting-started-guides/kubectl.md | 63 ++++++++++++++++++++++++++
 2 files changed, 65 insertions(+)
 create mode 100644 docs/getting-started-guides/kubectl.md

diff --git a/_data/guides.yml b/_data/guides.yml
index 40d47b08d6..e77e8e1b01 100644
--- a/_data/guides.yml
+++ b/_data/guides.yml
@@ -12,6 +12,8 @@ toc:
     path: /docs/getting-started-guides/kubeadm/
   - title: Hello World on Google Container Engine
     path: /docs/hellonode/
+  - title: Downloading kubectl
+    path: /docs/getting-started-guides/kubectl/
   - title: Downloading or Building Kubernetes
     path: /docs/getting-started-guides/binary_release/
   - title: Online Training Course
diff --git a/docs/getting-started-guides/kubectl.md b/docs/getting-started-guides/kubectl.md
new file mode 100644
index 0000000000..6c5043e744
--- /dev/null
+++ b/docs/getting-started-guides/kubectl.md
@@ -0,0 +1,63 @@
+---
+---
+
+<style>
+li>.highlighter-rouge {position:relative; top:3px;}
+</style>
+
+## Overview
+
+kubectl is the command line tool you will use when interacting with kubernetes.
+
+You should use a version of kubectl that is newer than your server.  `kubectl version` will print
+the server and client versions.
+
+## Download a release
+
+Download kubectl from the [official Kubernetes releases](https://console.cloud.google.com/storage/browser/kubernetes-release/release/):
+
+On MacOS:
+
+```
+wget https://storage.googleapis.com/kubernetes-release/release/v1.4.3/bin/darwin/amd64/kubectl
+chmod +x kubectl
+mv kubectl /usr/local/bin/kubectl
+```
+
+On Linux:
+
+```
+wget https://storage.googleapis.com/kubernetes-release/release/v1.4.3/bin/linux/amd64/kubectl
+chmod +x kubectl
+mv kubectl /usr/local/bin/kubectl
+```
+
+
+You may need to `sudo` the `mv`; you can put it anywhere in your `PATH` - some people prefer to install to `~/bin`.
+
+
+## Alternatives
+
+### Download as part of the Google Cloud SDK
+
+kubectl can be installed as part of the Google Cloud SDK:
+
+First install the [Google Cloud SDK](https://cloud.google.com/sdk/).
+
+After Google Cloud SDK installs, run the following command to install `kubectl`:
+
+```shell
+gcloud components install kubectl
+```
+
+Do check that the version is sufficiently up-to-date using `kubectl version --client`. 
+
+### Install with brew
+
+If you are on MacOS and using brew, you can install with:
+
+```shell
+brew install kubectl
+```
+
+Do check that the version is sufficiently up-to-date using `kubectl version --client`.