Skip to main content
Redhat Developers  Logo
  • Products

    Featured

    • Red Hat Enterprise Linux
      Red Hat Enterprise Linux Icon
    • Red Hat OpenShift AI
      Red Hat OpenShift AI
    • Red Hat Enterprise Linux AI
      Linux icon inside of a brain
    • Image mode for Red Hat Enterprise Linux
      RHEL image mode
    • Red Hat OpenShift
      Openshift icon
    • Red Hat Ansible Automation Platform
      Ansible icon
    • Red Hat Developer Hub
      Developer Hub
    • View All Red Hat Products
    • Linux

      • Red Hat Enterprise Linux
      • Image mode for Red Hat Enterprise Linux
      • Red Hat Universal Base Images (UBI)
    • Java runtimes & frameworks

      • JBoss Enterprise Application Platform
      • Red Hat build of OpenJDK
    • Kubernetes

      • Red Hat OpenShift
      • Microsoft Azure Red Hat OpenShift
      • Red Hat OpenShift Virtualization
      • Red Hat OpenShift Lightspeed
    • Integration & App Connectivity

      • Red Hat Build of Apache Camel
      • Red Hat Service Interconnect
      • Red Hat Connectivity Link
    • AI/ML

      • Red Hat OpenShift AI
      • Red Hat Enterprise Linux AI
    • Automation

      • Red Hat Ansible Automation Platform
      • Red Hat Ansible Lightspeed
    • Developer tools

      • Red Hat Trusted Software Supply Chain
      • Podman Desktop
      • Red Hat OpenShift Dev Spaces
    • Developer Sandbox

      Developer Sandbox
      Try Red Hat products and technologies without setup or configuration fees for 30 days with this shared Openshift and Kubernetes cluster.
    • Try at no cost
  • Technologies

    Featured

    • AI/ML
      AI/ML Icon
    • Linux
      Linux Icon
    • Kubernetes
      Cloud icon
    • Automation
      Automation Icon showing arrows moving in a circle around a gear
    • View All Technologies
    • Programming Languages & Frameworks

      • Java
      • Python
      • JavaScript
    • System Design & Architecture

      • Red Hat architecture and design patterns
      • Microservices
      • Event-Driven Architecture
      • Databases
    • Developer Productivity

      • Developer productivity
      • Developer Tools
      • GitOps
    • Secure Development & Architectures

      • Security
      • Secure coding
    • Platform Engineering

      • DevOps
      • DevSecOps
      • Ansible automation for applications and services
    • Automated Data Processing

      • AI/ML
      • Data Science
      • Apache Kafka on Kubernetes
      • View All Technologies
    • Start exploring in the Developer Sandbox for free

      sandbox graphic
      Try Red Hat's products and technologies without setup or configuration.
    • Try at no cost
  • Learn

    Featured

    • Kubernetes & Cloud Native
      Openshift icon
    • Linux
      Rhel icon
    • Automation
      Ansible cloud icon
    • Java
      Java icon
    • AI/ML
      AI/ML Icon
    • View All Learning Resources

    E-Books

    • GitOps Cookbook
    • Podman in Action
    • Kubernetes Operators
    • The Path to GitOps
    • View All E-books

    Cheat Sheets

    • Linux Commands
    • Bash Commands
    • Git
    • systemd Commands
    • View All Cheat Sheets

    Documentation

    • API Catalog
    • Product Documentation
    • Legacy Documentation
    • Red Hat Learning

      Learning image
      Boost your technical skills to expert-level with the help of interactive lessons offered by various Red Hat Learning programs.
    • Explore Red Hat Learning
  • Developer Sandbox

    Developer Sandbox

    • Access Red Hat’s products and technologies without setup or configuration, and start developing quicker than ever before with our new, no-cost sandbox environments.
    • Explore Developer Sandbox

    Featured Developer Sandbox activities

    • Get started with your Developer Sandbox
    • OpenShift virtualization and application modernization using the Developer Sandbox
    • Explore all Developer Sandbox activities

    Ready to start developing apps?

    • Try at no cost
  • Blog
  • Events
  • Videos

How to install the CouchbaseDB Operator for Red Hat OpenShift on your laptop using Red Hat CodeReady Containers and Red Hat Marketplace

