-
Notifications
You must be signed in to change notification settings - Fork 1.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat(storage): add direct google access side-effect imports by default #10757
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just some docs suggestions, otherwise LGTM. Nice solution!
storage/doc.go
Outdated
_ "google.golang.org/grpc/balancer/rls" | ||
_ "google.golang.org/grpc/xds/googledirectpath" | ||
) | ||
If the application is running within GCP, users may get better performance with Direct Google Access (enabling requests to skip some proxy steps). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Let's rephrase this; users don't need to opt-in to Direct Google Access anymore so I don't think this is relevant.
How about:
Using the gRPC API inside GCP with a bucket in the same region can allow for Direct Google Access (enabling requests to skip some proxy steps and reducing response latency).
Also, will a warning be emitted if direct path is attempted and fails? If so we should explain this as well.
storage/doc.go
Outdated
) | ||
If the application is running within GCP, users may get better performance with Direct Google Access (enabling requests to skip some proxy steps). | ||
|
||
Dependencies for Direct Google Access can increase the size of resulting binary by ~16MiB if not used by another dependency and you can opt-out of these dependencies using build tag `disable_grpc_modules`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This seems a little ambiguous as to who wants to use this build tag. I'd say something like:
Dependencies for the gRPC API may slightly increase the size of binaries for applications depending on this package. If you are not using gRPC, you can use the build tag
disable_grpc_modules
to opt out of these dependencies and reduce the binary size.
Add side-effect modules for gRPC DirectPath by default with an opt-out build tag:
disable_grpc_modules
GOOGLE_CLOUD_ENABLE_DIRECT_PATH_XDS=true