Chapter 2. Installing Service Registry

Procedure

1. Get the Service Registry OpenShift template.

2. Enter the following command to get the name of the Kafka bootstrap service running on your OpenShift cluster:

   $ oc get services | grep .*kafka-bootstrap

3. Create a new OpenShift application and specify the following parameters:

   • service-registry-template.yml: The OpenShift template file for Service Registry.
   • KAFKA_BOOTSTRAP_SERVERS: The name of the Kafka bootstrap service on your cluster, followed by the Kafka broker port (for example, my-cluster-kafka-bootstrap:9092).

   • REGISTRY_ROUTE: The name of the route that will expose Service Registry, which is based on your cluster environment (for example, my-cluster-service-registry-myproject.example.com).

     For example:

     $ oc new-app service-registry-template.yml -p KAFKA_BOOTSTRAP_SERVERS=my-cluster-kafka-bootstrap:9092 -p REGISTRY_ROUTE=my-cluster-service-registry-myproject.example.com

     You should see output such as the following:

     Deploying template "myproject/service-registry" for "service-registry-template.yml" to project myproject
     
         service-registry
         ---------
         Congratulations on deploying Service Registry into OpenShift!
     
         All components have been deployed and configured.
     
         * With parameters:
            * Registry Route Name=my-cluster-service-registry-myproject.example.com
            * Registry Max Memory Limit=1300Mi
            * Registry Memory Requests=600Mi
            * Registry Max CPU Limit=1
            * Registry CPU Requests=100m
            * Kafka Bootstrap Servers=my-cluster-kafka-bootstrap:9092
     
     --> Creating resources ...
        imagestream.image.openshift.io "registry" created
        service "service-registry" created
        deploymentconfig.apps.openshift.io "service-registry" created
        route.route.openshift.io "service-registry" created
     --> Success
        Access your application via route 'my-cluster-service-registry-myproject.example.com'
        Run 'oc status' to view your app.

4. Send a test request using the Service Registry REST API. For example, enter the following curl command to create a simple Avro schema artifact for a share price application in the registry:

   $ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Registry-ArtifactId: prices-value" --data '{"type":"record","name":"price","namespace":"com.redhat","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' my-cluster-service-registry-myproject.example.com/artifacts

5. Verify that the response includes the expected JSON body to confirm that the Avro schema artifact was created in the registry. For example:

   {"createdOn":1578310374517,"modifiedOn":1578310374517,"id":"prices-value","version":1,"type":"AVRO","globalId":8}