Feature: Golang Http Tcp Bridge

[duxin40]

As mentioned in the proposal: #35749 , this PR is to support using Golang to extend TCP upstream proxy, to make changes to connections and data messages in the http2tcp situation of envoy.
(this PR does)

Here is my thought about Golang extension function points:

1. Support encoding message processing for upstream TCP requests (route and cluster have been determined, and targeted message processing can be performed for route and cluster)
2. Support the handling of conn connection status during the encoding stage of upstream TCP requests (for example, by setting end_stream=false to avoid envoy semi connected status)
3. Support decoding message processing and aggregation for upstream TCP response in onUpstreamData.(for example, by setting end_stream=true to indicate that the message is encapsulated and can be passed to downstream)
4. Aggregate the tcp messages received multiple times by onUpstreamData of tcp response.
5. Support obtaining route and cluster information, which can be referenced for targeted processing in the above stages.

What we can do with this Golang extension:

With this golang extension, developers can quickly get started with envoy and use golang to implement http2tcp such as http2dubbo、http2rpc.

Commit Message: support Golang TCP Upstream Extension for http2tcp on Envoy
Additional Description:
Risk Level:
Testing:
Docs Changes:
Release Notes:
Platform Specific Features:
[Optional Runtime guard:]
[Optional Fixes #Issue]
[Optional Fixes commit #PR or SHA]
[Optional Deprecated:]
[Optional API Considerations:]

[repokitteh-read-only]

As a reminder, PRs marked as draft will not be automatically assigned reviewers,
or be handled by maintainer-oncall triage.

Please mark your PR as ready when you want it to be reviewed!

🐱

Caused by: #36667 was opened by duxin40.

see: more, trace.

[duxin40]

I will add unit tests for these codes and fix errors related to unit tests.

[duxin40]

@doujiang24 could you take a look and check if the direction looks good? thanks!

[tyxia]

/assign @doujiang24

Per discussion in #35749

[repokitteh-read-only]

@duxin40 cannot be assigned to this issue.

🐱

Caused by: a #36667 (comment) was created by @tyxia.

see: more, trace.

[doujiang24]

Better add a simple example that use Golang to implement http => TCP protocol, to show how it could be for users for easier understanding.
It do not need to be runable, just a demo.

[duxin40]

Better add a simple example that use Golang to implement http => TCP protocol, to show how it could be for users for easier understanding. It do not need to be runable, just a demo.

Done. in the dir: contrib/upstreams/http/tcp/test_data/http2dubbo-examples

[doujiang24]

ditto, we'd better golang convert trailers to data buffer, but we can just add a TODO for it now, it's not a common use case.

[duxin40]

got it, will finish it in the near future.

[doujiang24]

/docs

[repokitteh-read-only]

Docs for this Pull Request will be rendered here:

https://storage.googleapis.com/envoy-pr/36667/docs/index.html

The docs are (re-)rendered each time the CI envoy-presubmit (precheck docs) job completes.

🐱

Caused by: a #36667 (comment) was created by @doujiang24.

see: more, trace.

[doujiang24]

@duxin40 Thank you so much for your hard work and patience.

Please run the tests in the asan mode, in your local dev, here is the command from my side:

ENVOY_DOCKER_BUILD_DIR=/path/to/envoy-bazel-cache \
GOPROXY='https://goproxy.cn' \
    bash -x ci/run_envoy_docker.sh 'bash -x ci/do_ci.sh asan'

It's so good enough to merge from my side.

@mattklein123 @wbpcode could you please take another look at this PR.
It is a bit large, but it's also a very important feature to extend HTTP <-> RPC.

[repokitteh-read-only]

Docs for this Pull Request will be rendered here:

https://storage.googleapis.com/envoy-pr/36667/docs/index.html

The docs are (re-)rendered each time the CI envoy-presubmit (precheck docs) job completes.

🐱

Caused by: a #36667 (comment) was created by @duxin40.

see: more, trace.

[repokitteh-read-only]

CC @envoyproxy/api-shepherds: Your approval is needed for changes made to (api/envoy/|docs/root/api-docs/).
envoyproxy/api-shepherds assignee is @mattklein123
CC @envoyproxy/api-watchers: FYI only for changes made to (api/envoy/|docs/root/api-docs/).

🐱

Caused by: #36667 was synchronize by duxin40.

see: more, trace.

[phlax]

thanks for working on this @duxin40

[phlax]

it this still required? afaict this uses the same deps that have been merged, surely we can use an existing go.mod?

[duxin40]

/retest

[mattklein123]

I don't have time to review this giant PR. Will merge once @doujiang24 and @phlax give the ok.

/wait-any