Skip to content

Commit

Permalink
Applied Technical Writer Edits to the Top Portion (#10001)
Browse files Browse the repository at this point in the history 
Edited the file with Technical Writer edits through the Install kubectl binary using curl section. Will finish more later.
  • Loading branch information
@JuleeB1 @k8s-ci-robot
JuleeB1 authored and k8s-ci-robot committed Aug 22, 2018
1 parent ab7a578 commit 7210c0e
Showing 1 changed file with 97 additions and 37 deletions.
134 changes: 97 additions & 37 deletions content/en/docs/tasks/tools/install-kubectl.md
View file
Expand Up @@ -8,11 +8,11 @@ weight: 10
---

{{% 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.
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; look at your new cluster; and bring up example apps.
{{% /capture %}}

{{% capture prerequisites %}}
You must use a kubectl version that is within one minor version difference with your cluster. For example, a v1.2 client should work with v1.1, v1.2, and v1.3 master. Using the latest version of kubectl helps avoid unforeseen issues.
You must use a kubectl version that is within one minor version difference of your cluster. For example, a v1.2 client should work with v1.1, v1.2, and v1.3 master. Using the latest version of kubectl helps avoid unforeseen issues.
{{% /capture %}}


Expand All @@ -22,7 +22,7 @@ You must use a kubectl version that is within one minor version difference with

Here are a few methods to install kubectl.

## Install kubectl binary via native package management
## Install kubectl binary using native package management

{{< tabs name="kubectl_install" >}}
{{< tab name="Ubuntu, Debian or HypriotOS" codelang="bash" >}}
Expand All @@ -49,75 +49,135 @@ yum install -y kubectl

## Install with snap on Ubuntu

kubectl is available as a [snap](https://snapcraft.io/) application.
If you are on Ubuntu or one of other Linux distributions that support [snap](https://snapcraft.io/docs/core/install) package manager, kubectl is available as a [snap](https://snapcraft.io/) application.

1. If you are on Ubuntu or one of other Linux distributions that support [snap](https://snapcraft.io/docs/core/install) package manager, you can install with:
1. Switch to the snap user and run the installation command:

sudo snap install kubectl --classic
```
sudo snap install kubectl --classic
```

2. Test to ensure the version you installed is sufficiently up-to-date:

2. Run `kubectl version` to verify that the version you've installed is sufficiently up-to-date.
```
kubectl version
```

## Install with Homebrew on macOS

1. If you are on macOS and using [Homebrew](https://brew.sh/) package manager, you can install with:
If you are on macOS and using [Homebrew](https://brew.sh/) package manager, you can install kubectl with Homebrew.

1. Run the installation command:

brew install kubernetes-cli
```
brew install kubernetes-cli
```

2. Test to ensure the version you installed is sufficiently up-to-date:

2. Run `kubectl version` to verify that the version you've installed is sufficiently up-to-date.
```
kubectl version
```

## Install with Macports on macOS

1. If you are on macOS and using [Macports](https://macports.org/) package manager, you can install with:
If you are on macOS and using [Macports](https://macports.org/) package manager, you can install kubectl with Macports.

port install kubectl
1. Run the installation command:

2. Run `kubectl version` to verify that the version you've installed is sufficiently up-to-date.
```
port install kubectl
```

2. Test to ensure the version you installed is sufficiently up-to-date:

```
kubectl version
```

## Install with Powershell from PSGallery

1. If you are on Windows and using [Powershell Gallery](https://www.powershellgallery.com/) package manager, you can install and update with:
If you are on Windows and using [Powershell Gallery](https://www.powershellgallery.com/) package manager, you can install and update kubectl with Powershell.

Install-Script -Name install-kubectl -Scope CurrentUser -Force
install-kubectl.ps1 [-DownloadLocation <path>]
To install:
* Run the installation commands (making sure to specify a DownloadLocation):

If no Downloadlocation is specified, kubectl will be installed in users temp Directory
2. The installer creates $HOME/.kube and instructs it to create a config file
3. Updating
re-run Install-Script to update the installer
re-run install-kubectl.ps1 to install latest binaries
```
Install-Script -Name install-kubectl -Scope CurrentUser -Force
install-kubectl.ps1 [-DownloadLocation <path>]
```

{{< note >}}
**Note:** If you do not specify a DownloadLocation, kubectl will be installed in the user's temp Directory.
{{< /note >}}
The installer creates $HOME/.kube and instructs it to create a config file
To update:
* Run the update commands:

```
re-run Install-Script to update the installer
re-run install-kubectl.ps1 to install latest binaries
```

## Install with Chocolatey on Windows

1. If you are on Windows and using [Chocolatey](https://chocolatey.org) package manager, you can install with:
If you are on Windows and using [Chocolatey](https://chocolatey.org) package manager, you can install kubectl with Chocolatey.

choco install kubernetes-cli
1. Run the installation command:

2. Run `kubectl version` to verify that the version you've installed is sufficiently up-to-date.
3. Configure kubectl to use a remote Kubernetes cluster:
```
choco install kubernetes-cli
```

2. Test to ensure the version you installed is sufficiently up-to-date:

cd C:\users\yourusername (Or wherever your %HOME% directory is)
mkdir .kube
cd .kube
New-Item config -type file
```
kubectl version
```
3. Change to your %HOME% directory:

For example: `cd C:\users\yourusername`

4. Create the .kube directory:

```
mkdir .kube
```

Edit the config file with a text editor of your choice, such as Notepad for example.
5. Change to the .kube directory you just created:

```
cd .kube
```

6. Configure kubectl to use a remote Kubernetes cluster:
New-Item config -type file
{{< note >}}
**Note:** Edit the config file with a text editor of your choice, such as Notepad.
{{< /note >}}

## Download as part of the Google Cloud SDK

kubectl can be installed as part of the Google Cloud SDK.
You can install kubectl as part of the Google Cloud SDK.

1. Install the [Google Cloud SDK](https://cloud.google.com/sdk/).
2. Run the following command to install `kubectl`:
2. Run the `kubectl` installation command:

gcloud components install kubectl
```
gcloud components install kubectl
```

3. Test to ensure the version you installed is sufficiently up-to-date:

3. Run `kubectl version` to verify that the version you've installed is sufficiently up-to-date.
```
kubectl version
```

## Install kubectl binary via curl
## Install kubectl binary using curl

{{< tabs name="kubectl_install_curl" >}}
{{% tab name="macOS" %}}
1. Download the latest release with the command:
1. Download the latest release:

```
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl
Expand Down Expand Up @@ -250,7 +310,7 @@ brew install bash-completion@2

Follow the "caveats" section of brew's output to add the appropriate bash completion path to your local .bashrc.

If you've installed kubectl using the [Homebrew instructions](#install-with-homebrew-on-macos) then kubectl completion should start working immediately.
If you installed kubectl using the [Homebrew instructions](#install-with-homebrew-on-macos) then kubectl completion should start working immediately.

If you have installed kubectl manually, you need to add kubectl autocompletion to the bash-completion:

Expand Down

0 comments on commit 7210c0e

Please sign in to comment.