You can upgrade from any version of Ambassador Edge Stack or Emissary-ingress to any version of either by installing the new version in a new Kubernetes cluster, then copying over configuration as needed. This is the way to be absolutely certain that each installation cannot affect the other: it is extremely safe, but is also significantly more effort.
For example, to upgrade from some other version of Ambassador Edge Stack or Emissary-ingress to Ambassador Edge Stack 3.1.0:
Install Ambassador Edge Stack 3.1.0 in a completely new cluster.
Listeners for Ambassador Edge Stack 3.1.0.
When Ambassador Edge Stack 3.1.0 starts, it will not have any
Listeners, and it will not create any. You must create
Listenerresources by hand, or Ambassador Edge Stack 3.1.0 will not listen on any ports.
Copy the entire configuration from the Ambassador Edge Stack 1.X cluster to the Ambassador Edge Stack 3.1.0 cluster. This is most simply done with
kubectl get -o yaml | kubectl apply -f -.
This will create
getambassador.io/v2resources in the Ambassador Edge Stack 3.1.0 cluster. Ambassador Edge Stack 3.1.0 will translate them internally to
Each Ambassador Edge Stack instance has its own cluster, so you can test the new instance without disrupting traffic to the existing instance.
If you need to make changes, you can change the
getambassador.io/v2resource, or convert the resource you're changing to
Once everything is working with both versions, transfer incoming traffic to the Ambassador Edge Stack 3.1.0 cluster.