3 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:

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

Install with Helm

When you run the Helm chart, it installs Emissary-ingress.

  1. Install the Emissary-ingress CRDs.

    Before installing Emissary-ingress 2.3.1 itself, you must configure your Kubernetes cluster to support the getambassador.io/v3alpha1 and getambassador.io/v2 configuration resources. This is required.

    kubectl apply -f https://app.getambassador.io/yaml/emissary/2.3.1/emissary-crds.yaml
    kubectl wait --timeout=90s --for=condition=available deployment emissary-apiext -n emissary-system
  2. Install the Emissary-ingress Chart with the following command:

    helm install -n emissary --create-namespace \
    emissary-ingress datawire/emissary-ingress && \
    kubectl rollout status -n emissary deployment/emissary-ingress -w
  3. Next Steps

    Emissary-ingress shold now be successfully installed and running, but in order to get started deploying Services and test routing to them you need to configure a few more resources.

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

Upgrading an existing installation

See the migration matrix for instructions about upgrading Emissary-ingress.