Emissary Ingress

Install/upgrade/uninstall Emissary Ingress

If you have not already done so, make sure your cluster meets the package prerequisites. Be sure to refer to the troubleshooting guide in the event of a problem.


  1. Generate the package configuration

    eksctl anywhere generate package emissary --cluster <cluster-name> > emissary.yaml
  2. Add the desired configuration to emissary.yaml

    Please see complete configuration options for all configuration options and their default values.

    Example package file with standard configuration.

    apiVersion: packages.eks.amazonaws.com/v1alpha1
    kind: Package
      name: emissary
      namespace: eksa-packages-<cluster-name>
      packageName: emissary
  3. Install Emissary

    eksctl anywhere create packages -f emissary.yaml
  4. Validate the installation

    eksctl anywhere get packages --cluster <cluster-name>

    Example command output

    NAMESPACE     NAME       PACKAGE    AGE     STATE       CURRENTVERSION                                   TARGETVERSION                                              DETAIL
    eksa-packages emissary   emissary   2m57s   installed   3.0.0-a507e09c2a92c83d65737835f6bac03b9b341467   3.0.0-a507e09c2a92c83d65737835f6bac03b9b341467 (latest)


To update package configuration, update emissary.yaml file, and run the following command:

eksctl anywhere apply package -f emissary.yaml


Emissary will automatically be upgraded when a new bundle is activated.


To uninstall Emissary, simply delete the package

eksctl anywhere delete package --cluster <cluster-name> emissary