meshery/meshery.io

Website for Meshery

Meshery.io

Preview of Meshery.io Website

Visit Meshery.io to learn more!

What is Meshery?

Meshery is a self-service engineering platform - the open source, cloud native manager that enables the design and management of all Kubernetes-based infrastructure and applications. Among other features, Meshery manages multi-cluster Kubernetes deployments. As an extensible platform, Meshery offers visual and collaborative GitOps, freeing you from the chains of YAML.

For further information, refer to the Meshery Docs.

 

💻Tech Stack

Join the Meshery community!

Our projects are community-built and welcome collaboration. 👍 Be sure to see the Newcomers' Guide for a tour of resources available to you and jump into our Slack to engage!

Find your MeshMate

MeshMates are experienced Layer5 community members, who will help you learn your way around, discover live projects and expand your community network. Become a Meshtee today!

Find out more about the Layer5 community.

✔️ Join any or all of the weekly meetings on the community calendar.
✔️ Watch community meeting recordings.
✔️ Access the Community Drive-by completing a community Member Form.
✔️ Discuss in the Community Forum.
✔️ RSVP to the CNCF Meshery Community meetings.

Not sure where to start? Grab an open issue with the help-wanted label.

 

Contributing to the Meshery.io Website

Before contributing, please review the Contribution Flow. In the following steps, you will setup your development environment, fork and clone the repository, run the site locally, and finally commit, sign off, and push any changes made for review.

1. Set up your development environment

• The Meshery site is built using Jekyll - a simple static site generator! You can learn more about Jekyll and setting up your development environment in the Jekyll Docs.

• First install Ruby, then install Jekyll and Bundler. ( Note : Install the same version of Ruby as mentioned in the Gemfile )

2. Get the code

• Fork and then clone the Meshery.io repository

  $ git clone https://github.com/YOUR-USERNAME/meshery.io

• cd into project using

  $ cd meshery.io

3. Serve the site

• Serve the code locally

  $ make site

  Note: From the Makefile, this command is actually running $ bundle install; bundle exec jekyll serve --drafts --livereload

4. Create a Pull Request

• After making changes, don't forget to commit with the sign-off flag (-s)

  $ git commit -s -m “my commit message w/signoff”

• Once all changes have been committed, push the changes.

  $ git push origin <branch-name>

• Then on Github, navigate to the Meshery.io repository and create a pull request from your recently pushed changes.

Stargazers

If you like Meshery, please ★ star this repository to show your support! 🤩

License

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

🔼Back to top

meshery.io's Issues

Fix favicon

Description
The favicon on the meshery.io site needs to be updated, so that it shows the Meshery logo.

meshery.io has an option to "Run Meshery" which is presently not working

Run Meshery is not working

Collapse all installation instructions

Current Behavior
Some of the Meshery installation instructions show by default and some do not.

Desired Behavior
Let's have these be uniform and (at least for now) have all of them hidden when the page loads.

Update Community page footer

The community page should list all the same resources as does layer5.io/meshery does.

The style of the community details do not need to match that of the layer5.io/meshery page. Buttons with fill onHover is not necessary.

Add Contributor: Hector de la Cruz

Current Behavior
@hdelacru has joined the community as a community manager and is rapidly making an impact.

Desired Behavior
A profile for @hdelacru should be created and visible on /community.

Add Community section to Community page

Current Behavior
The Community page is missing information about how to connect with the community via slack, drive, email, twitter, meetings, etc.

Desired Behavior
At the top of the /community page, there should be a section that lists these resources.

Install: Incorporate helm package creation into Meshery release workflow

Current Behavior
Given that the source for Meshery's helm charts in is the Meshery repo, instead of storing the compressed version of the charts in this repo (meshery.io) as a charts "release", can we consider incorporating the tar.gz creation of these charts to our GitHub Actions workflow in Meshery?

We would include the tar.gz creation part of the tagged workflow (the workflow that is enacted when a release tag is present). We could either have goreleaser tar.gz the charts or have a script executed to tar.gz the charts and make that tar.gz available alongside the rest of the Meshery release artifacts here - https://github.com/layer5io/meshery/releases

In this way, the Meshery helm chart is treated as another release artifact that is created each time we cut a new Meshery release.

Convert adapter table to logos

Enhancement Description
The adapter table would look better if the adapters were presented as logos, not as a table.

Desired Behavior:
Adapters are listed as a set of icons/logos. Alpha state adapters should be denoted as such.

Screenshot

Add contributor.md to this repo

Navigation Menu Item: Add YouTube channel under "Connect" menu

