Releasing Tika Helm Charts

This guide covers the process for releasing Apache Tika Helm charts.

Prerequisites

Apache JFrog Artifactory Access

You need permissions to release the Apache Tika Helm chart to the Apache Infra Artifactory instance. Access is controlled by ASF Infra and can be requested via a JIRA ticket with the "Artifactory" label.

Repository Access

Clone the tika-helm repository:

git clone https://github.com/apache/tika-helm
cd tika-helm

Apache Tika committers should have existing access to this repository.

Install Helm and Plugins

Install Helm and the Artifactory plugin:

# Install Helm (macOS)
brew install helm

# Install the Artifactory push plugin
helm plugin install https://github.com/belitre/helm-push-artifactory-plugin --version 1.0.2

Docker Image Types

The Helm chart deploys one of two upstream Docker image types:

Minimal

Contains Apache Tika and base dependencies (Java only)

Full

Includes Tika, dependencies, Tesseract OCR, GDAL, etc.

The Helm Chart uses the Full image by default, though either can be specified during Kubernetes deployment.

Versioning

tika-helm Charts follow the Semantic Versioning 2.0.0 specification, regardless of upstream container image versioning.

Release Process

Step 1: Update Chart Configuration

For each new upstream tika-docker FULL release, update the following files:

Chart.yaml

  • Line 22: Update version (chart version)

  • Line 23: Update appVersion (must match upstream tika-docker FULL release tag)

values.yaml

  • Line 26: Update the default image tag

Step 2: Commit and Tag

Commit the changes and create a release tag:

export RELEASE_VERSION=v3.2.2

git add -A
git commit -m "Release tika-helm $RELEASE_VERSION"
git push origin main

git tag -a $RELEASE_VERSION -m "Release tika-helm $RELEASE_VERSION"
git push --tags

Step 3: Create GitHub Release

  1. Navigate to the pushed tag on GitHub

  2. Click the three-dot menu

  3. Select "Create release"

  4. Add release notes and publish

Step 4: Publish to Apache JFrog Artifactory

Add the Tika Helm repository and push the chart:

# Add the Tika Helm repository
helm repo add tika https://apache.jfrog.io/artifactory/tika

# Set your credentials
export HELM_REPO_USERNAME="your-apache-id"
export HELM_REPO_PASSWORD="your-password"

# Push the chart to Artifactory
helm push-artifactory . https://apache.jfrog.io/artifactory/tika

Post-Release

After publishing the Helm chart:

Questions

For questions about the Helm release process, contact: