Emissary Configuration

1: v3.0.0
2: v3.3.0

Emissary Ingress is an open-source Kubernetes-native API Gateway + Layer 7 load balancer + Kubernetes Ingress built on Envoy Proxy.

Best Practice

Any package configuration options listed under Reference/Packages should be modified through package yaml files (with kind: Package) through command eksctl anywhere apply package -f packageFileName. Modifying objects outside of package yaml files may lead to unpredictable behaviors.

For automatic namespace (targetNamespace) creation, see createNamespace field: PackagebundleController.spec

Configuration options for Emissary

1 - v3.0.0

Configuring Emissary Ingress in EKS Anywhere package spec

Parameter	Description	Default
General
hostNetwork	Whether Emissary will use the host network, useful for on-premise setup . Example: hostNetwork: false	false
createDefaultListeners	Whether Emissary should be created with default listeners, HTTP on port 8080 and HTTPS on port 8443. Example: createDefaultListeners: false	false
replicaCount	Replica count for Emissary to deploy. Example: replicaCount: 2	2
daemonSet	Whether to create Emissary as a Daemonset instead of a deployment Example: daemonSet: false	false

2 - v3.3.0

Emissary version 0.3.3 has decoupled the CRD portion of the package, and now supports installing multiple instances of the emissary package in the same cluster.

Configuring Emissary Ingress in EKS Anywhere package spec

Parameter	Description	Default
General
hostNetwork	Whether Emissary will use the host network, useful for on-premise setup . Example: hostNetwork: false	false
createDefaultListeners	Whether Emissary should be created with default listeners, HTTP on port 8080 and HTTPS on port 8443. Example: createDefaultListeners: false	false
replicaCount	Replica count for Emissary to deploy. Example: replicaCount: 2	2
daemonSet	Whether to create Emissary as a Daemonset instead of a deployment Example: daemonSet: false	false