<p style="text-align:center;" align="center"><a href="https://meshery.io"><picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/meshery-logo-light-text-side.svg"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/meshery-logo-dark-text-side.svg"> </picture></a> </p> <p align="center"> <a href="https://hub.docker.com/r/meshery/meshery" alt="Docker pulls"> </a> <a href="https://github.com/issues?q=is%3Aopen%20is%3Aissue%20archived%3Afalse%20(org%3Ameshery%20OR%20org%3Aservice-mesh-performance%20OR%20org%3Aservice-mesh-patterns%20OR%20org%3Ameshery-extensions)%20label%3A%22help%20wanted%22%20" alt="GitHub issues by-label"> </a> <a href="https://github.com/meshery/meshery/blob/master/LICENSE" alt="LICENSE"> </a> <a href="https://artifacthub.io/packages/helm/meshery/meshery" alt="Artifact Hub Meshery"> </a> <a href="https://goreportcard.com/report/github.com/meshery/meshery" alt="Go Report Card"> </a> <a href="https://github.com/meshery/meshery/actions" alt="Build Status"> </a> <a href="https://bestpractices.coreinfrastructure.org/projects/3564" alt="CLI Best Practices"> </a> <a href="https://www.bestpractices.dev/projects/3564" alt="OpenSSF Best Practices Baseline"></a> <a href="https://meshery.io/community#discussion-forums" alt="Discussion Forum"> </a> <a href="https://slack.meshery.io" alt="Join Slack"> </a> <a href="https://x.com/intent/follow?screen_name=mesheryio" alt="X Follow"> </a> <a href="https://github.com/meshery/meshery/releases" alt="Meshery Downloads"> </a> <a href="https://scorecard.dev/viewer/?uri=github.com/meshery/meshery" alt="OpenSSF Scorecard"> </a> <a href="https://trendshift.io/repositories/888" target="_blank"></a>  </p> <h5><p align="center"><i>If you like Meshery, please <a href="https://github.com/meshery/meshery/stargazers">★</a> this repository to show your support! 🤩</i></p></h5> <p align="center" > MESHERY IS A CLOUD NATIVE COMPUTING FOUNDATION PROJECT </p> <div align="center" width="100%"> </div> <p align="center"> A self-service engineering platform, <a href="https://meshery.io">Meshery</a>, is the open source, cloud native manager that enables the design and management of all Kubernetes-based infrastructure and applications (multi-cloud). As an extensible platform, Meshery offers visual and collaborative GitOps, freeing you from the chains of YAML while managing Kubernetes multi-cluster deployments. </p> <div align="center" width="100%"> <a href="https://www.youtube.com/watch?v=034nVaQUyME&list=PL3A-A6hPO2IO_yzN83wSJJUNQActzCJvO&index=9"></a>

Try Meshery in your browser using the <a href="https://play.meshery.io">Cloud Native Playground</a> (<a href="https://www.youtube.com/watch?v=034nVaQUyME&list=PL3A-A6hPO2IO_yzN83wSJJUNQActzCJvO&index=9">teaser video</a>)

</div> <p align="center"> <h4 align="center">Open Meshery extension, Kanvas, in your browser: https://kanvas.new</h4> </p>   <p style="clear:both;"> </p>

Functionality

Infrastructure Lifecycle Management

Meshery manages the configuration, deployment, and operation of your Cloud services and Kubernetes clusters while supporting hundreds of different types of cloud native infrastructure integrations. Meshery supports 300+ integrations.

</p>

Find infrastructure configuration patterns in Meshery's <a href="https://meshery.io/catalog">catalog of curated design templates</a> filled with configuration best practices.

Multiple Kubernetes Clusters and Multiple Clouds

Meshery provides a single pane of glass to manage multiple Kubernetes clusters across any infrastructure, including various cloud providers. Meshery enables consistent configuration, operation, and observability across your entire Kubernetes landscape.

<details><summary><h4>Dry-run your deployments</h4></summary> Meshery leverages Kubernetes' built-in dry-run capabilities to allow you to simulate deployments without actually applying the changes to your cluster. This enables you to:

Validate configurations: Ensure your deployment specifications (e.g., YAML manifests, Helm charts, Meshery Designs) are syntactically correct and will be accepted by the Kubernetes API server.
Identify potential issues: Detect errors in your configurations, such as invalid resource definitions, missing fields, or API version mismatches, before they impact your live environment.
Preview changes: Understand the objects that Kubernetes would create or modify during a real deployment.
Integrate with CI/CD: Incorporate dry-run as a step in your continuous integration and continuous delivery pipelines to automate pre-deployment checks and prevent faulty deployments.