Current Behavior
The community meeting recordings are missing from the Connect menu items list.

Desired Behavior
"YouTube" should be listed with this link: https://www.youtube.com/channel/UCFL1af7_wdnhHXL1InzaMvA?sub_confirmation=1 under the Connect menu.

Add Meshery Adapter for CPX to list of adapters

Enhancement Description
The table on https://meshery.io listing adapters is missing an entry for CPX.

This adapter should be listed as an alpha adapter with link to its the adapter section of the Meshery documentation.

Include Citrix logo for CPX adapter listing

Current Behavior
The CPX entry in the list of adapters is missing a logo.

Desired Behavior
The Meshery adapter for CPX should have a logo akin to that of the other adapters.

Fuzzy contributor image for Will Calcote

Description
@willcalcote's profile picture on https://meshery.io/community is a bit fuzzy.

Expected Behavior
All profile pictures should be clear, and ideally, not a caricature, but an actual photo of the contributor.

All images should have hyperlink to full-sized image

Current Behavior
The screenshots / images in the site are not clickable. Some screenshots are better viewed at a larger size.

Desired Behavior
All thumbnail images should be hyperlinked to their original full-size image.

Add a "Join the Community" button at the top of the Community page

Current Behavior
The project site should be prominently encouraging new community members. A "Join the Community" button will help with this as shown in the mockup below.

Desired Behavior

Footer needs improvement

Add Contributor Profile for Ivana Atanasova

Current Behavior
@ivanayov recent focus has been on enhancements in the NSM adapter. Her contributions and engagement in the community are most welcome.

Desired Behavior
A new profile for @ivanayov should show on the /community page.

share of link of mashery.io show wrong text about meshery

Description
when someone shares the link meshery.io, it shows "Track and optimize your sales team in real time" as per the template.

Expected Behavior
it should be " Quickly compare and learn service meshes like Istio, Linkerd, Envoy, Octarine, App Mesh, Consul Connect. Benchmark the performance of your application across different service meshes and compare their overhead."

Add Contributor Profile for Aisuko

Current Behavior
@Aisuko has recently joined the community and has already begun to make an impact. His contributions and engagement in the community are most welcome.

Desired Behavior
A new profile for @Aisuko's should show on the /community page.

Mobile View: Navigation menu

Bugs to Fix

1. Font should be white.
2. Menu should be in upper right hand corner.
3. Top-level navigation items should not have a hyperlink (should not reload the page).

Screenshots

Graduate CPX adapter from "alpha" to "beta"

Current State:
The CPX adapter is currently listed as "alpha".

Desired State:
The CPX adapter should now be a "beta" adapter.

See https://meshery.io

meshery.io page don't have favicon

Meshery.io don't have the lastest favicon.
Behaviour
Meshery.io should have latest favicon on every page

Navigation menu has transparent background in mobile view

Description
The background of the dropdown navigation menu is transparent when users are on a mobile device or small screen width.

Screenshot

Expected Behavior
The menu background should have a solid color.

Instead of displaying bash it is showing sh, sudo to be added as well

Rewrite README.md

Current State:
The meshery.io readme.md needs overhauled akin to what was done for the meshery/docs readme.

Desired State:

The meshery.io readme should briefly describe the Meshery project and then list all of the instructions for contributing to the https://meshery.io site.

---

Contributor Resources

• Meshery documentation site
• Meshery documentation source
• Instructions for contributing to documentation

Add Contributor Profile For Mayank Shan

Current Behavior
@mayankshah1607 has recently joined the community and has already begun to make an impact. His contributions and engagement in the community are most welcome.

Desired Behavior
A new profile for @mayankshah1607s should show on the /community page.

Update Aisuko's community profile from contributor to Helm Charts Maintainer

Current Behavior
https://meshery.io/contributors/aisuko/ profile currently lists contributor.

@Aisuko is the creator and maintainer of Meshery's helm charts.

Desired Behavior
His community profile should reflect this.

Navigation menu cuts off "Run Meshery" title when navigating to #getting-started

Description
When a user clicks "Run Meshery", they are appropriately directed to the #getting-started anchor. The navigation menu covers up the "Run Meshery" heading title, however.

Issue:

Users should see:

Add support for GitHub profile link in place of Twitter account link

When a contributor doesn't have a Twitter account, but does have a GitHub account, their GitHub account should be hyperlinked to in their Community profile.

The "service mesh landscape" button in the main index.html needs a real hyperlink

Add Suprakit to the contributors list

Current Behavior
@supra08 has been busy submitting PRs. It would be great to get his profile listed on the community page.

