Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -1,14 +1,16 @@
---
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
---

# Configure Consul clustering

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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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())
Expand Down
Loading