Command Line 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 adapter - Lifecycle & Configuration Management: provisioning and configuration best practices
• mesheryctl perf - Performance Management: Workload and cloud native performance characterization
• mesheryctl design - Design Patterns: Cloud native patterns and best practices
• mesheryctl filter - Data Plane Intelligence: Registry and configuration of WebAssembly filters for Envoy
• mesheryctl model - A unit of packaging to define managed infrastructure and their relationships, and details specifics of how to manage them.
• mesheryctl component - Fundamental building block used to represent and define the infrastructure under management
• mesheryctl registry - Model Database: Manage the state and contents of Meshery’s internal registry of capabilities.
• mesheryctl environment - Logical group of connections and their associated credentials.
• mesheryctl connection - Managed or unmanaged resources that either through discovery or manual entry are tracked by Meshery.
• mesheryctl organization - Manage and interact with registered organizations.
• mesheryctl exp - Experimental features

Global Commands and Flags

Command	Subcommand	Flag	Function
mesheryctl			A global command that displays an overview of all commands.
	--config	configures Meshery with the meshconfig, generated with the help of user details to provide cluster access for public clouds(GKE/EKS).
	--help, -h	Displays helpful information about any command.
	--verbose, -v	Sets the log level to debug for verbose output and displays verbose/debug logs.
version		Displays the version of the Meshery Client (mesheryctl) and the SHA of the release binary.
completion		Output shell completion code for the specified shell.

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 override your current context by specifying an alternative context as an argument.
start		Start Meshery
--skip-update	(optional) skip checking for new updates available in Meshery.
--reset	Reset Meshery’s configuration file to default settings.
--skip-browser	(optional) skip opening of MesheryUI in browser.
--platform, -p	platform to deploy Meshery to.
stop		Stop Meshery
--reset	Reset Meshery’s configuration file to default settings.
--keep-namespace	(optional) keep the Meshery namespace during uninstallation
--force	(optional) uninstall Meshery resources forcefully
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.
--token	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
--follow, -f	(Optional) Follow the stream of the Meshery's logs. Defaults to false.
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.
--verbose, -v	(optional) Extra data in status table
dashboard		Open Meshery UI in browser.
--port-forward	(optional) Use port forwarding to access Meshery UI
--skip-browser	(optional) skip opening of MesheryUI in browser.
login		Authenticate with the Meshery Provider of your choice: the Local Provider or a Remote Provider.
--provider, -p	Login Meshery with specified provider
logout		Invalidate current session with your Meshery Provider.
check		Run system checks for both pre and post mesh deployment scenarios on Meshery
--preflight, --pre	Run Pre-mesh deployment checks (Docker and Kubernetes)
--adapter	Run checks on specific mesh adapter
--operator	Verify the health of Meshery Operator's deployment with MeshSync and Broker
--adapters	Check status of meshery adapters
--components	Check status of Meshery components
system channel			Switch between release channels.
set		Subscribe to 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
--components, -a	create a new context in config.yaml file- specify the list of adapters to be added
--set, -s	create a new context in config.yaml file- set as current context
--url, -u	create a new context in config.yaml file- set Meshery server URL. Defaults to "https://localhost:9081"
--platform, -p	Platform to deploy Meshery
delete		delete an existing context from Meshery config file
view		view the configurations of the current context
--context, -c	view the configurations of the specified context
--all	if set, shows the configurations of all the contexts
switch		Configure mesheryctl to switch between different contexts
list		List all contexts present
system provider			Enforce a provider. Choose between available Meshery providers
list		List available providers from meshconfig
reset		Reset provider for current context to default (Meshery)
switch		Switch provider of context in focus and redeploy Meshery
view		View current provider value
--all, -a	Show provider for all contexts
set		Set provider to desired value
--force	Force set the provider

Cloud Native Performance Management

Main Command	Arguments	Flag	Function
perf			Performance Management and Benchmarking using Meshery CLI
	--output-format, -o	format to display in json or yaml.
	--token	(required) Path to Meshery user's access token.
