diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 9311bde8ae2..928f096364f 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -21,8 +21,9 @@ env: AZURITE_IMAGE: mcr.microsoft.com/azure-storage/azurite:3.35.0@sha256:647c63a91102a9d8e8000aab803436e1fc85fbb285e7ce830a82ee5d6661cf37 EVENTHUBS_EMULATOR_IMAGE: mcr.microsoft.com/azure-messaging/eventhubs-emulator:2.2.0@sha256:2c8e0d4dd93a5fc078df2721eeb3e211442d555d61293ac3972df931c6d9333a COSMOSDB_EMULATOR_IMAGE: mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-EN20260907@sha256:2db1f9e74c506bcf6fc347aa937aea1c00fa756061296a5a9efba530ce86ec02 - CONSUL_IMAGE: mirror.gcr.io/hashicorp/consul:1.19@sha256:e244c64df77ab3586f177f1692e98575086eb40343dc82a6320f5e79543490eb - CONSUL_FALLBACK_IMAGE: docker.io/hashicorp/consul:1.19@sha256:e244c64df77ab3586f177f1692e98575086eb40343dc82a6320f5e79543490eb + # Consul 1.22+ accepts the ':' and '@' characters in Orleans silo-address keys. + CONSUL_IMAGE: mirror.gcr.io/hashicorp/consul:1.22.7@sha256:a230dcea0bb107bd7958a912d1429fb7f9d399637de7ffb814b34412b9e8c543 + CONSUL_FALLBACK_IMAGE: docker.io/hashicorp/consul:1.22.7@sha256:a230dcea0bb107bd7958a912d1429fb7f9d399637de7ffb814b34412b9e8c543 DYNAMODB_IMAGE: amazon/dynamodb-local:latest ELASTICMQ_IMAGE: softwaremill/elasticmq-native:latest # Keep in sync with SeaweedFSTestContainer diff --git a/docs/site/src/content/docs/host/configuration-guide/clustering/consul.md b/docs/site/src/content/docs/host/configuration-guide/clustering/consul.md index d49931a6620..c582e556906 100644 --- a/docs/site/src/content/docs/host/configuration-guide/clustering/consul.md +++ b/docs/site/src/content/docs/host/configuration-guide/clustering/consul.md @@ -1,7 +1,7 @@ --- title: Configure Consul clustering description: Configure Orleans silos and clients to use Consul for cluster membership and gateway discovery. -ms.date: 08/08/2026 +ms.date: 10/03/2026 ms.topic: how-to --- @@ -9,6 +9,8 @@ ms.topic: how-to Use the [`Microsoft.Orleans.Clustering.Consul`](https://www.nuget.org/packages/Microsoft.Orleans.Clustering.Consul) package to store Orleans membership records in the [Consul key/value store](https://developer.hashicorp.com/consul/docs/dynamic-app-config/kv). +Use Consul 1.22 or later. Orleans silo-address keys contain `:` and `@`, which Consul 1.21.5 rejects with its default key filter. When upgrading an existing Consul 1.21.5 deployment, temporarily enable [`disable_http_unprintable_char_filter`](https://developer.hashicorp.com/consul/docs/v1.21.x/reference/agent/configuration-file/general#disable_http_unprintable_char_filter) until the deployment reaches Consul 1.22 or later. + Every silo and client in a cluster must use: - The same Consul cluster and key/value root. diff --git a/test/Extensions/Orleans.Clustering.Consul.Tests/ConsulTestUtils.cs b/test/Extensions/Orleans.Clustering.Consul.Tests/ConsulTestUtils.cs index 9df2f82074c..63e80b20075 100644 --- a/test/Extensions/Orleans.Clustering.Consul.Tests/ConsulTestUtils.cs +++ b/test/Extensions/Orleans.Clustering.Consul.Tests/ConsulTestUtils.cs @@ -24,7 +24,7 @@ public static class ConsulTestUtils private static readonly ConsulContainer _container = new ConsulBuilder( Environment.GetEnvironmentVariable("CONSUL_IMAGE") - ?? "mirror.gcr.io/hashicorp/consul:1.19@sha256:e244c64df77ab3586f177f1692e98575086eb40343dc82a6320f5e79543490eb") + ?? "mirror.gcr.io/hashicorp/consul:1.22.7@sha256:a230dcea0bb107bd7958a912d1429fb7f9d399637de7ffb814b34412b9e8c543") .WithCreateParameterModifier(parameters => { if (parameters.HostConfig is not null && !IsWindowsDockerDaemon())