Upgrading Ambassador Edge Stack
Since Ambassador Edge Stack's configuration is entirely stored in Kubernetes resources, no special process is necessary to upgrade Ambassador Edge Stack.
The steps to upgrade depend on the method that was used to install Ambassador Edge Stack, as indicated below.
Installed via the Operator?
If you installed using the Operator, then you'll need to use the Operator to perform the upgrade. To verify whether the Operator was used to install Ambassador Edge Stack, run the following command to see if it returns resources:
$ kubectl get deployment -n ambassador -l 'app.kubernetes.io/name=ambassador,app.kubernetes.io/managed-by in (amb-oper,amb-oper-manifest,amb-oper-helm,amb-oper-azure)'NAME READY UP-TO-DATE AVAILABLE AGEambassador 1/1 1 1 ...
Installed via Helm?
If you installed using the Helm chart or edgectl install
, then you should
upgrade with the help of Helm.
To verify this, run the following command to see if it returns resources:
$ kubectl get deployment -n ambassador -l 'app.kubernetes.io/name=ambassador'NAME READY UP-TO-DATE AVAILABLE AGEambassador 1/1 1 1 ...
Installed via YAML Manifests?
Finally, if you installed using YAML manifests, simply run the commands in the following section. To verify whether manifests were used to install Ambassador Edge Stack, run the following command to see if it returns resources:
$ kubectl get deployment -n ambassador -l 'product=aes'NAME READY UP-TO-DATE AVAILABLE AGEambassador 1/1 1 1 ...
If none of the commands above return resources, you probably have an old installation and you should follow the instructions for upgrading to Ambassador Edge Stack.
Upgrading an Installation with YAML Manifests
If you previously installed Edge Stack using YAML manifests, you can upgrade with these commands:
kubectl apply -f https://www.getambassador.io/yaml/aes-crds.yamlkubectl apply -f https://www.getambassador.io/yaml/aes.yaml
This will trigger a rolling upgrade of Ambassador Edge Stack.
If you're using your own YAML, check our YAML to be sure of other changes. At a minimum
you'll need to change the pulled image
for the Ambassador Edge Stack container and redeploy.
Set Up Service Catalog
Upgrading to version 1.12 or higher adds support for Service Catalog. Set up Service Catalog to view all of your service metadata in Ambassador Cloud.
Questions?
We’re here to help. If you have questions, join our Slack or contact us.