September 9, 2020
Don Schenck
Related topics:
ContainersDeveloper ToolsKubernetesOperators

Share:

    Red Hat Marketplace is an online store of sorts, where you can choose the software that you want to install and run on your Red Hat OpenShift cluster. The analogy is a phone app store, where you select an app, and it's automagically installed on your phone. With Marketplace, you simply register your cluster(s), select the software that you want, and it is installed for you. It could not be easier.

    In this article, I show you how to install Couchbase Server Enterprise Edition on an OpenShift cluster. In my case, the cluster is running on Fedora 32 using Red Hat CodeReady Containers (CRC). Couchbase Server Enterprise Edition is currently available as a free trial, and CRC is also available at zero cost. This setup offers a no-risk way to try containers, Kubernetes, OpenShift, and, in this case, Couchbase. This is definitely "developers playing around with the software"-level stuff.

    Prerequisites

    We'll start by assuming that you have CodeReady Containers installed on your machine. There's no charge for CRC, and it brings the latest version of OpenShift to a PC near you, so go ahead and grab it. You can find installation instructions for Windows 10 Enterprise here and macOS here.

    Note: You can get your free copy of CodeReady Containers at try.openshift.com, where you can also tap into other free OpenShift learning materials.

    Once your cluster is up and running, journey over to the Red Hat Marketplace website, where you will be asked to log in or create an account. If you don't have an account, you'll need to create one.

    For full disclosure, you will need to register a credit card to install any software from Red Hat Marketplace, including the Couchbase free trial. However, the free trial will not—repeat, will not—automatically roll over into a paid subscription. You are never at risk of your credit card being automatically charged. Don't let the registration hold you back; there's too much goodness here in your favor.

    Step 1: Register with Red Hat Marketplace

    Assuming that you have an account, the first step is to go to the Red Hat Marketplace homepage, shown in Figure 1, and sign in.

    red hat marketplace main web site with option to log in or create an account
    Figure 1: Sign in to Red Hat Marketplace.

    After you've logged in, click your username in the upper-right corner and select the My account option from the drop-down list shown in Figure 2.

    my account option on red hat marketplace web page
    Figure 2: Select 'My account'.">

    Step 2: Register your cluster

    Once you've logged in to your account, you can access your workspace and register your OpenShift cluster. You only need to register a cluster once, and it's very easy. Figure 3 shows my profile page and account information; yours should look similar.

    A screenshot of the Red Hat Marketplace 'My profile' page.
    Figure 3: An example profile page for Red Hat Marketplace.">

    When you click Workspace at the top of your profile page, you'll see a list of the software that you have already installed. Before you can install any software in a new cluster, you need to register it. Registering a cluster installs the Red Hat Marketplace Operator, which talks to the Red Hat Marketplace website and installs the software that you need.

    To start, click Add cluster, as shown in Figure 4.

    add cluster page
    Figure 4: Click 'Add cluster'.">

    The Add cluster page guides you through the next steps.

    Generate your secret

    First, you will generate a pull secret, as shown in Figure 5.

    A screenshot of the 'Add cluster' setup page.
    Figure 5: Generate your pull secret.">

    Install the Red Hat Marketplace Operator

    When you click Generate Secret, the command to Install the Red Hat Marketplace Operator (Step 2 in Figure 5) is updated to include your secret. Click the Copy icon shown in Figure 6 to copy the command to your system's clipboard.

    A screenshot of the 'Add cluster' page with the command-line command to install the Operator.
    Figure 6: Get the command and secret to install the Red Hat Marketplace Operator.">

    Register your cluster

    Now, paste the command into your command line and run it. After a few minutes, you will be able to return to the web interface to see your newly-registered cluster, as shown in Figure 7.

    The web site display of the new cluster.
    Figure 7: Check the cluster registration.">

    You'll also receive an email when your cluster is registered—because no one ever gets enough email.

    Additional registration for CodeReady Containers

    If you are using CRC (and only if you're using CRC), you'll need to complete a few additional steps to ensure that your cluster has the credentials required to install software from Red Hat Marketplace. You will need to do this just once for your CRC cluster, and it takes about two minutes.

    Head over to the marketplace documentation page and follow the instructions in Register OpenShift cluster on Red Hat CodeReady Containers. It's nine easy steps and completely necessary for success with CRC. If you're not using CRC, you can skip this part.

    Step 3: Select your software

    Your cluster is up and running on your PC, and it's registered with Red Hat Marketplace. Now the fun part begins: Finding and installing a free software trial with a simple mouse click. As previously mentioned, I've chosen Couchbase Server Enterprise Edition for this example.

    Search the Marketplace

    You can search or filter to see what software is available from Red Hat Marketplace. Figure 8 shows the search page with various product categories to select from.

    A web page with options for filtering by type of software.
    Figure 8: The Red Hat Marketplace search page.">

    Filter by category

    We select the Database category, which returns the options shown in Figure 9 (currently, there are 13 database options in total).

    All of the Database offerings on Red Hat Marketplace.
    Figure 9: Database products available from Red Hat Marketplace.">

    Select your free trial

    Clicking on the Couchbase Server Enterprise Edition panel takes you to the Couchbase installation page shown in Figure 10.

    The Couchbase Server Enterprise Edition page with purchase and free trial options
    Figure 10: The Couchbase Server Enterprise Edition page with the free-trial option.">

    Click on the Free trial button to continue, and you will see the screen in Figure 11.

    The purchase summary shows no cost for the free trial.
    Figure 11: Start the free trial.">

    Step 4: Set up and run the installation

    Now, you will select your cluster, choose the namespace (OpenShift project) where you wish to install Couchbase, and launch the installation. After you've filled in this information, as shown in Figure 12, you may install the free trial in your cluster with one click.

    The web page with Couchbase installation options.
    Figure 12: Set up the installation.">

    Figure 13 shows the installation in progress.

    A web page showing Couchbase being installed from Red Hat Marketplace.
    Figure 13: The installation in progress on Red Hat Marketplace.">

    Confirm success!

    And now, here's the really cool thing: You can switch over to your OpenShift dashboard, select Installed Operators, and watch the installation as it happens.

    OpenShift dashboard showing Couchbase being installed.
    Figure 14: The installation in progress.">

    On my PC, it took about two minutes for the status to switch from Installing (Figure 14) to Succeeded (Figure 15).

    OpenShift dashboard showing Couchbase Operator installed.
    Figure 15: The installation succeeded.">

    Conclusion

    That's it: With a simple registration and just a few clicks, you have installed the CouchbaseDB Operator in your cluster.  If you want to play around and experiment with Couchbase, visit the excellent Getting Started web page for this technology. Also, in case you are wondering, you can use the Red Hat Marketplace to uninstall the CouchbaseDB Operator at any time.

    Want another example? You can find a more general one in Install Red Hat OpenShift Operators on your laptop using Red Hat CodeReady Containers and Red Hat Marketplace.

    Recent Posts

    • More Essential AI tutorials for Node.js Developers

    • How to run a fraud detection AI model on RHEL CVMs

    • How we use software provenance at Red Hat

    • Alternatives to creating bootc images from scratch

    • How to update OpenStack Services on OpenShift

    Red Hat Developers logo LinkedIn YouTube Twitter Facebook

    Products

    • Red Hat Enterprise Linux
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform

    Build

    • Developer Sandbox
    • Developer Tools
    • Interactive Tutorials
    • API Catalog

    Quicklinks

    • Learning Resources
    • E-books
    • Cheat Sheets
    • Blog
    • Events
    • Newsletter

    Communicate

    • About us
    • Contact sales
    • Find a partner
    • Report a website issue
    • Site Status Dashboard
    • Report a security problem

    RED HAT DEVELOPER

    Build here. Go anywhere.

    We serve the builders. The problem solvers who create careers with code.

    Join us if you’re a developer, software engineer, web designer, front-end designer, UX designer, computer scientist, architect, tester, product manager, project manager or team lead.

    Sign me up

    Red Hat legal and privacy links

    • About Red Hat
    • Jobs
    • Events
    • Locations
    • Contact Red Hat
    • Red Hat Blog
    • Inclusion at Red Hat
    • Cool Stuff Store
    • Red Hat Summit

    Red Hat legal and privacy links

    • Privacy statement
    • Terms of use
    • All policies and guidelines
    • Digital accessibility

    Report a website issue