Navigation :

Changelog

Review the changelog for Gloo Platform releases.

You must always upgrade the Gloo management server before upgrading the Gloo agent to avoid unexpected behavior. Note that only n-1 minor version skew is supported between the management server and the agent. For more information, see the Skew policy. For upgrade instructions, see Upgrade Gloo Mesh.

Changelog entry types

Changelog entries are categorized into the following types:

Dependency Bumps: The version for a dependency in Gloo Platform is bumped in this release. Be sure to check for any Breaking Change entries that accompany a dependency bump.
Breaking Changes: An API is changed in a way that is not backwards compatible, such as a changed format for an API field. Occasionally, a breaking change occurs for the process to upgrade Gloo, in which the changelog entry indicates how to use the new upgrade process.
Helm Changes: The installation Helm chart is changed. If this change is not backwards compatible, an accompanying Breaking Change entry is indicated for the release.
New Features: A new feature is implemented in the release.
Fixes: A bug is resolved in this release.

Installation changes

In addition to comparing differences across versions in the changelog, review the following installation changes from previous versions to version 2.4.

Global workspace during installation: Previously, single cluster installation profiles included a global workspace and workspace settings by default. In version 2.4, you can use the glooMgmtServer.createGlobalWorkspace=true setting in the Helm chart, or create a workspace manually after installation.
OTel collector installation: Previously, to set the endpoint during the OTel collector installation, you might have escaped quotations such as endpoint: "\"${ENDPOINT_TELEMETRY_GATEWAY}\"". Now, the syntax is simplified so that you have can enter endpoint: "${ENDPOINT_TELEMETRY_GATEWAY}", such as in the following example.
```
telemetryCollector:
  enabled: true
  config:
    exporters:
      otlp:
        endpoint: "${ENDPOINT_TELEMETRY_GATEWAY}"
```

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 the kubeconfig context for your clusters.
OTel pipeline: FIPS-compliant builds are not currently supported for the OTel collector agent image.

Changelog

Show Open Source Notes