apply		Runs Performance test using existing profiles or using flags.
--concurrent-requests	Number of Parallel Requests (default: 1).
--duration	Length of the test.
--file	Path to cloud native performance test configuration file (default: empty string).
--load-generator	Choice of load generator - fortio (OR) wrk2 (default: fortio).
--mesh	Name of the system under test.
--name	A memorable name for the test (default: random string).
--qps	Queries per second (default: 0) (0 - means to use the CPU unbounded to generate as many requests as possible).
--url	(required/optional) URL of the endpoint send load to during testing.
--cert-path	(optional) Path to the certificate to be used for the load test
--disable-cert	(optional) Do not use certificate present in the profile
profile		List all the available performance profiles
--page, -p	(optional) List next set of performance profiles with --page (default = 1) (default 1).
--view	(optional) View more information of the performance profile.
result		View the results of a performance profile.
--page, -p	(optional) List next set of performance results with --page (default = 1) (default 1).
--view	(optional) View more information of the performance test results.

Cloud Native Lifecycle and Configuration Management

Main Command	Command	Flag	Function
adapter			Lifecycle management of cloud native infrastructure
validate		validate configuration conformance to different standard specifications
--adapter, -a	(required) adapter to use for validation. Defaults to "meshery-osm:10010"
--namespace, -n	Kubernetes namespace to be used for deploying the validation tests and sample workload
--spec, -s	(required) specification to be used for conformance test. Defaults to "smi"
--tokenpath, -t	(required) path to token for authenticating to Meshery API
remove		Remove infrastructure in the connected Kubernetes cluster
--namespace, -n	Kubernetes namespace from which to remove infrastructure
deploy		Deploy infrastructure into the cluster
--adapter, -a	(required) adapter to use for validation. Defaults to "meshery-osm:10010"
--namespace, -n	Kubernetes namespace to be used for deploying the validation tests and sample workload
--tokenpath, -t	(required) path to token for authenticating to Meshery API

Cloud Native Design Configuration and Management

Main Command	Command	Flag	Function
design			Manage cloud native infrastructure using predefined design patterns
	--file, -f	(required) path to design file.
apply		apply design file will trigger deploy of the design file
--file, -f	apply design file will trigger deploy of the design file and also supports file retrieval from GitHub
delete		Deprovision cloud native infrastructure using a design /design file
--file, -f	Deletes the resources that were created, using design file
list		Displays a list of available design files
--page, -p	list designs by specific page number (10 designs per page)
--verbose, -v	show all design file metadata
--pagesize	number of designs to be displayed per page (default 10)
--count, -c	display the total number of available designs
view		displays the contents of a specific design file
--all, -a	show all design file content
-o json	display the content of a design in json format
import		Import app manifests
--file, -f	Path/URL to app file
--source-type, -s	Type of source file (ex. manifest / compose / helm)
export		Export a design from Meshery
--type	Specify the design type to export (default current). Supported types are oci,current,original
--output, -o	Specify the output directory to save the design
offboard		Offboard application
--file, -f	Offboard application with an application file
onboard		Onboard application
--file, -f	Onboard application with application file
--skip-save	Skip saving an application
--source-type, -s	Type of source file (ex. manifest / compose / helm)

Data Plane Intelligence

Main Command	Command	Flag	Function
filter			Envoy Filter Management
import		Upload WASM filter file to Meshery Server
--name, -n	(optional) filter name
--wasm-config, -w	(optional) WASM configuration filepath/string
delete		Delete filter from Meshery Server
list		List all WASM filters
--verbose, -v	Display full length user and filter file identifiers
view		View the specified WASM filter
--all, -a	(optional) view all filters available
--output-format, -o	(optional) format to display in [json	yaml] (default "yaml")

Meshery Registry Management

Command	Subcommand	Flag	Function
registry			Manage the state and contents of Meshery's internal registry of capabilities.
	--help, -h	help for registry
publish		Publish Meshery Models to Websites, Remote Provider, Meshery Server
--output-format, -o	(optional) format to display in [md	mdx	js]
update		Update the registry with latest data.
--input, -i	(optional) path to capability file
--spreadsheet-cred	base64 encoded credential to download the spreadsheet
--spreadsheet-id	id of the spreadsheet to download
generate		Generate Models to the registry
--output-format, -o	(optional) format to display in [md	mdx	js]
--registrant-cred	path pointing to the registrant credential definition
--registrant-def	path pointing to the registrant connection definition
--spreadsheet-cred	base64 encoded credential to download the spreadsheet
--spreadsheet-id	id of the spreadsheet to download

Meshery Models

Command	Subcommand	Flag	Function
model			A unit of packaging to define managed infrastructure and their relationships, and details specifics of how to manage them.
	--count	(optional) Get the number of models in total
	--help, -h	help for model
