consul/website/content/docs/k8s/upgrade/upgrade-cli.mdx

82 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
layout: docs
page_title: Update the Consul K8s CLI
description: >-
The Consul on Kubernetes CLI tool helps you schedule clusters without direct interaction with Helm or Consuls CLI. Learn how to update the consul-k8s CLI tool to a new version.
---
# Update the Consul K8s CLI
Consul K8s CLI is a tool for quickly installing and interacting with Consul on Kubernetes. Ensure that you are running the correct version of the CLI prior to upgrading your Consul on Kubernetes deployment, as the CLI and the control plane are version dependent.
## Upgrade the CLI
These instructions describe how to upgrade the current installed version of the CLI to the latest version. If you are looking to upgrade to a specific version, please follow [Install a specific version of the CLI](/consul/docs/k8s/installation/install-cli#install-a-specific-version-of-the-cli).
<Tabs>
<Tab heading="MacOS">
The [Homebrew](https://brew.sh) package manager is required to complete the following installation instructions. The `brew upgrade` command assumes that Hashicorp `tap` repository has already been installed from a prior install.
1. Upgrade the Consul K8s CLI with the latest `consul-k8s` package.
```shell-session
$ brew upgrade consul-k8s
```
1. (Optional) Issue the `consul-k8s version` command to verify the installation:
```shell-session
$ consul-k8s version
consul-k8s 0.39.0
```
</Tab>
<Tab heading="Linux - Ubuntu/Debian">
1. Upgrade all the available packages on your system.
```shell-session
$ sudo apt-get update
```
1. Upgrade the Consul K8s CLI with the latest `consul-k8s` package.
```shell-session
$ sudo apt-get --only-upgrade install consul-k8s
```
1. (Optional) Issue the `consul-k8s version` command to verify the installation:
```shell-session
$ consul-k8s version
consul-k8s 0.39.0
```
</Tab>
<Tab heading="Linux - CentOS/RHEL">
1. Upgrade all the available packages on your system.
```shell-session
$ sudo yum update
```
1. Upgrade the Consul K8s CLI with the latest `consul-k8s` package.
```shell-session
$ sudo yum update consul-k8s
```
1. (Optional) Issue the `consul-k8s version` command to verify the installation:
```shell-session
$ consul-k8s version
consul-k8s 0.39.0
```
</Tab>
</Tabs>