Annotating your service to make it discoverable

This page describes how you incorporate your service into the OpenRiskNet registry once you have provided OpenAPI and JsonLD descriptors.

The OpenRiskNet registry runs in the OpenRiskNet VRE and listens for service and routes starting or stopping. When one starts the registry inspects the OpenAPI+JsonLD definition and adds it to the list of known services. When it stops it is removed from the list.

An OpenShift service is used internally within the OpenShift cluster (e.g. by another service) and is not accessible from outside the cluster (e..g from your web browser).

And OpenShift route is a bridge from the outside to an OpenShift service (e.g. to allow a service to be accessed from your browser or an application running outside of the cluster.

TODO - describe the annotations that are needed.