Architecture

Components, their Purpose, and Languages

Meshery and its components are written using the following languages and technologies.

Components Languages and Technologies
Meshery Server Golang, gRPC, GraphQL, SMP
Meshery Adapters Golang, gRPC, CloudEvents, SMI, OAM
Meshery WASM Filters Rust and C++
Meshery UI ReactJS, NextJS, BillboardJS
Meshery Provider UI ReactJS, NextJS
Meshery Remote Providers any - must adhere to Meshery Extension Points
Meshery Operator Golang
     MeshSync Golang
     Broker Golang, NATS
Meshery Database Golang, SQLlite

Deployments

Meshery deploys as a set of containers. Meshery’s containers can be deployed to either Docker or Kubernetes. Meshery components connect to one another via gRPC requests. Meshery Server stores the location of the other components and connects with those components as needed. Typically, a connection from Meshery Server to Meshery Aapters is initiated from a client request (usually either mesheryctl or Meshery UI) to gather information from the Adapter or invoke an Adapter’s operation.

Adapters

In Meshery v0.6.0, Adapters will register with Meshery Server over HTTP POST. If Meshery Server is not available, Meshery Adapters will backoff and retry to connect to Meshery Server perpetually.

Meshery architecture

Figure: Meshery deploys inside or outside of a Kubernetes cluster

Adapters and Capabilities Registry

Each Meshery Adapter delivers its own unique service mesh-specific functionality. As such, at time of deployment, the Meshery Adapter will register its service mesh-specific capabilities (its operations) with Meshery Server’s capability registry.

Meshery Adapter Operation Registration

Figure: Service Mesh Adapter Operation Registration

Clients

Meshery’s REST API may be consumed by any number of clients. Clients need to present valid JWT token.

Client architecture

Figure: Clients use Meshery’s REST API, GraphQL API, or a combination of both.

Providers

As a point of extension, Meshery supports two types of providers: Local and Remote.

Provider architecture

Object Model

This diagram outlines logical constructs within Meshery and their relationships.

Object Model

Meshery Operator and MeshSync

Meshery Operator is the multi-service mesh operator (a Kubernetes custom controller) that manages MeshSync and it’s messaging broker.

Meshery Operator and MeshSync

See the Operator section for more information on the function of an operator and MeshSync section for more information on the function of meshsync.

Database

Meshery Server’s database is responsible for collecting and centralizing the state of all elements under management, including infrastructure, application, and Meshery’s own components. Meshery’s database, while persisted to file, is treated as a cache.

Meshery Database

See the Database section for more information on the function of the database.

Statefulness in Meshery components

Some components within Meshery’s architecture are concerned with persisting data while others are only concerned with a long-lived configuration, while others have no state at all.

Components Persistence Description
mesheryctl stateless command line interface that has a configuration file
Meshery Adapters stateless interface with service meshes on a transactional basis
Meshery Server caches state application cache is stored in $HOME/.meshery/ folder
Meshery Providers stateful location of persistent user preferences, environment, tests and so on
Meshery Operator stateless operator of Meshery custom controllers, notably MeshSync
MeshSync stateless Kubernetes custom controller, continuously running discovery

Network Ports

Meshery uses the following list of network ports to interface with its various components:

Component Port Purpose
Meshery Server 9081/tcp UI, REST and GraphQL APIs
Meshery Broker 4222/tcp Client communication with Meshery Server
Meshery Broker 8222/tcp HTTP management port for monitoring Meshery Broker. Available as of Meshery v0.5.0
Meshery Broker 6222/tcp Routing port for Broker clustering. Unused as of Meshery v0.6.0-rc-2
Meshery Broker 7422/tcp Incoming/outgoing leaf node connections. Unused as of Meshery v0.6.0-rc-2
Meshery Broker 7522/tcp Gateway to gateway communication. Unused as of Meshery v0.6.0-rc-2
Meshery Broker 7777/tcp used for Prometheus NATS Exporter. Unused as of Meshery v0.6.0-rc-2
Learn Layer5 Application 10011/tcp SMI conformance testing
Meshery Remote Providers 443/tcp e.g. Meshery Cloud
Meshery Adapter for App Mesh 10005/gRPC Communication with Meshery Server
Meshery Adapter for Cilium Service Mesh 10012/gRPC Communication with Meshery Server
Meshery Adapter for Consul 10002/gRPC Communication with Meshery Server
Meshery Adapter for Citrix Service Mesh 10008/gRPC Communication with Meshery Server
Meshery Adapter for Istio 10000/gRPC Communication with Meshery Server
Meshery Adapter for Kuma 10007/gRPC Communication with Meshery Server
Meshery Adapter for Linkerd 10001/gRPC Communication with Meshery Server
Meshery Adapter for NGINX Service Mesh 10010/gRPC Communication with Meshery Server
Meshery Adapter for Network Service Mesh 10004/gRPC Communication with Meshery Server
Meshery Adapter for Open Service Mesh 10009/gRPC Communication with Meshery Server
Meshery Adapter for Tanzu Service Mesh 10011/gRPC Communication with Meshery Server
Meshery Adapter for Traefik Mesh 10006/gRPC Communication with Meshery Server
Meshery Perf 10013/gRPC Performance Management

See the Adapters section for more information on the function of an adapter.