[public api] Enable gRPC reflection

[andrew-farries]

Description

• Add a WithReflection option to baseserver to allow enabling gRPC reflection.
• Use WithReflection in the public API server.

EDIT: No WithReflection option in the baseserver anymore; it's just enabled with no option to toggle. See this comment.

Enabling reflection in the public api makes the API more discoverable and self documenting for consumers.

It also makes it easier for engineers to work with the API in development (using tools such as grpcurl and evans).

Related Issue(s)

Part of #7900

How to test

1. Run the public-api-server:

cd components/public-api-server
go run .

2. Use a gRPC CLI like evans to discover the services exposed by the API:

evans -p 9501 -r repl

Release Notes

Enable gRPC reflection for the public API

Documentation

None

[easyCZ]

Imo, just enable it by default without the option. If we do end up needing configuration, we can always add it.

[jenting]

/werft run

👍 started the job as gitpod-build-af-enable-reflection-in-public-api-server.1
(with .werft/ from main)

[andrew-farries]

Imo, just enable it by default without the option. If we do end up needing configuration, we can always add it.

Done and rebased (and updated the PR description).