build		Create an OCI-compliant package from the model files
--path, -p	(optional) looks for a model folder under specified path, defaults to current dir.
delete		Delete a registered model by ID
export		Export a model by name to the given output type (default is oci).
generate		Generate models by specifying the directory, file, or URL.
--file, -f	Specify the path to the file, directory, or URL.
--template, -t	Specify the path to the template JSON file (only required for URLs).
--register, -r	Skip model registration (default is true).
import		Import models using a file or filepath directly to the meshery registry
--file, -f	(optional) path to a single model file to import from local filesystem or URL to import from web location
init		Scaffold a folder structure for model creation
--output-format, -o	(optional) format to scaffold files to, supports json or yaml, planned to support csv, defaults to json.
--path, -p	(optional) generates a folder structure under specified path, defaults to current dir.
--version	(optional) model version, defaults to v0.1.0
list		List models present in the registry
--page, -p	list models by specific page number (25 models per page)
search		Using a keyword(s) search the registry for matching model(s)
view		View details of a specific model
-o, --output-format	(optional) format to display in [json	yaml] (default "yaml")

Meshery Components

Command	Subcommand	Flag	Function
component			Fundamental building block used to represent and define the infrastructure under management
	--count	(optional) Get the number of components in total
	--help, -h	help for components
list		List all components registered in Meshery Server
--page, -p	list components by specific page number (25 models per page)
search		Using a keyword(s) search the registry for matching component(s)
view		View details of a specific component
-o, --output-format	(optional) format to display in [json	yaml] (default "yaml")
--save	Save output as a JSON/YAML file

Meshery Environment

Command	Subcommand	Flag	Function
environment			Logical group related to connections and their credentials
create		create a new environments by providing the name and description of the environment
-d, --description	description of the specified environment
--name, -n	(optional) name of the environment
-o, --orgId	organization id
delete		delete a new environments by providing the name and description of the environment
list		list name of all registered environments
-o, --orgId	organization id
view		view a environments registered in Meshery Server
-o, --output-format	(optional) format to display in [json	yaml] (default "yaml")
-s, --save	(optional) save output as a JSON/YAML file

Meshery Connection

Command	Subcommand	Flag	Function
connection			Manage Meshery connections
	--help, -h	help for connection
	--count	(optional) Get the total number of connections
create		Create a new connection to a Kubernetes cluster or other supported platform
-t, --type	(required) type of connection to create (aks, eks, gke, minikube)
--token	(optional) Path to token for authenticating to Meshery API
delete		delete a connection
list		list all the connections
--count	(optional) Get the total number of connections
-k, --kind	(optional) Filter by kind (repeatable)
-p, --page	(optional) List a set of connection in specific page (default=1).
--pagesize	(optional) Number of connections per page (default=10).
-s, --status	(optional) Filter by status (repeatable)
view		view a connection queried by the connection id
-o, --output-format	(optional) format to display in [json	yaml] (default "yaml")
-s, --save	(optional) save output as a JSON/YAML file

Meshery Organization

Command	Subcommand	Flag	Function
organization			Interact with existing organizations
	--count	(optional) Get the total of registered organizations
	--help, -h	help for organization command
list		List all organizations registered in Meshery Server
--page, -p	list organizations by specific page number (25 models per page)
--count	(optional) Get the total of registered organizations

Experimental Features(exp)

Command	Subcommand	Flag	Function
relationship			View list of relationships and details of relationship
generate		generate relationships docs from the google spreadsheets
-s, --sheetId	google sheet id
list		list all relationships registered in Meshery Server
-p, --page	(optional) List next set of exp relationship list with --page (default = 1) (default 1).
view		view a relationship queried by the model name
-o, --output-format	(optional) format to display in [json	yaml] (default "yaml")
search		search for relationship using a query
-k --kind	kind of relationships
-m, --model	model name
-s, --subtype	subtype of relationships
-t, --type	type of relationships
workspace			View list of workspaces and detail of workspaces
create		create a new workspace by providing the name, description, and organization ID
-d, --description	description of the workspace
-n, --name	name of the workspace
-o, --orgId	organization id
list		list name of all registered workspaces
-o, -orgId	organization id

Frequently Asked Questions for Meshery CLI

Refer the following Frequently asked questions related to Meshery CLI.

Recent Discussions with "mesheryctl" Tag