Document how to enable service catalog on OpenShift so it can be used with 'odo service'

[tmds]

[kind/Documentation]

I'm trying out odo with OpenShift crc. I'm trying to create a service and it's not clear what I should do to make it work.

$ odo catalog list services
 ✗  unable to list services because Service Catalog is not enabled in your cluster: unable to get cluster serviceClassExternalName: unable to get cluster service classes: unable to list cluster service classes: the server could not find the requested resource (get clusterserviceclasses.servicecatalog.k8s.io)
$ odo service create postgresql
 ✗  unable to search classes by name (the server could not find the requested resource (get clusterserviceclasses.servicecatalog.k8s.io))

[girishramnani]

CRC uses openshift 4.0+ which doesn't have service catalog installed by default

[tmds]

I understood that from the message. I don't know how to install it.

[kadel]

We should like to guide on how to enable ServiceCatalog on crc if we are suggesting users to use crc and service catalog.
For example at Creating an application with a database
the "Service Catalog is enabled." prerequisite should be a link to crc docs explaining how to enable service catalog.

Not sure if there is a CRC specific way to enable service catalog, but for OCP 4.2 there is this https://docs.openshift.com/container-platform/4.2/applications/service_brokers/installing-service-catalog.html

We should verify that this is working on CRC first

cc @boczkowska

[tmds]

@kadel after following the OpenShift documentation steps, I get this:

$ odo catalog list services
✗ no deployable services found

[tmds]

note: the top of the OpenShift documentation says:

The service catalog is deprecated in OpenShift Container Platform 4. Equivalent and better functionality is present in the Operator Framework and Operator Lifecycle Manager (OLM).

[kadel]

note: the top of the OpenShift documentation says:

The service catalog is deprecated in OpenShift Container Platform 4. Equivalent and better functionality is present in the Operator Framework and Operator Lifecycle Manager (OLM).

We are looking into it, but the problem is that right now it is not equivalent. Some of the apis to allow what was possible with ServicaCatalog are still missing in operators :-(

[tmds]

@kadel do you know how I can populate the service catalog after enabling it? I get:

$ odo catalog list services
✗ no deployable services found

[tmds]

fyi, this is what happens with my OpenShift Online account:

odo catalog list services
X unable to list services because Service Catalog is not enabled in your cluster: unable to get cluster serviceClassExternalName: unable to get cluster service classes: unable to list cluster service classes: clusterserviceclasses.servicecatalog.k8s.io is forbidden: User "tdeseyn" cannot list resource "clusterserviceclasses" in API group "servicecatalog.k8s.io" at the cluster scope

[tmds]

We are looking into it

Ref #2161

[kadel]

fyi, this is what happens with my OpenShift Online account:

odo catalog list services
X unable to list services because Service Catalog is not enabled in your cluster: unable to get cluster serviceClassExternalName: unable to get cluster service classes: unable to list cluster service classes: clusterserviceclasses.servicecatalog.k8s.io is forbidden: User "tdeseyn" cannot list resource "clusterserviceclasses" in API group "servicecatalog.k8s.io" at the cluster scope

that looks like SeviceCatalog was not deployed or something went wrong with it

[tmds]

Sorry for the confusion.

This is the message on OpenShift Online:

odo catalog list services
X unable to list services because Service Catalog is not enabled in your cluster: unable to get cluster serviceClassExternalName: unable to get cluster service classes: unable to list cluster service classes: clusterserviceclasses.servicecatalog.k8s.io is forbidden: User "tdeseyn" cannot list resource "clusterserviceclasses" in API group "servicecatalog.k8s.io" at the cluster scope

This is what I get on crc:

$ odo catalog list services
✗ no deployable services found

[tmds]

After also following the instructions at https://docs.openshift.com/container-platform/4.2/applications/service_brokers/installing-template-service-broker.html, odo catalog list services is no longer empty. 🎉

[mohammedzee1000]

We might want to document this as a workaround for 4.x clusters?