Chapter 3. Installing Service Registry on OpenShift

Procedure

1. In the OpenShift Container Platform web console, log in using an account with cluster administrator privileges.

2. Create a new OpenShift project:

   1. In the left navigation menu, click Home > Project > Create Project.
   2. Enter a project name, for example, my-project, and click Create.
3. In the left navigation menu, click Catalog > OperatorHub.
4. In the Filter by keyword text box, enter Registry to find the Red Hat Integration - Service Registry Operator.
5. Read the information about the Operator, and click Install. This displays the Create Operator Subscription page.

6. Select your subscription settings, for example:

   • Installation Mode > A specific namespace on the cluster > my-project
   • Update Channel > serviceregistry-1.0
   • Approval Strategy > Manual
7. Click Subscribe. This displays the Operators > Installed Operators page.
8. Wait a few moments until the Status for the Service Registry Operator displays Succeeded and the subscription is Up to Date.

Procedure

1. In the OpenShift Container Platform web console, log in using an account with cluster administrator privileges.
2. Change to the OpenShift project in which Service Registry is installed. For example, from the Project drop-down, select my-project.
3. In the left navigation menu, click Catalog > OperatorHub.
4. In the Filter by keyword text box, enter AMQ to find the Red Hat Integration - AMQ Streams Operator.
5. Read the information about the Operator, and click Install. This displays the Create Operator Subscription page.

6. Select your subscription settings, for example:

   • Installation Mode > A specific namespace on the cluster > my-project
   • Update Channel > amq-streams-1.5.x
   • Approval Strategy > Manual
7. Click Subscribe. This displays the Operators > Installed Operators page.
8. Wait a few moments until the Status for the AMQ Streams Operator displays Succeeded and the subscription is Up to Date.

Procedure

1. In the OpenShift Container Platform web console, log in using an account with cluster administrator privileges.

2. If you do not already have a Kafka cluster configured, create a new Kafka cluster using AMQ Streams. For example, in the OpenShift OperatorHub:

   1. Click Installed Operators > Red Hat Integration - AMQ Streams.
   2. Under Provided APIs > Kafka, click Create Instance to create a new Kafka cluster.

   3. Edit the custom resource definition as appropriate, and click Create.

      Warning

      The default example creates a cluster with 3 Zookeeper nodes and 3 Kafka nodes with ephemeral storage. This temporary storage is suitable for development and testing only, and not for production. For more details, see Using AMQ Streams on OpenShift.

3. After the cluster is ready, click Provided APIs > Kafka > my-cluster > YAML.

4. In the status block, make a copy of the bootstrapServers value, which you will use later to deploy Service Registry. For example:

   status:
     conditions:
     ...
     listeners:
       - addresses:
           - host: my-cluster-kafka-bootstrap.my-project.svc
             port: 9092
         bootstrapServers: 'my-cluster-kafka-bootstrap.my-project.svc:9092'
         type: plain
     ...

5. Create a Kafka topic to store the Service Registry artifacts:

   1. Under Provided APIs > Kafka Topic, click Create topic.
   2. Change the default topic name from my-topic to the required storage-topic.

6. Create a Kafka topic to store the Service Registry global IDs:

   1. Under Provided APIs > Kafka Topic, click Create topic.
   2. Change the default topic name from my-topic to the required global-id-topic.
7. Click Installed Operators > Red Hat Integration - Service Registry > ApicurioRegistry > Create ApicurioRegistry.

8. Paste in the following custom resource definition, but use your bootstrapServers value that you copied earlier:

   apiVersion: apicur.io/v1alpha1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry
   spec:
     configuration:
       persistence: "streams"
       streams:
         bootstrapServers: "my-cluster-kafka-bootstrap.my-project.svc:9092"

9. Click Create and wait for the Service Registry route to be created on OpenShift.

10. Click Networking > Route to access the new route for the Service Registry web console. For example:

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

Procedure

1. In the OpenShift Container Platform web console, log in using an account with cluster administrator privileges.
2. Click Installed Operators > Red Hat Integration - Service Registry > ApicurioRegistry > Create ApicurioRegistry.

3. Paste in the following custom resource definition:

   apiVersion: apicur.io/v1alpha1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry
   spec:
     configuration:
       persistence: "infinispan"
       infinispan: # Currently uses embedded version of Infinispan
         clusterName: "example-apicurioregistry"
         # ^ Optional

4. Click Create and wait for the Service Registry route to be created on OpenShift.

5. Click Networking > Route to access the new route for the Service Registry web console. For example:

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

Procedure

1. In the OpenShift Container Platform web console, log in using an account with cluster administrator privileges.
2. Change to the OpenShift project in which Service Registry is installed. For example, from the Project drop-down, select my-project.
3. In the left navigation menu, click Catalog > OperatorHub.
4. In the Filter by keyword text box, enter PostgreSQL to find an Operator suitable for your environment, for example, Crunchy PostgreSQL for OpenShift or PostgreSQL Operator by Dev4Ddevs.com.
5. Read the information about the Operator, and click Install. This displays the Create Operator Subscription page.

6. Select your subscription settings, for example:

   • Installation Mode > A specific namespace on the cluster > my-project
   • Update Channel > stable
   • Approval Strategy > Manual
7. Click Subscribe. This displays the Operators > Installed Operators page.

8. Wait a few moments until the Status for the PostgreSQL Operator displays Succeeded and the subscription is Up to Date.

   Important

   You must read the documentation from your chosen PostgreSQL Operator for details on how to create and manage your database.

Procedure

1. In the OpenShift Container Platform web console, log in using an account with cluster administrator privileges.
2. Change to the OpenShift project in which Service Registry and your PostgreSQL Operator are installed. For example, from the Project drop-down, select my-project.
3. Create a PostgreSQL database for your Service Registry storage. For example, click Installed Operators > PostgreSQL Operator by Dev4Ddevs.com > Create database > YAML.

4. Edit the database settings as follows:

   • name: Change the value to registry
   • image: Change the value to centos/postgresql-10-centos7

5. Edit any other database settings as needed depending on your environment, for example:

   apiVersion: postgresql.dev4devs.com/v1alpha1
   kind: Database
   metadata:
     name: registry
     namespace: my-project
   spec:
     databaseCpu: 30m
     databaseCpuLimit: 60m
     databaseMemoryLimit: 512Mi
     databaseMemoryRequest: 128Mi
     databaseName: example
     databaseNameKeyEnvVar: POSTGRESQL_DATABASE
     databasePassword: postgres
     databasePasswordKeyEnvVar: POSTGRESQL_PASSWORD
     databaseStorageRequest: 1Gi
     databaseUser: postgres
     databaseUserKeyEnvVar: POSTGRESQL_USER
     image: centos/postgresql-10-centos7
     size: 1

6. Click Create Database, and wait until the database is created.
7. Click Installed Operators > Red Hat Integration - Service Registry > ApicurioRegistry > Create ApicurioRegistry.

8. Paste in the following custom resource definition, and edit the values for the database url and credentials to match your environment:

   apiVersion: apicur.io/v1alpha1
   kind: ApicurioRegistry
   metadata:
     name: example-apicurioregistry
   spec:
     configuration:
       persistence: "jpa"
       dataSource:
         url: "jdbc:postgresql://SERVICE_NAME.NAMESPACE.svc:5432/"
         # e.g. url: "jdbc:postgresql://acid-minimal-cluster.my-project.svc:5432/"
         userName: "postgres"
         password: "PASSWORD"
         # ^ Optional

9. Click Create and wait for the Service Registry route to be created on OpenShift.

10. Click Networking > Route to access the new route for the Service Registry web console. For example:

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