Back to Meshery

README

install/docker-extension/README.md

1.0.185.9 KB
Original Source
<p style="text-align:center;" align="center"><a href="https://meshery.io/meshery"><picture align="center"> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/meshery/meshery/blob/master/.github/assets/images/meshery/meshery-logo-dark-text-side.svg" width="70%" align="center" style="margin-bottom:20px;"> <source media="(prefers-color-scheme: light)" srcset="https://github.com/meshery/meshery/blob/master/.github/assets/images/meshery/meshery-logo-light-text-side.svg" width="70%" align="center" style="margin-bottom:20px;">

</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?utf8=✓&q=is%3Aopen+is%3Aissue+archived%3Afalse+org%meshery-extensions+label%3A%22help+wanted%22+" alt="GitHub issues by-label"> </a> <a href="https://github.com/meshery/meshery/blob/master/LICENSE" alt="LICENSE"> </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://meshery.io/community#community-forums" alt="Discuss Users"> </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> </p>

Meshery is the cloud native management plane offering lifecycle, configuration, and performance management of Kubernetes, service meshes, and your workloads.

<p align="center"> Meshery is a Cloud Native Computing Foundation project. </p>

Docker Extension for Meshery

The Docker Extension for Meshery extends Docker Desktop’s position as the cloud native developer’s go-to Kubernetes environment with easy access to the next layer of cloud native infrastructure: service meshes. Service mesh or not, though, Meshery offers a visual topology for designing Docker-Compose applications, operating Kubernetes, service meshes, and their workloads. Meshery brings deep support of 10 different service meshes to the fingertips of Docker Desktop developers in connection with Docker Desktop’s ability to deliver Kubernetes locally.

<h2><a name="running"></a>Get Started with the Docker Extension for Meshery</h2> <h3>Using Docker Desktop</h3> <p>Navigate to the Extensions area of Docker Desktop.</p> <h3>Using <code>docker</code></h3> <p>Meshery runs as a set of containers inside your Docker Desktop virtual machine.</p> <pre>docker extension install meshery/docker-extension-meshery</pre> <p>See the <a href="https://docs.meshery.io/installation/quick-start">quick start</a> guide.</p> <p style="clear:both;">&nbsp;</p>

Using the Docker Extension for Meshery

  1. Install any service mesh with the check of a box.
  2. Import your Docker Compose apps for visual design and deployment to Kubernetes and service meshes.
<p align="center"><a href="https://raw.githubusercontent.com/meshery/meshery/master/install/docker-extension/docs/img/docker-desktop-extension-for-meshery.png"></a></p>

Docker Extension for Meshery Architecture

The Docker Extension for Meshery deploys Meshery to your local Docker host as a Docker Compose application.

<p align="center"><a href="https://raw.githubusercontent.com/meshery/meshery/master/install/docker-extension/docs/img/docker-extension-for-meshery-architecture.png"></a></p> Learn more about <a href="https://docs.meshery.io/architecture">Meshery's architecture</a>.

Docker Extension for Meshery

From /install/docker-extension, familiarize with available make targets by executing:

make

Review the available targets and their purpose. In general, follow this sequence when building and testing changes:

make extension

Once build is complete:

docker extension install meshery/docker-extension-meshery:edge-latest

Or reinstall with:

docker extension update meshery/docker-extension-meshery:edge-latest
<p style="text-align:center; width:100%;" align="center"> <a href ="https://meshery.io/community"></a> </p> <p style="text-align:center; width:100%;" align="center"> <h3 style="text-align:center;" align="center"><em>Have questions? Need help?</em> <strong>Ask in the <a href="https://meshery.io/community#community-forums">Community Forum</a></strong>.</h3></p>