Obtaining Registry Access

2 min read

On this page

Overview
Apache Fluss Artifacts Endpoints
Logging In
Helm OCI registry (public)
Docker
Java Client JARs
Further Reading
Related manuals:

This guide explains how to locate and pull Apache Fluss™ artifacts from the Ververica registry, including Docker images, Helm charts, and Java client JARs. It is intended for operators and developers who have completed the initial credentialing setup described in the Ververica Platform registry access guide and are ready to deploy Apache Fluss.

Overview

The Ververica distribution of Apache Fluss is available from the same private registry and uses the same credential workflow as Ververica Platform.

To request credentials, log in to the Helm OCI registry, and create a Kubernetes image pull secret, complete the steps outlined in the foundational guide: Ververica Platform - Chart Repository and Image Access.

The Helm charts are public — no credentials are needed to pull them.

his manual is limited to the Apache Fluss-specific information: which artifact paths to pull and where to find the Java client JARs. Pull-secret wiring, registry-access verification, and image-pull troubleshooting are covered in Deploying Apache Fluss on Kubernetes.

Apache Fluss Artifacts Endpoints

All Apache Fluss artifacts share the host registry.ververica.cloud. Only the Docker image requires credentials (issued by Ververica Customer Support); the Helm charts and the Java client JARs are public.

Artifact	Endpoint
Artifact	Endpoint
Docker image (Apache Fluss server)	registry.ververica.cloud/platform-images/fluss:0.9.1-vv-2
Helm chart - fluss-bundle (Apache Fluss + bundled ZooKeeper)	oci://registry.ververica.cloud/platform-charts/fluss-bundle:0.9.1-vv-2
Helm chart - fluss (Apache Fluss alone)	ci://registry.ververica.cloud/platform-charts/fluss:0.9.1-vv-2
Helm chart - fluss-grafana (Grafana dashboards)	oci://registry.ververica.cloud/platform-charts/fluss-grafana:0.9.1-vv-2
Java client / plugin JARs (org.apache.fluss:,com.ververica.fluss:)	Public JFrog repository — see Java Client JARs.

Most operators deploy the all-in-one fluss-bundle chart. The standalone fluss chart is for environments where you bring your own ZooKeeper cluster.

Note

he fluss-bundle chart depends on the public Bitnami ZooKeeper chart (https://charts.bitnami.com/bitnami), but pulls the ZooKeeper container image from the Ververica registry (registry.ververica.cloud/docker-hub/bitnamilegacy/zookeeper). The image pull secret you create for Apache Fluss must therefore also be referenced under zookeeper.image.pullSecrets — see Deploying Apache Fluss on Kubernetes.

Because Ververica Platform pulls the image from this registry, the image pull secret you create for Apache Fluss must be also referenced under zookeeper.image.pullSecrets. For detailed instructions on this setup, see Deploying Apache Fluss on Kubernetes.

Logging In

Authentication is only needed for the Docker images. The Helm charts are public and pull without login.

Set your credentials as environment variables for the snippet below:

BASH

1export REGISTRY_USERNAME="<REGISTRY_USERNAME>"
2export REGISTRY_PASSWORD="<REGISTRY_PASSWORD>"

Helm OCI registry (public)

The Helm charts in platform-charts are public: OCI-based charts need no helm repo add and no helm registry login. Pull or install them directly. For example:

BASH

1helm pull oci://registry.ververica.cloud/platform-charts/fluss-bundle --version 0.9.1-vv-2

Docker

Set the image credential pair (issued by Ververica Customer Support) and log in to pull Apache Fluss images locally:

BASH

1export REGISTRY_USERNAME="<REGISTRY_USERNAME>"
2export REGISTRY_PASSWORD="<REGISTRY_PASSWORD>"
3docker login registry.ververica.cloud \
4  --username "$REGISTRY_USERNAME" \
5  --password "$REGISTRY_PASSWORD"

For Kubernetes pods to pull Apache Fluss images, you must create a namespace-scoped image pull secret instead of running docker login.

To complete this setup, see the Ververica Platform guide linked above and the Create the Image Pull Secret section of the deployment manual.

Java Client JARs

If you write Java applications that link against the Apache Fluss client library, you can obtain JAR files from a public JFrog repository without using Ververica Platform credentials. Ververica Platform publishes two Maven group IDs:

org.apache.fluss:* - Apache Fluss core artifacts, which include the client API, runtime, and connector base.
com.ververica.fluss:* - Ververica Platform plugin installer artifacts.

Important

The public JFrog repository URL is https://ververica.jfrog.io/artifactory/fluss-release. No credentials are required for reads.

The Ververica plugin installer (see Installing Apache Fluss) uses this repository as its default Maven source when resolving plugin coordinates. Operators do not need to configure a private Maven settings file unless they are pulling plugins from an alternate mirror.