diff --git a/docs/tasks/tools/install-kubectl.md b/docs/tasks/tools/install-kubectl.md index 4ddd498566..7932339725 100644 --- a/docs/tasks/tools/install-kubectl.md +++ b/docs/tasks/tools/install-kubectl.md @@ -7,14 +7,14 @@ redirect_from: - "/docs/tasks/kubectl/install/" - "/docs/tasks/kubectl/install.html" - "/docs/user-guide/prereqs/" -- "/docs/user-guide/prereqs.html" +- "/docs/user-guide/prereqs.html" --- {% capture overview %} Use the Kubernetes command-line tool, [kubectl](/docs/user-guide/kubectl), to deploy and manage applications on Kubernetes. Using kubectl, you can inspect cluster resources; create, delete, and update components; and look at your new cluster and bring up example apps. {% endcapture %} {% capture prerequisites %} -Use a version of kubectl that is the same version as your server or later. Using an older kubectl with a newer server might produce validation errors. +Use a version of kubectl that is the same version as your server or later. Using an older kubectl with a newer server might produce validation errors. {% endcapture %} Here are a few methods to install kubectl. @@ -26,7 +26,7 @@ Here are a few methods to install kubectl. curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl - To download a specific version, replace the `$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)` portion of the command with the specific version. + To download a specific version, replace the `$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)` portion of the command with the specific version. For example, to download version {{page.fullversion}} on MacOS, type: @@ -38,7 +38,7 @@ Here are a few methods to install kubectl. chmod +x ./kubectl ``` -3. Move the binary in to your PATH. +3. Move the binary in to your PATH. ``` sudo mv ./kubectl /usr/local/bin/kubectl @@ -50,9 +50,9 @@ Here are a few methods to install kubectl. curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl - To download a specific version, replace the `$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)` portion of the command with the specific version. + To download a specific version, replace the `$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)` portion of the command with the specific version. - For example, to download version {{page.fullversion}} on Linux, type: + For example, to download version {{page.fullversion}} on Linux, type: curl -LO https://storage.googleapis.com/kubernetes-release/release/{{page.fullversion}}/bin/linux/amd64/kubectl @@ -62,7 +62,7 @@ Here are a few methods to install kubectl. chmod +x ./kubectl ``` -3. Move the binary in to your PATH. +3. Move the binary in to your PATH. ``` sudo mv ./kubectl /usr/local/bin/kubectl @@ -97,7 +97,7 @@ kubectl can be installed as part of the Google Cloud SDK. gcloud components install kubectl ``` 3. Run `kubectl version` to verify that the verison you've installed is sufficiently up-to-date. - + ## Install with Homebrew on macOS 1. If you are on macOS and using [Homebrew](https://brew.sh/) package manager, you can install with: @@ -117,7 +117,7 @@ Check that kubectl is properly configured by getting the cluster state: ```shell $ kubectl cluster-info ``` -If you see a URL response, kubectl is correctly configured to access your cluster. +If you see a URL response, kubectl is correctly configured to access your cluster. If you see a message similar to the following, kubectl is not correctly configured: ```shell @@ -142,28 +142,29 @@ echo "source <(kubectl completion bash)" >> ~/.bashrc ``` ### On macOS, using bash -On macOS, autocompletion works if you install using `brew install kubectl`, -and not if you downloaded kubectl directly. - -Install the bash-completion support: +On macOS, you will need to install bash-completion support via [Homebrew](https://brew.sh/) first: ```shell +## If running Bash 3.2 included with macOS brew install bash-completion +## or, if running Bash 4.1+ +bash install bash-completion@2 ``` -To add kubectl autocompletion to your current shell, run: +Follow the "caveats" section of brew's output to add the appropriate bash completion path to your local .bashrc. -```shell -source $(brew --prefix)/etc/bash_completion -source <(kubectl completion bash) -``` +If you've installed kubectl using the [Homebrew instructions](#install-with-homebrew-on-macos) then kubectl completion should start working immediately. + +If you have installed kubectl manually, then run: `source <(kubectl completion bash)` To add kubectl autocompletion to your profile (so it is automatically loaded in future shells): ```shell -echo "source $(brew --prefix)/etc/bash_completion" >> ~/.bash_profile echo "source <(kubectl completion bash)" >> ~/.bash_profile ``` + +The Homebrew project is independent from kubernetes, so the bash-completion packages are not guaranteed to work. + {% endcapture %} {% capture whatsnext %} [Learn how to launch and expose your application.](/docs/user-guide/quick-start)