This is an automated email from the ASF dual-hosted git repository.
ndipiazza pushed a commit to branch TIKA-4578
in repository https://gitbox.apache.org/repos/asf/tika.git
The following commit(s) were added to refs/heads/TIKA-4578 by this push:
new 07ed0d16b Document relationship between tika-grpc Maven builds and
tika-grpc-docker
07ed0d16b is described below
commit 07ed0d16bb1559d4bf8d52c9119d71321130a0cc
Author: Nicholas DiPiazza <[email protected]>
AuthorDate: Fri Dec 26 12:49:31 2025 -0600
Document relationship between tika-grpc Maven builds and tika-grpc-docker
- Add section to docker-build/README.md explaining when to use Maven builds
(development/testing) vs tika-grpc-docker (production/releases)
- Clarify that tika-grpc-docker will use GPG-signed releases post-4.0.0
- Add note to tika-grpc/README.md directing users to tika-grpc-docker for
production deployments
- Improves clarity for developers and operators on which build method to use
---
tika-grpc/README.md | 2 ++
tika-grpc/docker-build/README.md | 19 ++++++++++++++++++-
2 files changed, 20 insertions(+), 1 deletion(-)
diff --git a/tika-grpc/README.md b/tika-grpc/README.md
index f9f9732e6..321a12375 100644
--- a/tika-grpc/README.md
+++ b/tika-grpc/README.md
@@ -88,3 +88,5 @@ AZURE_REGISTRY_NAME=myregistry \
For more build options and configuration details, see
[docker-build/README.md](docker-build/README.md).
+**Note:** For production deployments using official Apache releases (once Tika
4.0.0 is released), use the
[tika-grpc-docker](https://github.com/apache/tika-grpc-docker) repository which
builds from GPG-signed release artifacts.
+
diff --git a/tika-grpc/docker-build/README.md b/tika-grpc/docker-build/README.md
index 652ca5b0d..70a59bcc2 100644
--- a/tika-grpc/docker-build/README.md
+++ b/tika-grpc/docker-build/README.md
@@ -2,10 +2,27 @@
This directory contains the Docker build configuration for Apache Tika gRPC
server.
+## ⚠️ Important: Relationship with tika-grpc-docker Repository
+
+This Maven-based Docker build is intended for:
+- **Development and testing** of unreleased features and branches
+- **Building from source** before official releases exist
+- **Custom builds** with local modifications for testing
+
+For **official Apache releases** (once Tika 4.0.0 is released), use the
separate [tika-grpc-docker](https://github.com/apache/tika-grpc-docker)
repository, which:
+- Downloads GPG-signed release JARs from Apache distribution mirrors
+- Verifies GPG signatures before building Docker images
+- Follows Apache release best practices
+- Provides the canonical way to build verified, production-ready images
+
+**When to use which:**
+- Use **this build** (tika-grpc/docker-build): Development, testing unreleased
features, custom builds
+- Use **tika-grpc-docker**: Production deployments, official releases,
verified builds
+
## Overview
The Docker image includes:
-- Tika gRPC server JAR
+- Tika gRPC server JAR (built from source)
- All Tika Pipes plugins (fetchers, emitters, iterators)
- Parser packages (standard, extended, ML)
- OCR support (Tesseract with multiple languages)
