Skip to content
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): GA gRPC client #10859

Open
wants to merge 9 commits into
base: main
Choose a base branch
from
Open

feat(storage): GA gRPC client #10859

wants to merge 9 commits into from

Conversation

frankyn
Copy link
Member

@frankyn frankyn commented Sep 12, 2024

  • Pending zero-copy improvements from @tritone

@product-auto-label product-auto-label bot added the api: storage Issues related to the Cloud Storage API. label Sep 12, 2024
@frankyn frankyn changed the title docs(storage): remove gRPC experimental wording docs(storage): GA gRPC client Sep 12, 2024
@frankyn frankyn marked this pull request as ready for review September 12, 2024 22:52
@frankyn frankyn requested review from a team as code owners September 12, 2024 22:52
Copy link
Contributor

@tritone tritone left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few docs nits, otherwise looks good. Let's wait to submit this until after zerocopy changes have been merged.

storage/doc.go Outdated
allowlist to access this API. The Go Storage gRPC library is not yet generally
available, so it may be subject to breaking changes.
This package includes support for the Cloud Storage gRPC API. The
implementation uses gRPC rather than the current
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/current/default

storage/doc.go Outdated
This package includes support for the Cloud Storage gRPC API. The
implementation uses gRPC rather than the current
JSON & XML APIs to make requests to Cloud Storage.
The Go Storage gRPC library is generally available.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/library/client.

storage/doc.go Outdated
warn that Direct Google Access could not be initialized. Direct Google Access
is not required to access the gRPC API.
Using the gRPC API inside GCP with a bucket in the same region can allow direct
connectivity (enabling requests to skip Google Front Ends (GFEs) and reducing
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Google Front Ends is another term without public docs, I would revert to the original wording here and just add the link for the (new?) DP docs. No need to duplicate more information here.

@frankyn frankyn added status: blocked Resolving the issue is dependent on other work. do not merge Indicates a pull request not ready for merge, due to either quality or timing. labels Sep 13, 2024
Copy link
Member

@codyoss codyoss left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we make this a feat so it shows up in release notes as a new feature?

@frankyn frankyn changed the title docs(storage): GA gRPC client feat(storage): GA gRPC client Sep 13, 2024
@frankyn
Copy link
Member Author

frankyn commented Sep 13, 2024

Thanks @codyoss updated PR name to feat; I think it makes sense so it's in release notes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api: storage Issues related to the Cloud Storage API. do not merge Indicates a pull request not ready for merge, due to either quality or timing. status: blocked Resolving the issue is dependent on other work.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants