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.
- Starting at
v0.12.0, packages on workload clusters are remotely managed by the management cluster.
- While following this guide to install packages on a workload cluster, please make sure the
kubeconfigis pointing to the management cluster that was used to create the workload cluster. The only exception is the
kubectl create namespacecommand below, which should be run with
kubeconfigpointing to the workload cluster.
Generate the package configuration
eksctl anywhere generate package emissary --cluster <cluster-name> > emissary.yaml
Add the desired configuration to
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 metadata: name: emissary namespace: eksa-packages-<cluster-name> spec: packageName: emissary
eksctl anywhere create packages -f emissary.yaml
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