Installing the Ambassador Edge Stack

Install from MacOS

1. (1a) Download the edgectl installer or (1b) download it with a curl command:

   Terminal

   copied

   sudo curl -fL https://metriton.datawire.io/downloads/darwin/edgectl -o /usr/local/bin/edgectl && sudo chmod a+x /usr/local/bin/edgectl

   If you decide to download the file with (1b), you may encounter a security block. To continue, use this procedure:

   • Go to System Preferences > Security & Privacy > General.
   • Click the Open Anyway button.
   • On the new dialog, click the Open button.

2. Run the installer with edgectl install

3. The installer will provision a load balancer, configure TLS, and provide you with an edgestack.me subdomain. The edgestack.me subdomain allows the Ambassador Edge Stack to automatically provision TLS and HTTPS for a domain name, so you can get started right away.

   
   

4. Set up Service Catalog to view all of your service metadata in Ambassador Cloud.

Install from Linux

1. (1a) Download the edgectl installer or (1b) download it with a curl command:

   Terminal

   copied

   sudo curl -fL https://metriton.datawire.io/downloads/linux/edgectl -o /usr/local/bin/edgectl && sudo chmod a+x /usr/local/bin/edgectl

2. Run the installer with edgectl install

3. The installer will provision a load balancer, configure TLS, and provide you with an edgestack.me subdomain. The edgestack.me subdomain allows the Ambassador Edge Stack to automatically provision TLS and HTTPS for a domain name, so you can get started right away.

   
   

4. Set up Service Catalog to view all of your service metadata in Ambassador Cloud.

Install from Windows

1. Download the edgectl.exe installer.
2. Run the installer with edgectl install
3. The installer will provision a load balancer, configure TLS, and provide you with an edgestack.me subdomain. The edgestack.me subdomain allows the Ambassador Edge Stack to automatically provision TLS and HTTPS for a domain name, so you can get started right away.
   
   
4. Set up Service Catalog to view all of your service metadata in Ambassador Cloud.

Install via Kubernetes YAML

Kubernetes via YAML is the most common approach to install Ambassador Edge Stack, especially in production environments, with our default, customizable manifest. So if you want complete configuration control over specific parameters of your installation, use the manual YAML installation method.

Install via Helm

Helm, the package manager for Kubernetes, is another popular way to install Ambassador Edge Stack through the pre-packaged Helm chart. Full details, including the differences for Helm 2 and Helm3, are in the Helm instructions.

Install Locally on Docker

The Docker install will let you try the Ambassador Edge Stack locally in seconds, but is not supported for production workloads. Try Ambassador on Docker.

Install via the Ambassador Operator

The Ambassador Edge Stack Operator automates installs (day 1 operations) and updates (day 2 operations), among other actions. To use the powerful Ambassador Operator, follow the Ambassador Edge Stack Operator instructions.

Install on Bare Metal

If you don't have a load balancer in front of your Kubernetes, the Bare Metal installation mechanism can still be used to expose the Ambassador Edge Stack. We've got instructions for bare metal installations including exposing the Ambassador Edge Stack via a NodePort or the host network.

Upgrade Options

If you already have an existing installation of the Ambassador Edge Stack or Ambassador API Gateway, you can upgrade your instance:

1. Upgrade to the Ambassador Edge Stack from the API Gateway.
2. Upgrade your Ambassador Edge Stack instance to the latest version.

Container Images

Although our installation guides will favor using the docker.io container registry, we publish the Ambassador Edge Stack and Ambassador API Gateway releases to multiple registries.

Starting with version 1.0.0, you can pull the ambassador and aes images from any of the following registries:

• docker.io/datawire/
• quay.io/datawire/
• gcr.io/datawire/

We want to give you flexibility and independence from a hosting platform's uptime to support your production needs for Ambassador Edge Stack or Ambassador API Gateway. Read more about Running Ambassador in Production.

What’s Next?

The Ambassador Edge Stack has a comprehensive range of features to support the requirements of any edge microservice. To learn more about how the Ambassador Edge Stack works, along with use cases, best practices, and more, check out the Welcome page or read the Ambassador Story.