ArcGIS Enterprise on Kubernetes must be deployed on a cluster using a version of Kubernetes that is supported for that version of ArcGIS Enterprise. For each base release, the range of supported Kubernetes versions is specified in the system requirements. Updates can extend support to additional versions of Kubernetes, which is specified in the release notes for each update.
When upgrading either ArcGIS Enterprise or your Kubernetes version, it is important to maintain version compatibility. Do not upgrade ArcGIS Enterprise to a version that does not support your cluster's current Kubernetes version. Do not upgrade your cluster to a Kubernetes version that is not supported for your current version of ArcGIS Enterprise. For this reason, it is recommended that you disable auto-upgrade in your Kubernetes cluster. When your cluster is enabled with auto-upgrade, the nodes will automatically be updated with the newer version of Kubernetes that may not yet be supported for ArcGIS Enterprise.
There will be an overlapping range of supported Kubernetes versions for each release of ArcGIS Enterprise, allowing you to upgrade to a new release while maintaining version compatibility. It may be necessary to apply an update to ensure that there is at least one version of Kubernetes that is supported for both your current release of ArcGIS Enterprise and the release you are targeting for upgrade.
To ensure version compatibility when upgrading Kubernetes or ArcGIS Enterprise on Kubernetes, complete the following steps:
- Apply the latest cumulative update to ArcGIS Enterprise to extend support to additional versions of Kubernetes.
- Upgrade Kubernetes to the latest supported version for your version of ArcGIS Enterprise.
- Optionally, upgrade ArcGIS Enterprise to the next release.
It may be necessary to apply the steps above multiple times. For example, to upgrade from Kubernetes version 1.29 on ArcGIS Enterprise 11.4 to Kubernetes version 1.33, you would do the following:
- Apply the cumulative update to extend the latest supported version of Kubernetes from 1.30 to 1.32.
- Upgrade Kubernetes to 1.32.
- Upgrade ArcGIS Enterprise to 11.5.
- Apply the cumulative update to extend the latest supported version of Kubernetes from 1.32 to 1.33.
- Upgrade Kubernetes to 1.33.