DocsEdge Stack1.14Installing the Ambassador Edge Stack
Installing the Ambassador Edge Stack
Contents
Install for macOS
(1a) Download the
edgectl
installer or (1b) download it with a curl command: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.
Run the installer with
edgectl install
The installer will provision a load balancer, configure TLS, and provide you with an
edgestack.me
subdomain. Theedgestack.me
subdomain allows the Ambassador Edge Stack to automatically provision TLS and HTTPS for a domain name, so you can get started right away.Set up Service Catalog to view all of your service metadata in Ambassador Cloud.
Install for Linux
(1a) Download the
edgectl
installer or (1b) download it with a curl command:Run the installer with
edgectl install
The installer will provision a load balancer, configure TLS, and provide you with an
edgestack.me
subdomain. Theedgestack.me
subdomain allows the Ambassador Edge Stack to automatically provision TLS and HTTPS for a domain name, so you can get started right away.Set up Service Catalog to view all of your service metadata in Ambassador Cloud.
Install for Windows
Run the installer with
edgectl install
The installer will provision a load balancer, configure TLS, and provide you with an
edgestack.me
subdomain. Theedgestack.me
subdomain allows the Ambassador Edge Stack to automatically provision TLS and HTTPS for a domain name, so you can get started right away.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:
- Upgrade to the Ambassador Edge Stack from the API Gateway.
- 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 Quick Start page or read the Ambassador Story.