mirror of https://github.com/istio/istio.io.git
118 lines
4.4 KiB
Markdown
118 lines
4.4 KiB
Markdown
---
|
|
title: Downloading the Release
|
|
linktitle: Download
|
|
description: Download the Istio release and prepare for installation.
|
|
weight: 15
|
|
aliases:
|
|
- /docs/setup/kubernetes/download-release/
|
|
keywords: [kubernetes]
|
|
---
|
|
|
|
## Download and prepare for the installation
|
|
|
|
Istio is installed in its own `istio-system` namespace and can manage
|
|
services from all other namespaces.
|
|
|
|
1. Go to the [Istio release](https://github.com/istio/istio/releases) page to
|
|
download the installation file corresponding to your OS. On a macOS or
|
|
Linux system, you can run the following command to download and
|
|
extract the latest release automatically:
|
|
|
|
{{< text bash >}}
|
|
$ curl -L https://git.io/getLatestIstio | ISTIO_VERSION={{< istio_full_version >}} sh -
|
|
{{< /text >}}
|
|
|
|
1. Move to the Istio package directory. For example, if the package is
|
|
`istio-{{< istio_full_version >}}`:
|
|
|
|
{{< text bash >}}
|
|
$ cd istio-{{< istio_full_version >}}
|
|
{{< /text >}}
|
|
|
|
The installation directory contains:
|
|
|
|
* Installation YAML files for Kubernetes in `install/`
|
|
* Sample applications in `samples/`
|
|
* The `istioctl` client binary in the `bin/` directory. `istioctl` is
|
|
used when manually injecting Envoy as a sidecar proxy.
|
|
* The `istio.VERSION` configuration file
|
|
|
|
1. Add the `istioctl` client to your `PATH` environment variable, on a macOS or
|
|
Linux system:
|
|
|
|
{{< text bash >}}
|
|
$ export PATH=$PWD/bin:$PATH
|
|
{{< /text >}}
|
|
|
|
## Helm Chart Release Repositories
|
|
|
|
To use the Istio release Helm chart repository, add the Istio release repository as follows:
|
|
|
|
{{< text bash >}}
|
|
$ helm repo add istio.io https://storage.googleapis.com/istio-release/releases/{{< istio_full_version >}}/charts/
|
|
{{< /text >}}
|
|
|
|
## `istioctl` tab completion
|
|
|
|
If you are using Bash or ZSH, `istioctl` includes a helpful script that enables tab completion for the currently available `istioctl` commands.
|
|
|
|
### Installing the `istioctl` tab completion file
|
|
|
|
If you are using Bash, the `istioctl` tab completion file is located in the `tools` directory. To use it, copy the `istioctl.bash` file to your home directory, then add the following line to source the `istioctl` tab completion file from your `.bashrc` file:
|
|
|
|
{{< text bash >}}
|
|
$ source ~/istioctl.bash
|
|
{{< /text >}}
|
|
|
|
For ZSH users, an additional `istioctl` tab completion file is also located in the `tools` directory. In a similar fashion, you can copy the `_istioctl` file to your home directory, then source the `istioctl` tab completion file as follows:
|
|
|
|
{{< text zsh >}}
|
|
$ source < _istioctl
|
|
{{< /text >}}
|
|
|
|
{{< tip >}}
|
|
If you get an error like `complete:13: command not found: compdef`, then add the following to the beginning of your `~/.zshrc` file:
|
|
|
|
{{< text bash >}}
|
|
$ autoload -Uz compinit
|
|
$ compinit
|
|
{{< /text >}}
|
|
|
|
{{< /tip >}}
|
|
|
|
You may also add the `_istioctl` file to a directory listed in the `FPATH` variable. To achieve this, place the `_istioctl` file in an existing directory in the `FPATH`, or create a new directory and add it to the `FPATH` variable in your `~/.zshrc` file.
|
|
|
|
### Prerequisites for macOS
|
|
|
|
If you are using macOS with the Bash shell, make sure that the `bash-completion` package is installed. If you are using the [brew](https://brew.sh) package manager for macOS, you can check to see if the `bash-completion` package is installed with the following command:
|
|
|
|
{{< text bash >}}
|
|
$ brew info bash-completion
|
|
bash-completion: stable 1.3 (bottled)
|
|
{{< /text >}}
|
|
|
|
If the bash-completion package is _not_ installed, proceed with installing the bash-completion package with the following command:
|
|
|
|
{{< text bash >}}
|
|
$ brew install bash-completion
|
|
{{< /text >}}
|
|
|
|
{{< tip >}}
|
|
Once the bash-completion package has been installed on your macOS system, also make sure to add the following line to your `~/.bash_profile` file:
|
|
|
|
`[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"`
|
|
{{< /tip >}}
|
|
|
|
### Prerequisites for Linux
|
|
|
|
For Linux, to install the bash completion package, you would use the `apt-get install bash-completion` command for Debian-based Linux distributions or `yum install bash-completion` for RPM-based Linux distributions, the two most common occurrences.
|
|
|
|
## Using `istioctl` auto-completion
|
|
|
|
If the `istioctl` completion file has been installed correctly, press the Tab key while writing an `istioctl` command, and it should return a set of command suggestions for you to choose from:
|
|
|
|
{{< text bash >}}
|
|
$ istioctl proxy-<TAB>
|
|
proxy-config proxy-status
|
|
{{< /text >}}
|