Chapter 3. Service Registry quickstart

This chapter explains how to quickly install Service Registry Operator using the OpenShift command line. This quickstart example deploys Service Registry using the embedded Infinispan storage option:

Note

The recommended installation option for production environments is Section 4.1, “Installing Service Registry from the OpenShift OperatorHub”.

The recommended storage option for production environments is AMQ Streams. For details, see Chapter 5, Deploying Service Registry storage in AMQ Streams.

3.1. Quickstart Service Registry Operator installation

You can quickly deploy the Service Registry Operator on the command line, without the Operator Lifecycle Manager, by using a downloaded set of installation files and examples.

Prerequisites

Procedure

  1. Create a project for the installation, for example, service-registry: 

    oc new-project service-registry
  2. Set the namespace in install/cluster_role_binding.yaml by replacing {NAMESPACE} with service-registry.

  3. Apply the files located in the install/ folder: 

    oc apply -f install/ -n service-registry

3.2. Quickstart Service Registry deployment

To quickly create a new Service Registry deployment, use the embedded Infinispan storage option, which does not require an external storage to be configured as a prerequisite.

Prerequisites

  • Ensure that the Service Registry Operator is already installed.

Procedure

  1. Create an ApicurioRegistry custom resource (CR) in the same namespace that the Operator is deployed: 

    oc apply -f ./examples/apicurioregistry_infinispan_cr.yaml -n service-registry

    Example CR for Infinispan storage

    apiVersion: apicur.io/v1alpha1
kind: ApicurioRegistry
metadata:
  name: example-apicurioregistry
spec:
  configuration:
    persistence: "infinispan"
    infinispan:
      clusterName: "example-apicurioregistry"
      # ^ Optional

  2. Access the automatically created route for the Service Registry web console. For example: 

    http://example-apicurioregistry.my-project.my-domain-name.com/