Command Reference

Categories and Command Structure

Meshery CLI commands are categorized by function, which are:

  • mesheryctl - Global flags and CLI configuration
  • mesheryctl system - Meshery Lifecycle and Troubleshooting
  • mesheryctl mesh - Service Mesh Lifecycle & Configuration Management: provisioning and configuration best practices
  • mesheryctl perf - Service Mesh Performance Management: Workload and service mesh performance characterization
  • mesheryctl pattern - Service Mesh Pattern Configuration & Management: Service mesh patterns and Open Application Model integration
  • mesheryctl filter - Data Plane Intelligence: Registry and configuration of WebAssembly filters for Envoy (Coming soon!)

Global Commands and Flags

Command Subcommand Flag Function
mesheryctl Displays help about any command.
version Displays the version of the Meshery Client (mesheryctl) and the SHA of the release binary.
--config configures Meshery with the kubeconfig, generated with the help of user details, to provide cluster access for public clouds(GKE/EKS).
--verbose, -v Sets the log level to debug for verbose output and displays verboose/debug logs.
--help, -h Displays helpful information about any command.

Meshery Lifecycle Management and Troubleshooting

Installation, troubleshooting and debugging of Meshery and its adapters.

Main Command Arguments Flag Function
system Lifecycle management of Meshery deployments
--context, -c Temporarily change the current context.
start Start Meshery.
--reset Reset Meshery’s configuration file to default settings.
--silent Silently create Meshery's configuration file with default settings.
--skip-update (optional) skip checking for new updates available in Meshery.
stop Stop all Meshery containers.
--reset Reset Meshery’s configuration file to default settings.
completion Output shell completion code.
update Pull new Meshery images from Docker Hub. Does not update `mesheryctl`. This command may be executed while Meshery is running.
--skip-reset Pull the latest manifest files
config Configures Meshery to use a Kubernetes cluster.
-t, --token string Path to token for authenticating to Meshery API.
reset Resets meshery.yaml file with a copy from Meshery repo
logs Starts tailing Meshery server debug logs
restart restart all Meshery containers, their instances and their connected volumes
--skip-update (optional) skip checking for new updates available in Meshery.
status Check status of Meshery, Meshery adapters, Meshery Operator and its controllers.
system channel Switch between release channels.
set set release channel and version.
switch switch release channel and version
view view release channel and version
--all, -a view release channel and version
system context Display the current context.
create create a new context in config.yaml file
--adapters create a new context in config.yaml file- specify the list of adapters to be added
--url, -u create a new context in config.yaml file- set Meshery server URL. Defaults to "https://localhost:9081"
--set, -s create a new context in config.yaml file- set as current context
delete delete an existing context from Meshery config file
view view the configurations of the current context
--context view the configurations of the specified context
--all if set, shows the configurations of all the contexts
switch configure mesheryctl to actively use one one context vs. the another context

Service Mesh Performance Management

Main Command Arguments Flag Function
perf Performance Management and Benchmarking using Meshery CLI.
--token (required) Path to Meshery user's access token.
--output-format, -o format to display in json or yaml.
apply Runs Performance test using existing profiles or using flags.
--load-generator Choice of load generator - fortio (OR) wrk2 (default: fortio).
--url (required/optional) URL of the endpoint send load to during testing.
--concurrent-requests Number of Parallel Requests (default: 1).
--profile (required/optional) Name for the new Performance Profile.
--name A memorable name for the test (default: random string).
--mesh Name of the service mesh.
--duration Length of the test.
--qps Queries per second (default: 0) (0 - means to use the CPU unbounded to generate as many requests as possible).
--file Path to service mesh performance test configuration file (default: empty string).
list Lists all the available performance profiles and results of a performance profile.
view Configuration of performance profile.

Service Mesh Lifecycle and Configuration Management

Main Command Command Flag Function
mesh Lifecycle management of service meshes
validate validate service mesh conformance to different standard specifications
--spec, -s (required) specification to be used for conformance test. Defaults to "smi"
--adapter, -a (required) adapter to use for validation. Defaults to "meshery-osm:10010"
--tokenpath, -t (required) path to token for authenticating to Meshery API
--namespace, -n Kubernetes namespace to be used for deploying the validation tests and sample workload

Service Mesh Pattern Configuration and Management

Main Command Command Flag Function
pattern
--file, -f (required) path to pattern file.
list displays a list of available pattern files
--all, -a show all pattern file metadata
apply apply pattern file will trigger deploy of the pattern file
--file, -f apply pattern file will trigger deploy of the pattern file and also supports file retrieval from GitHub
view displays the contents of a specific pattern file
--all, -a show all pattern file content
-o json display the content of a pattern in json format
delete Deprovision the resources/ service mesh using the pattern file
--file, -f Deletes the resources that were created, using pattern file