Deploy Ambassador Edge Stack on Kubernetes with Platform9
Get Ambassador up and running on a Kubernetes cluster running on Platform9 Kubernetes Free Tier.
Join the DZone community and get the full member experience.Join For Free
Ambassador Edge Stack is an open-source tool designed to function as a Swiss army knife of sorts for traffic between your Kubernetes clusters and the rest of the world. Ambassador offers Envoy-based ingress control, an API gateway, load balancing, and more through a single tool, allowing teams to reduce the number of individual components they need to install and support, in order to manage application traffic.
Ambassador also offers the advantage of being truly Kubernetes-native: It is configured using Kubernetes annotations and declarative configurations. It supports advanced API-management features like rate-limiting and circuit-breaking, as well.
In addition, as this tutorial shows, Ambassador is quite simple to deploy. Below, we’ll walk through the steps to get Ambassador up and running on a Kubernetes cluster running on Platform9 Kubernetes Free Tier, or PMKFT.
Set Up the PMFKT Cluster
First, we need to set up a cluster in Platform9 that we’ll use to deploy Ambassador.
Follow these steps:
Sign up for PMKFT and log in through your Web browser.
Click the Create Cluster button and choose where you want to set up your cluster. For this tutorial, we’ll use a Bare-OS installation, with nodes running on Ubuntu 16.04 virtual machines. (For details on how to set this up, see this tutorial for Windows or this one for macOS.) You can also set up a cluster via another method for creating local clusters (such as Minikube) or using AWS.
Log into the virtual machines that you want to use as nodes, and run these commands:
4. Go back to the Platform9 interface in your Web browser. You should now see a list of nodes that you can select to add to your cluster, as below:
5. After you’ve selected your nodes, complete the steps on the screen to finish creating the cluster.
6. Select a node to serve as your master, then repeat the process to select worker nodes.
7. Click the API Access tab (on the left of the Platform9 interface), select the option to generate a Kubeconfig file and download the resulting file.
8. Apply the Kubeconfig:
9. Verify that the Kubeconfig was set up successfully:
You should see a message like this:
Now, you’re ready to deploy Ambassador to your Platform9 Kubernetes cluster. There are two methods for doing this:
Using the edgectl CLI tool, which automates most of the process.
Manually downloading and applying the relevant YAML files.Whichever method you choose, remember that you’ll need to work within the same terminal where you ran the export Kubeconfig ... command from the previous section (or, you can run the export command again if you open a new terminal). Also remember that the Kubeconfig credentials you downloaded from the Platform9 Web console expire after twenty-four hours, so you’ll need to download a new Kubeconfig and export it to your environment if you exceed that window.
Install Ambassador with edgectl
Edgectl is a CLI tool that you can download from the website of Datawire, the main developer of Ambassador.
On Linux and macOS, you can download and run the installer with a curl command:
If you’re on Windows, download the installer from here.
Once edgectl is downloaded, run the installer with this command:
After installation completes, you can verify that the Ambassador pods are running under the Pods, Deployments, Services tab in Platform 9:
As we can see, Ambassador has been deployed successfully on our Platform9 cluster.
Install Ambassador Manually
Deploying Ambassador manually is only slightly more complicated than using the Edgectl method described above.
In the terminal where the Kubeconfig environment for your Platform9 cluster is active, run this command:
This will download and apply the YAML files to set up the Ambassador service.
You can then access the Ambassador Web console at your cluster’s IP address. If you don’t know that address, find it with the following command:
Now, there is one more step to perform: In order to actually log into the Ambassador Web console, you’ll first need to download and configure edgectl for your Ambassador instance. The Web console will display specific instructions to follow for this purpose. Complete those as directed, and you’ll be up and running.
Create an Ambassador Service
Ambassador uses Kubernetes Custom Resource Definitions to define how requests are mapped to services. The Resource Definitions are YAML files that are applied with kubectl.
Here’s a basic definition for a service that tells Ambassador to map requests for /httpbin/ to the service httpbin.org:
To deploy this service, save the definition in a YAML file (we’ll use httpdbin.yaml for this example), then apply it with kubectl:
For further guidance on how to configure Ambassador Edge Stack, examples of more complex service deployments and tips on best practices to follow, check out the official documentation. Ambassador also has an active Slack channel where you can get support.
Opinions expressed by DZone contributors are their own.