Skip to content

Upgrade guide for Feature v10 changes #7895

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 3 commits into
base: master
Choose a base branch
from
Draft

Upgrade guide for Feature v10 changes #7895

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f59e216
Use new alpha
andreasohlund Nov 5, 2025
8259041
Fix custom claim check
andreasohlund Nov 5, 2025
9fad64c
Fix core snippets
andreasohlund Nov 5, 2025
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
4 changes: 2 additions & 2 deletions Snippets/Core/Core_10/Core_10.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@

<ItemGroup>
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.*" />
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.7" />
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.8" />
<PackageReference Include="NServiceBus.Callbacks" Version="6.0.0-alpha.2" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.2" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Encryption.MessageProperty" Version="6.0.0-alpha.2" />
<PackageReference Include="NServiceBus.Metrics.ServiceControl" Version="6.0.0-alpha.1" />
<PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.*" />
Expand Down
10 changes: 1 addition & 9 deletions Snippets/Core/Core_10/Features/AdvancedSatelliteFeature.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,6 @@
public class MyAdvancedSatelliteFeature :
Feature
{
public MyAdvancedSatelliteFeature()
{
EnableByDefault();
}

#region AdvancedSatelliteFeatureSetup

protected override void Setup(FeatureConfigurationContext context)
Expand All @@ -24,10 +19,7 @@ protected override void Setup(FeatureConfigurationContext context)
name: "CustomSatellite",
transportAddress: new QueueAddress("targetQueue"),
runtimeSettings: PushRuntimeSettings.Default,
recoverabilityPolicy: (config, errorContext) =>
{
return RecoverabilityAction.MoveToError(config.Failed.ErrorQueue);
},
recoverabilityPolicy: (config, _) => RecoverabilityAction.MoveToError(config.Failed.ErrorQueue),
onMessage: OnMessage);
}

Expand Down
8 changes: 2 additions & 6 deletions Snippets/Core/Core_10/Features/Features.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,15 +43,11 @@ protected override void Setup(FeatureConfigurationContext context)
}
}

