DocsEdge StackUpgrading Ambassador Edge Stack with a separate cluster
Upgrading Ambassador Edge Stack with a separate cluster
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.11.1:
Install Ambassador Edge Stack 3.11.1 in a completely new cluster.
Create
Listener
s for Ambassador Edge Stack 3.11.1.When Ambassador Edge Stack 3.11.1 starts, it will not have any
Listener
s, and it will not create any. You must createListener
resources by hand, or Ambassador Edge Stack 3.11.1 will not listen on any ports.Copy the entire configuration from the Ambassador Edge Stack 1.X cluster to the Ambassador Edge Stack 3.11.1 cluster. This is most simply done with
kubectl get -o yaml | kubectl apply -f -
.This will create
getambassador.io/v2
resources in the Ambassador Edge Stack 3.11.1 cluster. Ambassador Edge Stack 3.11.1 will translate them internally togetambassador.io/v3alpha1
resources.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/v2
resource, or convert the resource you're changing togetambassador.io/v3alpha1
by usingkubectl edit
.Once everything is working with both versions, transfer incoming traffic to the Ambassador Edge Stack 3.11.1 cluster.