Release notes
Review summaries of the main changes in the Gloo 2.9 release.
Make sure that you review the breaking changes 🔥 that were introduced in this release and the impact that they have on your current environment.
Introduction
The release notes include important installation changes and known issues. They also highlight ways that you can take advantage of new features or enhancements to improve your product usage.
For more information, see the following related resources:
- Upgrade guide: Steps to upgrade from the previous minor version to the current version.
- Version reference: Information about Solo’s version support.
🔥 Breaking changes
Review details about the following breaking changes. The severity is intended as a guide to help you assess how much attention to pay to this area during the upgrade, but can vary depending on your environment.
- No breaking changes are currently reported.
🌟 New features
Review the following new features that are introduced in version 2.9 and that you can enable in your environment.
Gloo Operator reference docs
Reference documentation is now published for the Gloo Operator. For more information, check out the following pages:
- Gloo Operator Helm values reference
- Gloo Operator version changelog
- ServiceMeshController API reference
🔄 Feature changes
Review the following changes that might impact how you use certain features in your Gloo environment.
Deprecation of the Istio lifecycle manager
The Istio lifecycle manager, provided either by the istioInstallations
section of the Helm chart or by the GatewayLifecycleManager and IstioLifecycleManager custom resources, is deprecated in version 2.9. The feature will be removed in future versions.
Instead, you can use the new way of installing Istio with the Gloo Operator. Check out the guides for installing ambient or sidecar meshes, or for migration steps, see Migrate to the Gloo Operator from the Istio lifecycle manager.
🗑️ Removed features
Removed support for Istio 1.21
Istio 1.21 is no longer supported with Gloo Mesh version 2.9. For more information, see the version support matrix.
🚧 Known issues
The Solo team fixes bugs, delivers new features, and makes changes on a regular basis as described in the changelog. Some issues, however, might impact many users for common use cases. These known issues are as follows:
- Cluster names: Do not use underscores (
_
) in the names of your clusters or in thekubeconfig
context for your clusters. - Istio:
- Due to a lack of support for the Istio CNI and iptables for the Istio proxy, you cannot run Istio (and therefore Gloo Mesh) on AWS Fargate. For more information, see the Amazon EKS issue.
- Due to a lack of support for the Istio CNI and iptables for the Istio proxy, you cannot run Istio (and therefore Gloo Mesh) on AWS Fargate. For more information, see the Amazon EKS issue.
- In Gloo Mesh version 2.6 and later, ambient mode requires the Solo distribution of Istio version 1.22.3 or later (
1.22.3-solo
). In Gloo Mesh version 2.7 and later, multicluster setups require the Solo distribution of Istio version 1.24.3 or later (1.24.3-solo
), including the Solo distribution ofistioctl
.
- In Istio 1.22.0-1.22.3, the
ISTIO_DELTA_XDS
environment variable must be set tofalse
. For more information, see this upstream Istio issue. Note that this issue is resolved in Istio 1.22.4.