//TODO: Change feature docs to explain how to enable features in v10
#region FeatureEnabledByDefault
public class FeatureEnabledByDefault :
Feature
{
public FeatureEnabledByDefault()
{
EnableByDefault();
}

protected override void Setup(FeatureConfigurationContext context)
{
}
Expand Down Expand Up @@ -100,7 +96,7 @@ public class EnablingOtherFeatures :
public EnablingOtherFeatures()
{
#region EnablingOtherFeatures
Defaults(s => s.EnableFeatureByDefault<OtherFeature>());
EnableByDefault<OtherFeature>();
#endregion
}

Expand Down
9 changes: 1 addition & 8 deletions Snippets/Core/Core_10/Features/SatelliteFeature.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,20 +11,13 @@
public class MySatelliteFeature :
Feature
{
public MySatelliteFeature()
{
EnableByDefault();
}
protected override void Setup(FeatureConfigurationContext context)
{
context.AddSatelliteReceiver(
name: "MyCustomSatellite",
transportAddress: new QueueAddress("targetQueue"),
runtimeSettings: PushRuntimeSettings.Default,
recoverabilityPolicy: (config, errorContext) =>
{
return RecoverabilityAction.MoveToError(config.Failed.ErrorQueue);
},
recoverabilityPolicy: (config, _) => RecoverabilityAction.MoveToError(config.Failed.ErrorQueue),
onMessage: OnMessage);
}

Expand Down
5 changes: 0 additions & 5 deletions Snippets/Core/Core_10/Pipeline/CustomForkConnector.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,6 @@ public override async Task Invoke(IIncomingPhysicalMessageContext context, Func<
public class FeatureReplacingExistingForkConnector :
Feature
{
internal FeatureReplacingExistingForkConnector()
{
EnableByDefault();
}

protected override void Setup(FeatureConfigurationContext context)
{
var pipeline = context.Pipeline;
Expand Down
5 changes: 0 additions & 5 deletions Snippets/Core/Core_10/Pipeline/CustomStageConnector.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,6 @@ public override Task Invoke(IOutgoingLogicalMessageContext context, Func<IOutgoi
public class FeatureReplacingExistingStage :
Feature
{
internal FeatureReplacingExistingStage()
{
EnableByDefault();
}

protected override void Setup(FeatureConfigurationContext context)
{
var pipeline = context.Pipeline;
Expand Down
5 changes: 0 additions & 5 deletions Snippets/Core/Core_10/Pipeline/CustomStageForkConnector.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,11 +35,6 @@ public override async Task Invoke(ITransportReceiveContext context, Func<IIncomi
public class FeatureReplacingExistingStageForkConnector :
Feature
{
internal FeatureReplacingExistingStageForkConnector()
{
EnableByDefault();
}

protected override void Setup(FeatureConfigurationContext context)
{
var pipeline = context.Pipeline;
Expand Down
11 changes: 7 additions & 4 deletions Snippets/DataBus/DataBus_2/ClaimCheck/Custom/Definition.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,15 @@
namespace ClaimCheck_2.ClaimCheck.Custom;
using Microsoft.Extensions.DependencyInjection;

namespace ClaimCheck_2.ClaimCheck.Custom;

using System;
using NServiceBus.ClaimCheck;

#region CustomDataBusDefinition
class CustomClaimCheckDefinition : ClaimCheckDefinition
{
protected override Type ProvidedByFeature()
=> typeof(CustomClaimCheckFeature);
protected override void ConfigureServices(IServiceCollection services)
{
services.AddSingleton<IClaimCheck, CustomClaimCheck>();
}
}
#endregion
18 changes: 0 additions & 18 deletions Snippets/DataBus/DataBus_2/ClaimCheck/Custom/Feature.cs
View file
Open in desktop

This file was deleted.

2 changes: 1 addition & 1 deletion Snippets/DataBus/DataBus_2/ClaimCheck_2.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
</ItemGroup>

<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.2" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>

</Project>
2 changes: 1 addition & 1 deletion Snippets/FileShareDataBus/DataBus_2/DataBus_2.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,6 @@
<TargetFramework>net10.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.2" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion ...-storage-databus-cleanup-function/ABSDataBus_7/SenderAndReceiver/SenderAndReceiver.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.DataBus.AzureBlobStorage" Version="7.0.0-alpha.1" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
</ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/blob-storage-databus/ABSDataBus_7/Shared/Shared.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion samples/databus/custom-serializer/DataBus_2/Receiver/Receiver.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<ProjectReference Include="..\Shared\Shared.csproj" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion samples/databus/custom-serializer/DataBus_2/Sender/Sender.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<ProjectReference Include="..\Shared\Shared.csproj" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion samples/databus/custom-serializer/DataBus_2/Shared/Shared.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,6 @@
<PackageReference Include="Newtonsoft.Json" Version="13.*" />
<PackageReference Include="Newtonsoft.Json.Bson" Version="1.*" />
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion samples/databus/databus-custom-serializer-converter/DataBus_2/Receiver/Receiver.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<ProjectReference Include="..\Shared\Shared.csproj" />
</ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/databus-custom-serializer-converter/DataBus_2/Sender/Sender.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<ProjectReference Include="..\Shared\Shared.csproj" />
</ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/databus-custom-serializer-converter/DataBus_2/Shared/Shared.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,6 @@
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion samples/databus/file-share-databus/DataBus_2/Receiver/Receiver.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<ProjectReference Include="..\Shared\Shared.csproj" />
</ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/file-share-databus/DataBus_2/Sender/Sender.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<ProjectReference Include="..\Shared\Shared.csproj" />
</ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/file-share-databus/DataBus_2/Shared/Shared.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@
</PropertyGroup>
<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>
</Project>
2 changes: 1 addition & 1 deletion samples/databus/redis/Core_10/Receiver/Receiver.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>

<ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/redis/Core_10/Sender/Sender.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>

<ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion samples/databus/redis/Core_10/Shared/Shared.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<PackageReference Include="StackExchange.Redis" Version="2.*" />
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.1" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.1" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
</ItemGroup>

</Project>
2 changes: 1 addition & 1 deletion samples/unobtrusive/Core_10/Client/Client.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.4" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.2" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.2" />
</ItemGroup>

Expand Down
2 changes: 1 addition & 1 deletion samples/unobtrusive/Core_10/Server/Server.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

<ItemGroup>
<PackageReference Include="NServiceBus" Version="10.0.0-alpha.4" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.2" />
<PackageReference Include="NServiceBus.ClaimCheck" Version="2.0.0-alpha.3" />
<PackageReference Include="NServiceBus.Extensions.Hosting" Version="4.0.0-alpha.2" />
</ItemGroup>

Expand Down
Loading