By providing this dry-run functionality, Meshery helps you increase the reliability and stability of your Kubernetes deployments by catching potential problems early in the development and deployment process.

</details>

Visually and collaboratively manage your infrastructure

Using a GitOps-centric approach, visually and collaboratively design and manage your infrastructure and microservices. Meshery intelligently infers the manner in which each resource interrelates with each other. Meshery supports a broad variety of built-in relationships between components, which you can use to create your own custom relationships.

<details><summary><h4>Context-Aware Policies For Applications</h4></summary> <p>Leverage built-in relationships to enforce configuration best practices consistently from code to Kubernetes. Configure your infrastructure with confidence without needing to know or write Open Policy Agent's Rego query language.</p> </details>

Workspaces: Your team's Google Drive for cloud native projects

Workspaces let you organize your work and serve as the central point of collaboration for you and your teams and point of access control to Environments and their resources.

<details><summary><h4>Manage your connections with Environments</h4></summary> <p><a href="https://docs.meshery.io/concepts/logical/environments">Environments</a> make it easier for you to manage, share, and work with a collection of resources as a group, instead of dealing with all your Connections and Credentials on an individual basis.</p> </details> <details><summary><h4>See changes to your infra before you merge</h4></summary>

Get snapshots of your infrastructure directly in your PRs. Preview your deployment, view changes pull request-to-pull request and get infrastructure snapshots within your PRs by connecting Kanvas to your GitHub repositories.

</details>

Platform Engineering with Meshery's Extension Points

Extend Meshery as your self-service engineering platform by taking advantage of its vast set of extensibility features, including gRPC adapters, hot-loadable React packages and Golang plugins, subscriptions on NATS topics, and consumable and extendable API interfaces via REST and GraphQL. The great number of extension points in Meshery make it ideal as the foundation of your internal developer platform.

<details><summary><h4>Access the Cloud Native Patterns for Kubernetes</h4></summary> <p>Design and manage all of your cloud native infrastructure using the design configurator in Meshery or start from a template using the patterns from the <a href="https://meshery.io/catalog">catalog</a>. </details>

Meshery offers robust capabilities for managing multiple tenants within a shared Kubernetes infrastructure. Meshery provides the tools and integrations necessary to create a secure, isolated, and manageable multi-tenant environments, allowing multiple teams or organizations with granular control over their role-based access controls.

Meshery's "multi-player" functionality refers to its collaborative features that enable multiple users to interact with and manage cloud native infrastructure simultaneously. This is primarily facilitated through Kanvas, a Meshery extension visual designer and management interface.

Performance Management

Meshery offers load generation and performance characterization to help you assess and optimize the performance of your applications and infrastructure.

<p>Create and reuse performance profiles for consistent characterization of the configuration of your infrastructure in context of how it performs.</p> <details> <summary><h4> Manage the performance of your infrastructure and its workloads</h4></summary>

Baseline and track your cloud native performance from release to release.

Use performance profiles to track the historical performance of your workloads.
Track your application performance from version to version.
Understand behavioral differences between cloud native network functions.
Compare performance across infrastructure deployments.

</details> <details> <summary><h4>Load Generation and Microservice Performance Characterization</h4></summary> <picture align="left"> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/layer5io/layer5/master/src/assets/images/service-mesh-performance/stacked/smp-light-text.svg" width="18%" align="left" style="margin-left:10px;" /> </picture>

Multiple Load Generators: Meshery supports various load generators, including Fortio, Wrk2, and Nighthawk, allowing users to choose the tool that best suits your needs.
Configurable Performance Profiles: Meshery provides a highly configurable set of load profiles with tunable facets, enabling users to generate TCP, gRPC, and HTTP load. You can customize parameters such as duration, concurrent threads, concurrent generators, and load generator type.
Statistical Analysis: Meshery performs statistical analysis on the results of performance tests, presenting data in the form of histograms with latency buckets. Understand the distribution of response times and identify potential bottlenecks.
Comparison of Test Results: Meshery enables you to compare the difference in request performance (latency and throughput) between independent performance tests. Save your load test configurations as Performance Profiles, making it easy to rerun tests with the same settings and track performance variations over time.
Kubernetes Cluster and Workload Metrics: - Meshery connects to one or more Prometheus servers to gather both cluster and application metrics. Meshery also integrates with Grafana, allowing you to import your existing dashboards and visualize performance data.

