Upgrade Guide
Upgrading Meshery Server, Adapters, and UI
Various components of Meshery will need to be upgraded as new releases become available. Meshery is comprised of a number of components including a server, adapters, UI, and CLI. As an application, Meshery is a composition of different functional components.
Some of the components must be upgraded simultaneously, while others may be upgraded independently. The following table depicts components, their versions, and deployment units (deployment groups).
Versioning of Meshery components
Components | Sub-component | Considering or Updating |
---|---|---|
Meshery Adapters | Any and All Adapters | Docker Deployment: Watchtower updates this component in accordance with the userβs release channel subscription. |
Meshery Server | Meshery UI | Manages lifecycle of Meshery Operator; Adapters, UI, Load Generators, Database. Docker Deployment: Watchtower updates this component in accordance with the userβs release channel subscription. |
Load Generators | ||
Database | ||
Meshery Operator | MeshSync | Meshery Operator manages the lifecycle of this component and its sub-components. |
Meshery Broker | Meshery Operator manages the lifecycle of this event bus component. | |
`mesheryctl` | mesheryctl manages the lifecycle of Meshery Server.
|
|
Remote Providers | Meshery Cloud | Process Extension: Integrators manage the lifecycle of their Remote Providers. Process is unique per provider. |
Meshery Cloud | Static Extension: Integrators manage the lifecycle of their Meshery Extensions. Process is unique per provider. |
Sub-components deploy as a unit, however, they do not share the same version number.
Meshery Docker Deployments
In order to pull the latest images for Meshery Server, Adapters, and UI, execute the following command:
mesheryctl system update
If you wish to update a running Meshery deployment with the images you just pulled, youβll also have to execute:
mesheryctl system restart
Meshery Kubernetes Deployments
Use kubectl apply
or helm
to upgrade the Meshery application manifests in your Kubernetes cluster.
Upgrading Meshery CLI
The Meshery command line client, mesheryctl
, is available in different package managers. Use the instructions relevant to your environment.
Upgrading mesheryctl
using Homebrew
To upgrade `mesheryctl`, execute the following command:
brew upgrade mesheryctl
Upgrading mesheryctl
using Bash
Upgrade mesheryctl
and run Meshery on Mac or Linux with this script:
curl -L https://meshery.io/install | DEPLOY_MESHERY=false bash -
Upgrading mesheryctl
using Scoop
To upgrade mesheryctl
, execute the following command:
scoop update mesheryctl
Recent Discussions with "meshery" Tag
- Sep 05 | Which projects (github repos) are included in Layer5.io internships
- Apr 16 | Help needed for setup of meshery cli
- Aug 25 | Meshery UI local changes is not reflecting in localhost
- Jan 09 | I am facing following issue in my local setup
- Aug 14 | Meshery Development Meeting (Aug. 14th, 2024)
- Aug 11 | Meshery containers are not stopping properly
- Aug 04 | Unable to run Meshery locally
- Aug 04 | How to setup e2e testing environment with playwright and docker for Meshery
- Aug 09 | Help needed to setup Meshery locally
- Aug 07 | Trying to build server on meshery is failing
Suggested Reading
- Using Multiple Adapters - Meshery is capable of running zero or more adapters. Meshery offers many features without the need for adapters. Adapters are optional components that enhance and extend Meshery's core functionality.