Doc idea: gRPC how do diagnosis gRPC errors AND how to config HTTP/2 in Docker - Githubissues

dotnet / AspNetCore.Docs

Documentation for ASP.NET Core

https://docs.microsoft.com/aspnet/core

Creative Commons Attribution 4.0 International

12.64k stars 25.29k forks source link

Doc idea: gRPC how do diagnosis gRPC errors AND how to config HTTP/2 in Docker #33112

Open Rick-Anderson opened 3 months ago

Rick-Anderson commented 3 months ago

Description

See #5691 The information in #5691 probably needs to go into two docs

Troubleshooting gRPC errors via this comment and this
Find a doc to explain the correct configuration documented here

@wisamidris7 @JamesNK please advise the articles this information should go in.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/grpc/?view=aspnetcore-8.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/grpc/index.md

Document ID

048d1977-93aa-f28a-60ec-6806dec3f70a

Article author

@JamesNK

Associated WorkItem - 291117

JamesNK commented 3 months ago

The problem for this user was content negotiation: https://learn.microsoft.com/en-us/aspnet/core/grpc/aspnetcore?view=aspnetcore-8.0&tabs=visual-studio#protocol-negotiation

There is nothing specific about docker to their problem. They just happened to be using TLS locally (which did content negotiation) and not use it in Docker.

Possible changes?

A trouble shooting section that mentions HTTP_1_1_REQUIRED that links to the protocol negotiation section could be added.
Adding more detail to the protocol negotiation about what changes are required rather than just linking to Kestrel docs.