Install StreamNative Operator with the Operator Lifecycle Manager

Prerequisites

To use StreamNative Private Cloud, the following are required:

Install kubectl.
Prepare a Kubernetes cluster within the supported versions.

Import license

Before installing the StreamNative Operator, you need to import a valid license. Otherwise, StreamNative Operator will stop reconciling with a “no valid license” error message:

ERROR	controller.pulsarcoordinator	Reconciler error	{"reconciler group": "k8s.streamnative.io", "reconciler kind": "PulsarCoordinator", "name": "private-cloud", "namespace": "pulsar", "error": "No valid license has been found under namespace operators, please contact https://streamnative.io/deployment/start-free-trial"}
sigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).processNextWorkItem

If you do not have any license, you can contact StreamNative to apply for a free trial. When you have a license in hand, you can import it through:

metadata.labels with the cloud.streamnative.io/type: "license" is required because the sn-operator will detect secrets in its namespace with label and to import automatically.

cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: Secret
metadata:
# This label is a required field for the sn-operator to detect the license.
  labels:
    cloud.streamnative.io/type: "license"
  name: sn-license
  namespace: operators
type: Opaque
stringData:
  license: "Your license token"
EOF

Install OLM

Run the following command to install OLM.

curl -sL https://github.com/operator-framework/operator-lifecycle-manager/releases/download/v0.25.0/install.sh | bash -s v0.25.0

Install StreamNative Operator

OLM can deploy StreamNative Operator via the Subscription object. Run the command below to deploy the StreamNative Private Cloud Operators in the operator namespace.

kubectl apply -f https://raw.githubusercontent.com/streamnative/private-cloud/main/quick-start/olm-subscriptions.yaml

Verify that Operator Pods are running.

kubectl get pods -n operators

Provision a Pulsar cluster

Create the namespaces pulsar. The pulsar namespace is used for deploying your Pulsar cluster.

kubectl create ns pulsar

To provision a Pulsar cluster through the StreamNative Operator, you need to define a YAML file for your Pulsar cluster.

Choose a metadata store

ZooKeeper
Oxia

The default deployment uses ZooKeeperCluster for Pulsar metadata.

kubectl apply -f https://raw.githubusercontent.com/streamnative/private-cloud/main/quick-start/pulsar-cluster.yaml

Oxia is an experimental metadata-store alternative for supported Private Cloud releases. If your deployment plan requires Oxia, use an Oxia-backed Pulsar cluster manifest.

kubectl apply -f https://raw.githubusercontent.com/streamnative/private-cloud/main/oxia/pulsar-oxia.yaml

For Oxia resource configuration details, see Configure Oxia.

Overview

Quick Start

Configure Private Cloud

Operate Private Cloud

References

Install StreamNative Operator with the Operator Lifecycle Manager

Prerequisites

Import license

Install OLM

Install StreamNative Operator

Provision a Pulsar cluster

Choose a metadata store

​Prerequisites

​Import license

​Install OLM

​Install StreamNative Operator

​Provision a Pulsar cluster

​Choose a metadata store

Prerequisites

Import license

Install OLM

Install StreamNative Operator

Provision a Pulsar cluster

Choose a metadata store