This tutorial will walk you through how to prepare an environment using Anypoint Service Mesh. If you are looking for the best place to get started, this tutorial will be your best place to get started. Before you can use Anypoint Service Mesh, you will need to obtain a license key by getting in touch with your MuleSoft account team. Additionally, if you are a Windows user there may be some steps in this guide that don’t match up since this guide is biased towards Mac users. If this is your first time using MuleSoft, checkout our Hello Mule tutorial and click the signup button below to get started.
Already have an account? Sign in.
If you have a Macbook, this tutorial will help you set up the tools you will need to interact with your Kubernetes Cluster.
Returning users: If you have done these steps (2.1.1 - 2.1.5) before, you will need to run the command below and then remove your previous asmctl version.
Replace yourprofile with your own file directory path
This command removes your previous asmctl version
Open the terminal and paste the following code to install Homebrew
This is required so you can interact with your K8s cluster.
You install, manage, and troubleshoot your Anypoint Service Mesh instance by using the Anypoint Service Mesh client. To download the Anypoint Service Mesh client, type the following command at the command prompt:
Add the following to .bash_profile:
You’ll need to install istioctl to be able to install and interact with the ISTIO control plane. ASM 1.1 supports ISTIO v 1.6 & 1.7.
Download ISTIO v.1.7.0
Make istioctl available in your terminal for easy access (NOTE: Please change the PATH to reflect your environment):
Jump to Step 3 to choose your Kubernetes environment
Windows Subsystem for Linux (WSL) is a compatibility layer for running Linux binary executables natively on Windows 10. Ensure that the “Windows Subsystem for Linux” optional feature is enabled. Next, open up your PowerShell as an Administrator and run the command:
Instead of this powershell command, you can open the start menu and search Turn Windows features on or off. Then Select Windows Subsystem for Linux and click OK. You will need to restart your computer when prompted. Next we are going to install the Ubuntu Linux Distribution.
Open the Microsoft Store and Ubuntu, then select GET from the distributions page.
Complete initialization of Ubuntu:
kubectl will be used via the Ubuntu app to run commands against the Kubernetes cluster. Note: kubectl can be used with Windows PowerShell however this approach does not work with the commands and scripts that need to be executed in the Service Mesh labs.
Open the Ubuntu app:
1. Download the latest release of kubectl:
2. Make the kubectl binary executable:
3. Move the binary in to your PATH:
4. Test to ensure the version you installed is up-to-date:
Need additional information?
Next, install the Anypoint Service Mesh Utility via the command line:
Then add the following to .bash_profile:
You’ll need to install istioctl to be able to install and interact with ISTIO. At GA we will only support 1.6 and 1.7. Both versions will need different flags to be set at the time of installation.
If you like to check your installation then run the following:
Please choose a selection below of what tutorial you like to follow to setup Anypoint Service Mesh on your cloud of choice.
Thanks so much for reading the tutorial. Please click on one of the following tutorials to continue your learning of Anypoint Service Mesh. If you have any trouble, feel free to reach out to use @MuleDev on Twitter.