<p>In an effort to produce infrastructure agnostic tooling, Meshery uses the <a href="https://smp-spec.io">Cloud Native Performance</a> specification as a common format to capture and measure your infrastructure's performance against a universal cloud native performance index. Meshery participates in advancing cloud native infrastructure adoption through the standardization of APIs. Meshery enables you to measure the value provided by Docker, Kubernetes, or other cloud native infrastructure in the context of the overhead incurred.</p>  </details> <h2><a name="running"></a>Get Started with Meshery</h2> <p style="clear:both;"></p>  <h3>Using `mesheryctl`</h3> <p>Meshery runs as a set of containers inside or outside of your Kubernetes clusters.</p> <pre>curl -L https://meshery.io/install | bash -</pre> <p>Use the <a href="https://docs.meshery.io/installation/quick-start">quick start</a> guide.</p> <details> <summary><strong>See all supported platforms</strong></summary>

See the getting started section to quickly deploy Meshery on any of these supported platforms:

Platform	Supported?
Docker	✔️
Docker - Docker App	✔️
Docker - Docker Extension	✔️
Kubernetes	✔️
Kubernetes - AKS	✔️
Kubernetes - Docker Desktop	✔️
Kubernetes - EKS	✔️
Kubernetes - GKE	✔️
Kubernetes - Helm	✔️
Kubernetes - kind	✔️
Kubernetes - Minikube	✔️
Kubernetes - OpenShift	✔️
Kubernetes - Rancher	✔️
Linux	✔️
Mac	✔️
Mac - Homebrew	✔️
Windows	✔️
Scoop	✔️
WSL2	✔️
Raspberry Pi	In Progress

Meshery documentation offers thorough installation guides for your platform of choice.

</details> <p style="clear:both;"> </p> <div> </div>

Join the Meshery community

<a name="contributing"></a><a name="community"></a> Our projects are community-built and welcome collaboration. 👍 Be sure to see the <a href="https://meshery.io/community">Contributor Journey Map</a> and <a href="https://meshery.io/community#handbook">Community Handbook</a> for a tour of resources available to you and the <a href="https://meshery.io/community/#handbook/repository-overview">Repository Overview</a> for a cursory description of repository by technology and programming language. Jump into community <a href="https://slack.meshery.io">Slack</a> or <a href="https://meshery.io/community#discussion-forums">discussion forum</a> to participate.

<p style="clear:both;"> <h3>Find your MeshMate</h3> <p>MeshMates are experienced Meshery community members, who will help you learn your way around, discover live projects, and expand your community network. Connect with a MeshMate today!</p>

Learn more about the <a href="https://meshery.io/community#meshmates">MeshMates</a> program.

</p> <div style="display: flex; justify-content: center; align-items:center;"> <div> <a href="https://meshery.io/community"></a> </div> <div style="width:60%; padding-left: 16px; padding-right: 16px"> <p> ✔️ <em><strong>Join</strong></em> any or all of the weekly meetings on <a href="https://meshery.io/calendar">community calendar</a>.

✔️ <em><strong>Watch</strong></em> community <a href="https://www.youtube.com/@mesheryio?sub_confirmation=1">meeting recordings</a>.

✔️ <em><strong>Fill-in</strong></em> a <a href="https://meshery.io/newcomers">member form</a> and gain access to community resources.

✔️ <em><strong>Discuss</strong></em> in the <a href="https://meshery.io/community#discussion-forums">community forum</a>.

✔️ <em><strong>Explore more</strong></em> in the <a href="https://meshery.io/community#handbook">community handbook</a>.

</p> </div> <div> <a href="https://slack.meshery.io"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/slack.svg" width="110px" /> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/slack.svg" width="110px" /> </picture> </a> </div> </div> <p align="left">      <i>Not sure where to start?</i> Grab an open issue with the <a href="https://github.com/issues?q=is%3Aopen%20is%3Aissue%20archived%3Afalse%20(org%3Ameshery%20OR%20org%3Aservice-mesh-performance%20OR%20org%3Aservice-mesh-patterns%20OR%20org%3Ameshery-extensions)%20label%3A%22help%20wanted%22%20">help-wanted label</a>. </p> <div> </div>

Contributing

Please do! We're a warm and welcoming community of open source contributors. Please join. All types of contributions are welcome. Be sure to read the Contributor Guides for a tour of resources available to you and how to get started.

Naming conventions. This repository adheres to the canonical camelCase-wire identifier-naming contract shared across the Meshery / Layer5 ecosystem. See the identifier-naming contributor guide in meshery/schemas for the full reader-friendly directory (26-row naming table with before/after and do/don't examples). Repo-specific mandates live in AGENTS.md § Identifier Naming Conventions.

<div> </div>

Stargazers

<p align="center"> <i>If you like Meshery, please <a href="../../stargazers">★</a> star this repository to show your support! 🤩</i> <a href="../../stargazers">

</a></p>

License

This repository and site are available as open-source under the terms of the Apache 2.0 License.

Software Bill of Materials (SBOM)

Meshery's Software Bill of Materials (SBOM) is available as a build artifact.

README