KO
|
EN
gitlite — search
Search
#python
#java
#python3
#arduino
#golang
#machine-learning
#rust
#html
#flask
#javascript
#seismology
#nodejs
meshery
★ 11,489
Open GitHub ↗
Meshery, the cloud native manager
Download README (.md)
Explore Similar Repositories
usehooks
:
A collection of modern, server-safe React hooks – from the ui.dev team
quickwit
:
Cloud-native OSS search engine for observability
jwt-auth
:
🔐 JSON Web Token Authentication for Laravel & Lumen
og-equity-compensation
:
Stock options, RSUs, taxes — read the latest edition: www.holloway.com/ec
FFmpeg-Builds
:
No description available.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
meshery
?
Download (.md)
<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"> <img src="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/meshery-logo-dark-text-side.svg" alt="Meshery Logo" width="70%" /></picture></a><br /><br /></p> <p align="center"> <a href="https://hub.docker.com/r/meshery/meshery" alt="Docker pulls"> <img src="https://img.shields.io/docker/pulls/meshery/meshery.svg" /></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"> <img src="https://img.shields.io/github/issues/meshery/meshery/help%20wanted.svg?color=informational" /></a> <a href="https://github.com/meshery/meshery/blob/master/LICENSE" alt="LICENSE"> <img src="https://img.shields.io/github/license/meshery/meshery?color=brightgreen" /></a> <a href="https://artifacthub.io/packages/helm/meshery/meshery" alt="Artifact Hub Meshery"> <img src="https://img.shields.io/endpoint?color=brightgreen&label=Helm%20Chart&style=plastic&url=https%3A%2F%2Fartifacthub.io%2Fbadge%2Frepository%2Fartifact-hub" /></a> <a href="https://github.com/meshery/meshery/actions" alt="Build Status"> <img src="https://img.shields.io/github/actions/workflow/status/meshery/meshery/release-drafter.yml" /></a> <a href="https://bestpractices.coreinfrastructure.org/projects/3564" alt="CLI Best Practices"> <img src="https://bestpractices.coreinfrastructure.org/projects/3564/badge" /></a> <a href="https://www.bestpractices.dev/projects/3564" alt="OpenSSF Best Practices Baseline"><img src="https://www.bestpractices.dev/projects/3564/baseline" alt="OpenSSF Best Practices Baseline" /></a> <!-- <a href="https://discuss.meshery.io/" alt="Discussion Forum"> <img src="https://img.shields.io/discourse/users?label=discuss&logo=discourse&server=https%3A%2F%2Fdiscuss.meshery.io" /></a> --> <a href="https://slack.meshery.io" alt="Join Slack"> <img src="https://img.shields.io/badge/Slack-@meshery.svg?logo=slack" /></a> <a href="https://bsky.app/profile/mesheryio.bsky.social" alt="Bluesky Follow"> <img src="https://img.shields.io/badge/Bluesky-@mesheryio-0285FF?logo=bluesky&logoColor=white" /> </a> <a href="https://x.com/intent/follow?screen_name=mesheryio" alt="X Follow"> <img src="https://img.shields.io/twitter/follow/mesheryio.svg?label=Follow+Meshery&style=social" /></a> <a href="https://github.com/meshery/meshery/releases" alt="Meshery Downloads"> <img src="https://img.shields.io/github/downloads/meshery/meshery/total" /></a> <a href="https://scorecard.dev/viewer/?uri=github.com/meshery/meshery" alt="OpenSSF Scorecard"> <img src="https://api.scorecard.dev/projects/github.com/meshery/meshery/badge" /></a> <br /> <a href="https://trendshift.io/repositories/888" target="_blank"><img src="https://trendshift.io/api/badge/repositories/888" alt="meshery%2Fmeshery | Trendshift" style="width: 150px;" width="150px" /></a> <!-- <a href="https://app.fossa.com/projects/git%2Bgithub.com%2Fmeshery%2Fmeshery?ref=badge_shield" alt="License Scan Report"> <img src="https://app.fossa.com/api/projects/git%2Bgithub.com%2Fmeshery%2Fmeshery.svg?type=shield"/></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%"> <img src=".github/assets/images/readme/cncf-white.svg#gh-dark-mode-only" width="30%" align="center" /> <img src=".github/assets/images/readme/cncf-black.svg#gh-light-mode-only" width="30%" align="center" /> </div> <br /> <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> <br /> <div align="center" width="100%"> <!-- <a href="https://www.youtube.com/watch?v=034nVaQUyME&list=PL3A-A6hPO2IO_yzN83wSJJUNQActzCJvO&index=9"><img src=".github/assets/images/readme/meshery-dashboard-hero-image.png" width="800px" /></a> <br /> --> 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> <br /> <!-- - [Functionality](#functionality) - [Meshery Architecture](#meshery-architecture) - [Join the Meshery community!](#join-the-meshery-community) - [Contributing](#contributing) - [Stargazers](#stargazers) - [License](#license) --> <!-- <p style="clear:both;"> </p> <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"> <img alt="Meshery - the Cloud Native Manager" src="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/meshery-logo-dark-text-side.svg" align="left" width="45%"> </picture></a> <a href="https://meshery.io"> <h3 style="margin:auto;"><br /><br /> <a href="https://docs.google.com/presentation/d/14kxjwYSJ_FyE3K_6CDEd6oq2kqwn0OSE8RDJ4H-KlKU/edit?usp=sharing"><center><i>Project Overview Presentation</i></center></a> <br /><br /><br /> </h3> --> <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 [380+ integrations](https://meshery.io/integrations). <!-- <a href="https://www.youtube.com/watch?v=034nVaQUyME"><img alt="Meshery cloud native management" src="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/meshmap.gif" style="margin-left:10px; margin-bottom:10px;" width="100%" align="center" /></a> <br /><br />--> </p> <a href=".github/assets/images/readme/cloud-native-integrations.png"><img alt="Meshery Integrations" src=".github/assets/images/readme/cloud-native-integrations.png" style="margin-right:10px;margin-bottom:10px;" width="100%" align="center"/></a> 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 <img src="https://meshery.io/assets/images/screens/multi-cluster-management.gif" width="50%" alt="Meshery managing multiple Kubernetes clusters across different cloud providers" loading="lazy" align="center" /> 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. <!-- Assess your cloud native infrastructure configuration against deployment and operational best practices with Meshery's configuration validator. Manage your workloads with confidence. Check your Kubernetes configuration for anti-patterns and avoid common pitfalls. --> </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](https://docs.meshery.io/concepts/logical/relationships) with each other. Meshery supports a broad variety of built-in relationships between components, which you can use to create your own custom relationships. <img src=".github/assets/images/readme/edge_mount_relationship_pod_persistent_volume.svg" width="50%" alt="Diagram showing Pod and PersistentVolume relationship with mount edge connection" loading="lazy" align="center" /> <details><summary><img alt="OPA Logo" src=".github/assets/images/readme/opa-logo.svg" style="margin-right:10px;" width="25px" align="left" /><h4>Context-Aware Policies For Applications</h4></summary> <img alt="Meshery and Open Policy Agent Integration" src=".github/assets/images/readme/meshery-policies-2.png" style="margin:auto;text-align:center" width="50%" /> <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 <img src=".github/assets/images/readme/workspace.gif" width="50%" alt="Meshery workspace interface showing team collaboration features" loading="lazy" /> Workspaces let you organize your work and serve as the central point of collaboration for you and your teams and a point of access control to Environments and their resources. <details><summary><h4>Manage your connections with Environments</h4></summary> <img src=".github/assets/images/readme/environments.gif" width="50%" alt="Meshery environments interface for managing connections and credentials" loading="lazy" align="center" /> <p><a href="https://docs.meshery.io/concepts/logical/environments" target="_blank" rel="noopener noreferrer">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> <img src=".github/assets/images/readme/meshery-snapshot.png" width="50%" alt="Infrastructure snapshot preview in GitHub pull request" loading="lazy" align="center" /> 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 Meshery to your GitHub repositories. </details> <!-- <h3>Operate with configuration best practices</h3> <br /><br /> <p>Assess your configurations against deployment and operational best practices with Meshery's configuration validator.</p> <br /><br /> <h3>Control all of your infrastructure with mesheryctl</h3> <br /><br /> <p>Whether managing multiple Meshery deployments, importing designs, discoverying Kubernetes clusters, do so with ease using Meshery CLI in your terminal.</p> <br /><br /> --> ## 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](https://docs.meshery.io/extensibility), 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" target="_blank" rel="noopener noreferrer">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 Meshery extensions. ## Performance Management Meshery offers load generation and performance characterization to help you assess and optimize the performance of your applications and infrastructure. <img src=".github/assets/images/readme/performance-metrics.gif" alt="Meshery performance metrics dashboard showing load generation results" width="50%" loading="lazy" /> <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> <img src =".github/assets/images/readme/meshery-performance.gif" alt="Meshery performance dashboard animation"> 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> - **Load Generation:** Meshery uses the Fortio load generator to drive performance tests, with a pluggable load generator interface for extensibility. - **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" target="_blank" rel="noopener noreferrer">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> <!-- SCREENSHOT / GIF NEEDED HERE --> </details> <h2><a name="running"></a>Get Started with Meshery</h2> <p style="clear:both;"></p> <!-- <img alt="Control Kubernetes and your workloads with mesheryctl" src=".github/assets/images/readme/mesheryctl.png" style="margin-left:10px; margin-bottom:10px;" width="50%" align="right" /> --> <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](https://meshery.io/#getting-started) section to quickly deploy Meshery on any of these supported platforms: | Platform | Supported? | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------: | | <img alt="" src="https://docs.meshery.io/installation/docker/images/docker.svg" width="20" height="20" vertical-align="middle" /> [Docker](https://docs.meshery.io/installation/docker) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/docker/images/docker.svg" width="20" height="20" vertical-align="middle" /> [Docker - Docker App](https://docs.meshery.io/installation/docker) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/docker/images/docker.svg" width="20" height="20" vertical-align="middle" /> [Docker - Docker Extension](https://docs.meshery.io/installation/docker/docker-extension) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/images/kubernetes.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes](https://docs.meshery.io/installation/kubernetes) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/aks/images/aks.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes - AKS](https://docs.meshery.io/installation/kubernetes/aks) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/docker/images/docker.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes - Docker Desktop](https://docs.meshery.io/installation#mac-or-linux) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/eks/images/eks.png" width="20" height="20" vertical-align="middle" /> [Kubernetes - EKS](https://docs.meshery.io/installation/kubernetes/eks) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/gke/images/gke.png" width="20" height="20" vertical-align="middle" /> [Kubernetes - GKE](https://docs.meshery.io/installation/kubernetes/gke) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/images/helm.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes - Helm](https://docs.meshery.io/installation/kubernetes/helm) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/kind/images/kind.png" width="20" height="20" vertical-align="middle" /> [Kubernetes - kind](https://docs.meshery.io/installation/kubernetes/kind) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/minikube/images/minikube.png" width="20" height="20" vertical-align="middle" /> [Kubernetes - Minikube](https://docs.meshery.io/installation/kubernetes/minikube) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/images/openshift.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes - OpenShift](https://docs.meshery.io/installation/kubernetes) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/images/kubernetes.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes - Rancher](https://docs.meshery.io/installation/kubernetes) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/mesheryctl/linux-mac/images/linux.svg" width="20" height="20" vertical-align="middle" /> [Linux](https://docs.meshery.io/installation#mac-or-linux) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/mesheryctl/linux-mac/images/apple.svg" width="20" height="20" vertical-align="middle" /> [Mac](https://docs.meshery.io/installation#mac-or-linux) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/mesheryctl/linux-mac/images/homebrew.png" width="20" height="20" vertical-align="middle" /> [Mac - Homebrew](https://docs.meshery.io/installation#mac-or-linux) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/mesheryctl/windows/images/wsl2.png" width="20" height="20" vertical-align="middle" /> [Windows](https://docs.meshery.io/installation#windows) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/mesheryctl/windows/images/wsl2.png" width="20" height="20" vertical-align="middle" /> [Scoop](https://docs.meshery.io/installation#windows) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/mesheryctl/windows/images/wsl2.png" width="20" height="20" vertical-align="middle" /> [WSL2](https://docs.meshery.io/installation/platforms/windows#wsl2) | ✔️ | | <img alt="" src="https://docs.meshery.io/installation/kubernetes/images/raspberry-pi.png" width="20" height="20" vertical-align="middle" /> Raspberry Pi | In Progress | [Meshery documentation](https://docs.meshery.io/installation) 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. Jump into community <a href="https://slack.meshery.io">Slack</a> or <a href="https://discuss.meshery.io/">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. <br /> </p> <br /><br /> <div style="display: flex; justify-content: center; align-items:center;"> <div> <a href="https://meshery.io/community"><img alt="Meshery Community" src="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/community.png" width="140px" style="margin-right:36px; margin-bottom:7px;" width="140px" align="left"/></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>.<br /> ✔️ <em><strong>Watch</strong></em> community <a href="https://www.youtube.com/@mesheryio?sub_confirmation=1">meeting recordings</a>.<br /> ✔️ <em><strong>Fill-in</strong></em> a <a href="https://meshery.io/newcomers">member form</a> and gain access to community resources. <br /> ✔️ <em><strong>Discuss</strong></em> in the <a href="https://discuss.meshery.io/">community forum</a>.<br /> ✔️ <em><strong>Explore more</strong></em> in the <a href="https://meshery.io/community#handbook">community handbook</a>.<br /> </p> </div><br /><br /> <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" /> <img alt="Shows an illustrated light mode meshery logo in light color mode and a dark mode meshery logo dark color mode." src="https://raw.githubusercontent.com/meshery/meshery/master/.github/assets/images/readme/slack.svg" width="110px" align="left" /> </picture> </a> </div> </div> <br /><br /> <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> <br /><br /> <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](https://docs.meshery.io/project/contributing) 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 ecosystem. See the [identifier-naming contributor guide](https://github.com/meshery/schemas/blob/master/docs/identifier-naming-contributor-guide.md) 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`](./AGENTS.md). ### Cloning this repository (sparse clone recommended) This repository is large - a full clone is tens of gigabytes and grows over time, mostly from the generated model registry (`models/`, 400+ models) and archived documentation snapshots (`docs/static/v*/`). Unless you specifically need those, **clone sparsely** to get a working tree a fraction of the size while keeping the full commit history: ```bash # Blobless partial clone, then check out everything EXCEPT the bulky generated dirs git clone --no-checkout --filter=blob:none https://github.com/meshery/meshery.git cd meshery git sparse-checkout set --no-cone \ '/*' \ '!/models/*' '/models/meshery-core/' '/models/kubernetes/' \ '!/docs/static/v0.8/' git checkout master ``` This keeps only the `meshery-core` and `kubernetes` models and the latest docs snapshot (`docs/static/v0.9`). Git fetches any excluded file on demand, so nothing is permanently lost. See the [Contributing guide](https://docs.meshery.io/project/contributing/#cloning-the-repository) for how to re-include a directory later. <!-- <a href="https://youtu.be/MXQV-i-Hkf8"><img alt="Deploying Linkerd with Meshery" src="https://docs.meshery.io/assets/img/readme/deploying-linkerd-with-meshery.png" width="100%" align="center" /></a> --> <div> </div> ### Stargazers <p align="center"> <i>If you like Meshery, please <a href="../../stargazers">★</a> star this repository to show your support! 🤩</i> <br /> <a href="../../stargazers"> <img align="center" src="https://api.star-history.com/svg?repos=meshery/meshery&type=Date" /> </a></p> ### License This repository and site are available as open-source under the terms of the [Apache 2.0 License](https://opensource.org/licenses/Apache-2.0). #### Software Bill of Materials (SBOM) Meshery's [Software Bill of Materials](https://github.com/meshery/meshery/actions/workflows/bom.yaml) (SBOM) is available as a build artifact.
