You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/grpc-compatibility.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
Connect-Python currently does not support the gRPC protocol due to lack of support for HTTP/2 trailers
4
4
in the Python ecosystem. If you have an existing codebase using grpc-python and want to introduce Connect
5
5
in a transition without downtime, you will need a way for the gRPC servers to be accessible from both
6
-
gRPC and Connect clients at the same time. envoy is a widely used proxy server with support for translating
6
+
gRPC and Connect clients at the same time. Envoy is a widely used proxy server with support for translating
7
7
the Connect protocol to gRPC via the [Connect-gRPC Bridge](https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/connect_grpc_bridge_filter).
8
8
9
9
For example, if you have a gRPC server currently listening on port 8080, you update it to use port 8081
@@ -66,18 +66,18 @@ static_resources:
66
66
max_concurrent_streams: 100
67
67
```
68
68
69
-
Refer to [envoy docs](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/security/ssl) for more configuration such
69
+
Refer to [Envoy docs](https://www.envoyproxy.io/docs/envoy/latest/intro/arch_overview/security/ssl) for more configuration such
70
70
as TLS.
71
71
72
72
## Migration
73
73
74
-
Migrating from grpc-python to Connect using envoy largely involves first adding envoy in front of the server,
75
-
then migrating clients to Connect, and finally migrating servers to Connect and removing envoy.
74
+
Migrating from grpc-python to Connect using Envoy largely involves first adding Envoy in front of the server,
75
+
then migrating clients to Connect, and finally migrating servers to Connect and removing Envoy.
76
76
77
77
The general code structure of grpc-python and Connect are very similar - if your code is configured to use a
78
78
type checker, any changes to parameter names and such should be quite easy to spot.
79
79
80
-
1. Reconfigure your gRPC servers to include envoy in front of the server port with a config similar to above.
80
+
1. Reconfigure your gRPC servers to include Envoy in front of the server port with a config similar to above.
81
81
For cloud deployments, this often means using functionality for sidecar containers.
82
82
83
83
1. Begin generating code with `protoc-gen-connect-python`.
@@ -94,5 +94,5 @@ type checker, any changes to parameter names and such should be quite easy to sp
94
94
to have type checking find differences in method names. Change uses of `abort` to directly `raise ConnectError` -
95
95
for Connect services, it will be uncommon to pass the `RequestContext` into business logic code.
96
96
97
-
1. Reconfigure server deployment to remove the envoy proxy and deploy. You're done! You can stop generating code with
97
+
1. Reconfigure server deployment to remove the Envoy proxy and deploy. You're done! You can stop generating code with
0 commit comments