Skip to content

Opensearch-py and Opensearch-java gRPC transparent support documentation- #12873 - #12872

Open
dayana-j wants to merge 5 commits into
opensearch-project:mainfrom
dayana-j:grpc_python
Open

Opensearch-py and Opensearch-java gRPC transparent support documentation- #12873#12872
dayana-j wants to merge 5 commits into
opensearch-project:mainfrom
dayana-j:grpc_python

Conversation

@dayana-j

@dayana-j dayana-j commented Jul 28, 2026

Copy link
Copy Markdown

Description

Adds documentation for the opensearch-py client's gRPC transport, which routes bulk ingestion and ML streaming over gRPC for improved performance while automatically falling back to REST for all other operations. It also adds documentation for the new opensearch-java gRPC transport module, which provides transparent gRPC support for the OpenSearch Java client. Covers installation, client setup with OpenSearchGrpc, TLS/mTLS configuration, and authentication methods (basic auth, JWT bearer tokens, and AWS SigV4). Also adds cross-references to the Python and java client in the gRPC APIs index, JWT authentication, and TLS configuration pages.

Version

OpenSearch version 3.0 and later (gRPC transport module transport-grpc available since OpenSearch 3.0)

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

@github-actions

Copy link
Copy Markdown

Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Merged.

Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer.

When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference).

@github-actions github-actions Bot added the In progress Issue/PR: The issue or PR is in progress. label Jul 28, 2026
@dayana-j dayana-j changed the title Grpc python Opensearch-py gRPC transparent support documentation- #12873 Jul 28, 2026
@dayana-j dayana-j changed the title Opensearch-py gRPC transparent support documentation- #12873 Opensearch-py and Opensearch-java gRPC transparent support documentation- #12873 Jul 28, 2026
New pages:
- _clients/java-grpc.md: Java gRPC transport (HybridTransport, TLS,
  basic auth, JWT, AWS SigV4, GrpcTransportOptions, examples)
- _clients/python-grpc.md: Python gRPC transport (OpenSearchGrpc,
  basic auth, AWS SigV4, bulk operations, server config)

Updated pages:
- _clients/index.md: Added gRPC transport links for both Java and Python
- _clients/java.md: Added section pointing to Java gRPC transport
- _clients/python-low-level.md: Added section pointing to Python gRPC transport
- _api-reference/grpc-apis/index.md: Added both Java and Python as
  transparent client transports (recommended approach)
- _api-reference/grpc-apis/bulk.md: Added transparent client example

Signed-off-by: Dayana Jean <jeadayao@amazon.com>
@dayana-j
dayana-j marked this pull request as ready for review July 29, 2026 18:13
@github-actions github-actions Bot added Tech review PR: Tech review in progress and removed In progress Issue/PR: The issue or PR is in progress. labels Jul 29, 2026
Comment thread _api-reference/grpc-apis/bulk.md Outdated
Comment thread _clients/java-grpc.md Outdated
Comment thread _clients/java-grpc.md Outdated
Comment thread _clients/java-grpc.md
Comment thread _clients/java-grpc.md
Comment thread _clients/java-grpc.md Outdated
Signed-off-by: Dayana Jean <jeadayao@amazon.com>
Signed-off-by: Dayana Jean <jeadayao@amazon.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 3.8 Tech review PR: Tech review in progress

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants