mirror of https://github.com/knative/docs.git
2.8 KiB
2.8 KiB
The Knative CLI (kn
) provides a quick and easy interface for creating Knative resources, such as Knative Services and Event Sources, without the need to create or modify YAML files directly.
The kn
CLI also simplifies completion of otherwise complex procedures such as autoscaling and traffic splitting.
=== "Using Homebrew"
Do one of the following:
- To install `kn` by using [Homebrew](https://brew.sh){target=_blank}, run the command:
```bash
brew install kn
```
- To upgrade an existing `kn` install to the latest version, run the command:
```bash
brew upgrade kn
```
??? bug "Having issues upgrading `kn` using Homebrew?"
If you are having issues upgrading using Homebrew, it might be due to a change to a CLI repository where the `master` branch was renamed to `main`. Resolve this issue by running the command:
```bash
brew tap --repair
brew update
brew upgrade kn
```
=== "Using a binary"
You can install `kn` by downloading the executable binary for your system and placing it in the system path. Note that you will need `kn` v0.25 or later.
1. Download the binary for your system from the [`kn` release page](https://github.com/knative/client/releases){target=_blank}.
1. Rename the binary to `kn` and make it executable by running the commands:
```bash
mv <path-to-binary-file> kn
chmod +x kn
```
Where `<path-to-binary-file>` is the path to the binary file you downloaded in the previous step, for example, `kn-darwin-amd64` or `kn-linux-amd64`.
1. Move the executable binary file to a directory on your PATH by running the command:
```bash
mv kn /usr/local/bin
```
1. Verify that the plugin is working by running the command:
```bash
kn version
```
=== "Using Go"
1. Check out the `kn` client repository:
```bash
git clone https://github.com/knative/client.git
cd client/
```
1. Build an executable binary:
```bash
hack/build.sh -f
```
1. Move `kn` into your system path, and verify that `kn` commands are working properly. For example:
```bash
kn version
```
=== "Using a container image"
Links to images are available here:
- [Latest release](https://gcr.io/knative-releases/knative.dev/client/cmd/kn){target=_blank}
You can run `kn` from a container image. For example:
```bash
docker run --rm -v "$HOME/.kube/config:/root/.kube/config" gcr.io/knative-releases/knative.dev/client/cmd/kn:latest service list
```
!!! note
Running `kn` from a container image does not place the binary on a permanent path. This procedure must be repeated each time you want to use `kn`.