GitHub Actions

GitHub Actions with Meshery automates the synchronization of Git repositories and visually validates pull requests for efficient development.

Meshery GitHub Actions enhance your operational workflow by integrating git version control and the management of your infrastructure. Meshery GitHub Actions are design to integrate into your existing pipelines.

Meshery Github Actions

  1. MeshMap Snapshot
  2. Performance Testing with Meshery
  3. Archived: Service Mesh Interface Conformance with Meshery

This methodology automates the synchronization of your actual infrastructure state with the desired state defined in your Git repository. Meshery enables GitOps by offering a comprehensive view of your infrastructure, allowing you to verify workload designs and Kubernetes cluster configurations before merging pull requests.

MeshMap Snapshot GitHub Action

Meshery introduces the MeshMap Snapshot GitHub Actions, a tool that allows you to visualize changes in your infrastructure directly in your pull requests. With MeshMap Snapshot, you can:

  • See your deployment changes pull request-to-pull request.
  • Get snapshots of your infrastructure directly in your pull requests.

See action in GitHub Marketplace

Configuring MeshMap Snapshots

MeshMap serves as a fundamental component, providing visual insights into infrastructure changes and facilitating the synchronization between the actual and desired states. Ensure that you have proper access to MeshMap to leverage its capabilities for effective GitOps implementation.

Step 1: Get access to MeshMap

To integrate Snapshots into your GitHub pull requests, confirm that your user account has MeshMap access. To do so, sign into your Layer5 Cloud account and look forIf your user account doesn’t have access, simply request access to MeshMap.

Step 2: Enable MeshMap Snapshot Action

  1. Choose to enable the MeshMap Snapshot action for all repositories in your GitHub account or for specific repositories.
  2. Authorize the Meshery GitHub App.
  3. Copy the Secret token. This token is used to authenticate Meshery with your Layer5 Cloud account.
  4. Once authorized, Meshery will automatically create a pull request workflow for your repository. To disable the workflow, simply delete the .github/workflows/meshmap-snapshot.yml file from your repository.
  5. Specify the path within your Git repository where the application configurations are stored. This ensures Meshery knows where to find and visuzlie the desired state of your infrastructure.

Currently, only authorization of the Meshery GitHub App is supported. If you would like to use your GitHub user’s personal access token, please let us know.

Customizing Snapshot Workflow Triggers in MeshMap Snapshot

You can configure your workflows to run when specific activity on GitHub happens, at a scheduled time, or when an event outside of GitHub occurs.

About events that trigger workflows

GitHub Actions provides a variety of events that can trigger workflows, allowing you to automate your software development process. Each event corresponds to a specific activity, such as creating a pull request, pushing code to a repository, or releasing a new version.

Using Meshery’s Performance Testing GitHub Action

You can create your own performance profiles to run repeatable tests with Meshery. You can configure this action to trigger with each of your releases, on every pull request. or any GitHub workflow trigger event. A sample configuration of the action is shown below.

Read more about the Service Mesh Performance GitHub Action in the Meshery documentation. See action in GitHub Marketplace

Last modified February 18, 2024: Fixing typos (b3d5ddb)