pre-release: v2.11.0-beta.1

[rustatian]

Reason for This PR

• pre-release cycle.

Description of Changes

👀 New:

• ✏️ [BETA]: RoadRunner: Can now be embedded in other go programs. PR, (thanks @khepin)
• ✏️ gRPC Plugin: Implement Google's gRPC errors API. An exception might be passed as a Status structure in the Metadata (key - error) to be parsed and returned to the user w/o worker restart. NOTE: Status structure should be marshaled via proto marshaller, not json. FR
• ✏️ gRPC Plugin: gRPC reflection server. Docs: https://roadrunner.dev/docs/app-server-grpc/2.x/en, GoDocs.
• ✏️ Logger Plugin: Get rid of the context deadline exceeded error on worker's allocation. We updated the error message with the link to the docs with the most common causes for the worker allocation failed error: https://roadrunner.dev/docs/known-issues-allocate-timeout/2.x/en. Feel free to add your cases here :)

The reflection server might be activated to use grpc_cli, grpc-curl, grpc-ui, or similar tools to intercept grpc payloads.

Configuration:

grpc:
  listen: "tcp://localhost:9001"

  # GRPC reflection server [SINCE 2.11]
  #
  # This option is optional. The reflection server might be activated to use `grpc_cli`, `grpc-ui`, `grpc-curl`, or similar tools to intercept grpc payloads.
  enable_reflection_server: false
  proto:
    - "first.proto"
    - "second.proto"

License Acceptance

By submitting this pull request, I confirm that my contribution is made under the terms of the MIT license.

PR Checklist

[Author TODO: Meet these criteria.]
[Reviewer TODO: Verify that these criteria are met. Request changes if not]

• All commits in this PR are signed (git commit -s).
• The reason for this PR is clearly provided (issue no. or explanation).
• The description of changes is clear and encompassing.
• Any required documentation changes (code and docs) are included in this PR.
• Any user-facing changes are mentioned in CHANGELOG.md.
• All added/changed functionality is tested.

[codecov]

Codecov Report

Merging #1216 (f6e44d6) into master (0bdc25e) will increase coverage by 0.23%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master    #1216      +/-   ##
==========================================
+ Coverage   44.89%   45.12%   +0.23%     
==========================================
  Files          14       14              
  Lines         715      718       +3     
==========================================
+ Hits          321      324       +3     
  Misses        367      367              
  Partials       27       27              

Impacted Files	Coverage Δ
internal/debug/server.go	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0bdc25e...f6e44d6. Read the comment docs.

[khepin]

Been able to integrate this into our embedded apps with no problem. 👍

[rustatian]

Brilliant, thanks 👍🏻
One small note, please, use the -race flag to build your app (at least for testing). I suspect that there might be race conditions.

[khepin]

Not too familiar with that flag, but building our app with build -race ... builds with no issues

[rustatian]

Not too familiar with that flag, but building our app with build -race ... builds with no issues

Np, you may have a look at this article: https://go.dev/doc/articles/race_detector

You need to build and run your app to be sure that there are no data races. It will work slower than usual during the testing.

[khepin]

Was able to build and run with -race and test the code paths we've implemented. Not getting any data race report so all looks good.