2 min • read

Install with Helm

Helm is a package manager for Kubernetes that automates the release and management of software on Kubernetes. Ambassador Edge Stack can be installed via a Helm chart with a few simple steps, depending on if you are deploying for the first time, upgrading Ambassador Edge Stack from an existing installation, or migrating from Ambassador Edge Stack.

Before you begin

The Ambassador Edge Stack Helm chart is hosted by Datawire and published at https://app.getambassador.io.

Start by adding this repo to your helm client with the following command:

shell
helm repo add datawire https://app.getambassador.io
helm repo update

Install with Helm

When you run the Helm chart, it installs Ambassador Edge Stack.

Install the Ambassador Edge Stack Chart with the following command:

shell
helm install -n ambassador --create-namespace \
edge-stack --devel \
datawire/edge-stack && \
kubectl rollout status -n ambassador deployment/edge-stack -w

For more advanced configuration and details about helm values, please see the helm chart.

Upgrading an existing installation

Note: Do not use these instructions to migrate from Emissary-ingress to Ambassador Edge Stack. See Migrating to Ambassador Edge Stack instead.

Upgrading an existing installation of Ambassador Edge Stack is a two-step process:

  1. First, apply any CRD updates:

    shell
    kubectl apply -f https://app.getambassador.io/yaml/edge-stack/latest/aes-crds.yaml
  2. Next, upgrade Ambassador Edge Stack itself:

    shell
    helm repo update
    helm upgrade -n ambassador \
    edge-stack --devel \
    datawire/edge-stack && \
    kubectl rollout status -n ambassador deployment/edge-stack -w

    This will upgrade the image and deploy and other necessary resources for Ambassador Edge Stack.