Skip to content

Document IPC transport limitations for gRPC client-side load balancing and connectivity state#37317

Merged
wadepickett merged 2 commits into
mainfrom
copilot/update-grpc-unix-sockets-doc
Jul 8, 2026
Merged

Document IPC transport limitations for gRPC client-side load balancing and connectivity state#37317
wadepickett merged 2 commits into
mainfrom
copilot/update-grpc-unix-sockets-doc

Conversation

Copilot AI commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Fixes #35871

The gRPC inter-process communication docs don't mention that IPC transports rely on SocketsHttpHandler.ConnectCallback, which disables client-side load balancing and connectivity state tracking. Users hit an opaque InvalidOperationException with no guidance. Per maintainer feedback, the note belongs on the shared xref:grpc/interprocess page since it applies to both Unix domain sockets and named pipes.

Changes

  • Added a [!WARNING] block to aspnetcore/grpc/interprocess.md (Configure client and server section) covering:
    • Why the limitation exists (ConnectCallback requirement for custom endpoints).
    • Unavailable features: ServiceConfig.LoadBalancingConfigs, GrpcChannel.State, GrpcChannel.WaitForStateChangedAsync.
    • The InvalidOperationException text users encounter.
  • Used code-style backticks rather than <xref:> for the Grpc.Net.Client APIs, since those types ship in the third-party grpc-dotnet package and aren't verifiable in the xref index.
  • Updated ms.date and added ai-usage: ai-assisted metadata.

Internal previews

📄 File 🔗 Preview link
aspnetcore/grpc/interprocess.md aspnetcore/grpc/interprocess

@wadepickett

Copy link
Copy Markdown
Contributor

Fixes #35871

Copilot AI changed the title [WIP] Update gRPC and Unix domain sockets doc to include supportability warnings Document IPC transport limitations for gRPC client-side load balancing and connectivity state Jul 7, 2026
Copilot AI requested a review from wadepickett July 7, 2026 00:39
@wadepickett wadepickett marked this pull request as ready for review July 7, 2026 19:20
@wadepickett wadepickett requested a review from JamesNK July 7, 2026 22:26
@wadepickett wadepickett merged commit 7d25401 into main Jul 8, 2026
4 checks passed
@wadepickett wadepickett deleted the copilot/update-grpc-unix-sockets-doc branch July 8, 2026 16:08
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.

The gRPC and Unix domain sockets doc lacks warnings about supportability

3 participants