Chapter 1. Getting started overview
Use Red Hat AMQ Streams to create and set up Kafka clusters, then connect your applications and services to those clusters.
This guide describes how to install and start using AMQ Streams on OpenShift Container Platform. You can install the AMQ Streams operator from the OperatorHub in the OpenShift web console. The AMQ Streams operator understands how to install and manage Kafka components. Installing from the OperatorHub provides a standard configuration of AMQ Streams that allows you to take advantage of automatic updates.
When the AMQ Streams operator is installed, it provides the resources to install instances of Kafka components. After installing a Kafka cluster, you can start producing and consuming messages.
If you require more flexibility with your deployment, you can use the installation artifacts provided with AMQ Streams. For more information on using the installation artifacts, see Deploying and Upgrading AMQ Streams on OpenShift.
1.1. Using the OperatorHub
The OperatorHub is the web console interface of the OpenShift Container Platform for installing operators. Using the OperatorHub, you can install the AMQ Streams operator directly from the OpenShift web console.
You can choose to install the AMQ Streams operator in one of the following ways:
- AMQ Streams operator only
- Install the AMQ Streams operator directly.
- Red Hat Integration operator (deprecated)
- If you have more than one Red Hat Integration subscription, you can use the Red Hat Integration operator to install and update the AMQ Streams operator, as well as the operators for all subscribed Red Hat Integration components. For more information, see Installing the Red Hat Integration Operator.
The Red Hat Integration operator has been deprecated and will be removed in the future. It will be available from the OperatorHub in OpenShift 4.6 to 4.10.
1.2. Prerequsites
The following prerequisites are required for getting started with AMQ Streams.
- You have a Red Hat account.
- JDK 11 or later is installed.
- An OpenShift 4.8 to 4.12 cluster is available.
-
The OpenShift
oc
command-line tool is installed and configured to connect to the running cluster.
The steps to get started are based on using the OperatorHub in the OpenShift web console, but you’ll also use the OpenShift oc
CLI tool to perform certain operations. You’ll need to connect to your OpenShift cluster using the oc
tool.
-
You can install the
oc
CLI tool from the web console by clicking the'?'
help menu, then Command Line Tools. -
You can copy the required
oc login
details from the web console by clicking your profile name, then Copy login command.