Skip to content
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.

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

Add RabbitMQ.Client v7 client integration package #6770

Merged
merged 11 commits into from
Jan 13, 2025

Conversation

eerhardt
Copy link
Member

@eerhardt eerhardt commented Nov 22, 2024

Description

RabbitMQ.Client shipped a version 7.0.0 that has major breaking changes. Specifically, it removed all sync APIs and only contain async APIs. To continue supporting new versions of RabbitMQ.Client, we need to add a new component Aspire.RabbitMQ.Client.v7 that will work with the new version of RabbitMQ.Client. See #3956 for the strategy to deal with these breaking changes.

Fix #3956

Checklist

  • Is this feature complete?
    • Yes. Ready to ship.
  • Are you including unit tests for the changes and scenario tests if relevant?
    • Yes
  • Did you add public API?
    • Yes
      • If yes, did you have an API Review for it?
        • No
      • Did you add <remarks /> and <code /> elements on your triple slash comments?
        • Yes
  • Does the change make any security assumptions or guarantees?
    • No
  • Does the change require an update in our Aspire docs?
Microsoft Reviewers: Open in CodeFlow

@danmoseley
Copy link
Member

So from now on, folks that want to use latest will need to pick package named v7, and to use a future v8 rabbitmq they'll need to pick the package named v7 as well. So we have the v7 name indefinitely, if I understand right. Is it worth instead the breaking change to do the reverse, freeze the existing package renaming it v6?

@eerhardt
Copy link
Member Author

So from now on, folks that want to use latest will need to pick package named v7, and to use a future v8 rabbitmq they'll need to pick the package named v7 as well. So we have the v7 name indefinitely, if I understand right. Is it worth instead the breaking change to do the reverse, freeze the existing package renaming it v6?

See #3956 for the strategy to deal with these breaking changes.

@danmoseley
Copy link
Member

danmoseley commented Nov 22, 2024

Yeah I already read that and I was confused so I asked 🙂

When .NET Aspire 9 ships, we can "swap" the dependencies around.
The Aspire.RabbitMQ.Client package will be updated to depend on version 7 of RabbitMQ.Client

I don't think this change did this?
.

If RabbitMQ.Client v6 is still in support, we can create Aspire.RabbitMQ.Client.v6 which has the dependency limit [6.8.1, 7.0.0) and works with the version 6 of RabbitMQ.Client.

We didn't do this either.

What am I missing?

@eerhardt
Copy link
Member Author

When .NET Aspire 9 ships, we can "swap" the dependencies around.
The Aspire.RabbitMQ.Client package will be updated to depend on version 7 of RabbitMQ.Client

I don't think this change did this? .

At the time that issue was written (in April), we were assuming RabbitMQ.Client v7 would ship before .NET Aspire 9. The general strategy is "on the next major version of .NET Aspire". So we will do the "swap" when .NET Aspire 10 ships since RabbitMQ.Client v7 and .NET Aspire 9 shipped at basically the same time.

If RabbitMQ.Client v6 is still in support, we can create Aspire.RabbitMQ.Client.v6 which has the dependency limit [6.8.1, 7.0.0) and works with the version 6 of RabbitMQ.Client.

We didn't do this either.

This would be done at the time of the "swap" (i.e. .NET Aspire 10) if RabbitMQ.Client v6 is still in support and used by customers.

@eerhardt
Copy link
Member Author

eerhardt commented Jan 3, 2025

/azp run

Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@eerhardt
Copy link
Member Author

eerhardt commented Jan 6, 2025

@radical @sebastienros - this is now ready for review.

The only thing left undone is that we should be using the AspNetCore.HealthChecks.Rabbitmq.v6 NuGet package in Aspire.RabbitMQ.Client, but that package wasn't published as part of the 9.0.0 HealthChecks release. See Xabaril/AspNetCore.Diagnostics.HealthChecks#2358.

We are using the 8.x package for now.

We are now using the correct packages with the latest updates.

@eerhardt eerhardt enabled auto-merge (squash) January 13, 2025 18:49
@eerhardt eerhardt merged commit a7eb855 into dotnet:main Jan 13, 2025
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

RabbitMQ.Client v7 breaks Aspire.RabbitMQ.Client component
3 participants