A new entry here is needed.

Add GitHub issue templates to this repo

Mailing list “Subscribe” button is off-center

Style the newsletter sign section such that the “subscribe” button is centered.

fix twitter handle of madhab paul with the correct link.

Add Lightbox support

Enhancement Description
Add Lightbox support for quick viewing of images on the site.

Use the layer5.io site as an example - https://github.com/layer5io/layer5/blob/master/_includes/lightbox.html

Community member page needs to be fixed

https://meshery.io/

Add clipboard button capability to Kubernetes install commands

Current Behavior
The terminal commands for installing Meshery are missing the convenience of having the copy-to-clipboard function.

Desired Behavior
Each of the installation steps should have this easy-to-use function.

Screenshot

Optimized images make the static resource smaller file sizes without sacrificing quality.

Current Behavior
A brief description of what the problem is. (e.g. I need to be able to...)
There are not any optimized images.

Desired Behavior
A brief description of the enhancement.

Every PR which includes the static sources it can be optimized.

Please kindly take a look at https://github.com/Aisuko/meshery.io/pull/1 and I believe that feature is very fit with the project type like this. So, please add the ImgBot to our project meshery.io

---

[Optional] Alternatives
A brief description of any alternative solutions or features you've considered.

[Optional] Additional context
Add any other context or screenshots about the feature request here.

1, The address of ImgBot https://github.com/marketplace/imgbot
2, Please just take the free open source plan. And it will be fit for us well.

Remove hyperlink for Contributor profiles that don't has a Twitter handle

Add Meshery Adapter for Tanzu Service Mesh to list of adapters

Current Behavior
The table on https://meshery.io listing adapters is missing an entry for the Tanzu Service Mesh (alpha) adapter.

Desired Behavior
This adapter should be listed as an [alpha adapter]((https://github.com/layer5io/meshery.io/blob/master/index.html#L117) with link to its repository.

Site menu overhaul

Current Behavior
The current menu has "GitHub" listed, but is missing Slack, the mailing list, community drive, community calendar and so on.

Desired Behavior
New top-level menu items with sub-items structured like so:

Docs

Community

Blog

Connect

• Calendar
• GitHub
• Mailing List
• Slack

Resources

• Branding
• Code of Conduct
• Contributing

Run Meshery

Extraneous ">" near screenshots

Description
Errant "<" and ">" are visible next to most of the screenshots on the main meshery.io page.

Add GitHub stats to landing page

Current Behavior
Missing GitHub stats on landing page.

Implementation
Add the following stats in the section identified in the mockup.

• https://ghbtns.com/github-btn.html?user=layer5io&repo=meshery&type=star&count=true&size=large
• https://ghbtns.com/github-btn.html?user=layer5io&repo=meshery&type=watch&count=true&size=large&v=2
• https://ghbtns.com/github-btn.html?user=layer5io&repo=meshery&type=fork&count=true&size=large

"Community" section heading listed twice

Description
Community listed twice:

Expected Behavior
This bug was introduced here - 2398b95#diff-eacf331f0ffc35d4b482f1d15a887d3bR104

This extra <h2>Community</h2> in index.html can be safely removed.

Include Octarine logo for adapter listing

Current Behavior
The Octarine entry in the list of adapters is missing a logo.

Desired Behavior
The Meshery adapter for Octarine should have a logo akin to that of the other adapters.

Run Meshery: Missing blue background on copy-to-clipboard button

Description
The copy-to-clipboard button is missing the blue background (screenshot 1) it should have akin to that of its usage on layer5.io/meshery (screenshot 2).

Expected Behavior
Users should have a common experience in how this button is displayed.

Screenshots
1

2

Community Member Profile: Nupur Thakur

Current Behavior
Nupur Thakur has been waiting in the wings until she was able to holistically engage as a contributor. That time has come and she is quickly making waves (and merged PRs).

Desired Behavior
A new community profile needs created for @Nupur-thakur as a Contributor.

Add Contributor: Naveen Jain

Current Behavior
@nveenjain is a new community contributor.

Desired Behavior
A profile for @nveenjain should be created and visible on /community.

add contributor: kanishkar

Current Behavior
@kanishkarj is a new community contributor.

Desired Behavior
A profile for @kanishkarj should be created and visible on /community.

Install: Duplicative LICENSE and OWNERS files?

Description

Will the LICENSE and OWNERS files in the charts folder, be used as part of the Helm Hub entry? If not, the LICENSE and OWNERS file found in the root of this repo might suffice (the two files in the charts folder might be considered duplicative).