●Change8

Migrating to Consul Connect ent-changelog-1.12.0

Version ent-changelog-1.12.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 12/2/2025

2
Breaking Changes
3
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

sdk testutil configuration structsconsul.http... metricsPermissionDeniedErrorsConfigEntry.ResolveServiceConfig RPCSTSRegion

Breaking Changes

●Issue #1

sdk: The testutil configuration structs were modified: `ACLMasterToken` was removed, and `Master` was renamed to `InitialManagement`, and `AgentMaster` was renamed to `AgentRecovery`.

●Issue #2

telemetry: The `disable_compat_1.9` option now defaults to true. Consumers relying on 1.9 style `consul.http...` metrics must explicitly set `disable_compat_1.9 = false`. These metrics will be removed in 1.13.

Migration Steps

  1. 1
    If you use testutil configuration structs, update them to remove `ACLMasterToken` and rename `Master` to `InitialManagement` and `AgentMaster` to `AgentRecovery`.
  2. 2
    If you rely on 1.9 style `consul.http...` metrics, set `disable_compat_1.9 = false` in your configuration or CLI flags to keep them enabled temporarily; be aware they will be removed in 1.13.
  3. 3
    If using AWS IAM auth method configuration, note that the `STSRegion` field was removed from the auth method config.

Release Summary

This release introduces significant features like AWS IAM Auth method support, per-listener TLS configuration, and auto-reloading of configuration files. It also includes several breaking changes in testutil structs and telemetry defaults.

Need More Details?

View the full release notes and all changes for Consul Connect ent-changelog-1.12.0.

View Full Changelog