2 min • read

Install with Helm

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

Before you begin

The Emissary-ingress 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 Emissary-ingress.

Install the Emissary-ingress Chart with the following command:

shell
helm install -n emissary --create-namespace \
emissary-ingress --devel \
datawire/emissary-ingress && \
kubectl rollout status -n emissary deployment/emissary-ingress -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 Emissary-ingress is a two-step process:

  1. First, apply any CRD updates:

    shell
    kubectl apply -f https://app.getambassador.io/yaml/emissary/latest/emissary-crds.yaml
  2. Next, upgrade Emissary-ingress itself:

    shell
    helm repo update
    helm upgrade -n emissary \
    emissary-ingress --devel \
    datawire/emissary-ingress && \
    kubectl rollout status -n emissary deployment/emissary-ingress -w

    This will upgrade the image and deploy and other necessary resources for Emissary-ingress.