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

Created on 4 Nov 2019 · 31Comments · Source: openshift/odo

[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))

areservice kindocumentation needocs prioritHigh

Source

tmds

Most helpful comment

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. 🎉

tmds on 7 Nov 2019

👍2

All 31 comments

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

girishramnani on 4 Nov 2019

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

tmds on 4 Nov 2019

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

kadel on 5 Nov 2019

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

$ odo catalog list services
✗ no deployable services found

tmds on 5 Nov 2019

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).

tmds on 5 Nov 2019

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 :-(

kadel on 5 Nov 2019

@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 on 5 Nov 2019

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 on 5 Nov 2019

We are looking into it

Ref https://github.com/openshift/odo/issues/2161

tmds on 6 Nov 2019

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

kadel on 6 Nov 2019

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 on 6 Nov 2019

tmds on 7 Nov 2019

👍2

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

mohammedzee1000 on 13 Nov 2019

👍1

@tmds did you follow those doc on the latest crc and it worked or you used openshift online?

praveenkumar on 15 Nov 2019

CRC specific way to enable service catalog,

There are no CRC specific ways. All interaction with the cluster we deploy is done as if it is a regular OpenShift 4.x cluster

gbraad on 15 Nov 2019

@tmds did you follow those doc on the latest crc and it worked or you used openshift online?

There is no odo/crc documentation for this. odo/crc is also not pointing at the OpenShift documentation, which makes it hard for a user to figure out how to make this work.

I have not tried these steps with OpenShift Online. I guess it won't work because the user is not the admin?

These are the steps:

tmds on 15 Nov 2019

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

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

gbraad on 15 Nov 2019

OpenShift Online

AFAIR OpenShift Online is 3.x, right?

gbraad on 15 Nov 2019

AFAIR OpenShift Online is 3.x, right?

It depends on which one.
OpenShift Online Starter is 4.x (various versions)
OpenShift Online Pro is still 3.11

kadel on 15 Nov 2019

Needs docs

Preeticp on 14 Jan 2020

dudash on 18 Feb 2020

@kadel we have added a link to the Installing service catalog section through this PR: https://github.com/openshift/openshift-docs/pull/20106, is that enough for this issue? Can we close it?

Preeticp on 2 Apr 2020

Issues go stale after 90d of inactivity.

Mark the issue as fresh by commenting /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.
Exclude this issue from closing by commenting /lifecycle frozen.

If this issue is safe to close now please do so with /close.

/lifecycle stale

openshift-bot on 1 Jul 2020

Stale issues rot after 30d of inactivity.

Mark the issue as fresh by commenting /remove-lifecycle rotten.
Rotten issues close after an additional 30d of inactivity.
Exclude this issue from closing by commenting /lifecycle frozen.

If this issue is safe to close now please do so with /close.

/lifecycle rotten
/remove-lifecycle stale

openshift-bot on 31 Jul 2020

Rotten issues close after 30d of inactivity.

Reopen the issue by commenting /reopen.
Mark the issue as fresh by commenting /remove-lifecycle rotten.
Exclude this issue from closing again by commenting /lifecycle frozen.

/close

openshift-bot on 30 Aug 2020

@openshift-bot: Closing this issue.

In response to this:

Rotten issues close after 30d of inactivity.

Reopen the issue by commenting /reopen.
Mark the issue as fresh by commenting /remove-lifecycle rotten.
Exclude this issue from closing again by commenting /lifecycle frozen.

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

openshift-ci-robot on 30 Aug 2020

I think this issue is still up to date, if I run "odo catalog list services", no service like a database is available when using CRC, which is what is used when learning. Instead I have to install operators, which is much harder than the intended use of odo which is to simplify development experience (especially for a beginner).

Also the steps above from @tmds don't seem to work anymore on the latest version of CRC.

faysou on 21 Jan 2021

You are right, this is still valid at it should not been closed.

/reopen
/remove-lifecycle rotten
/remove-lifecycle rotten
/priority high

kadel on 21 Jan 2021

@kadel: Reopened this issue.

In response to this:

You are right, this is still valid at it should not been closed.

/reopen
/remove-lifecycle rotten
/remove-lifecycle rotten
/priority high

openshift-ci-robot on 21 Jan 2021

Also the steps above from @tmds don't seem to work anymore on the latest version of CRC.

I'm assuming that you're talking about steps in https://github.com/openshift/odo/issues/2353#issuecomment-550964471. Latest version of CRC is based on OpenShift 4.6. Whereas, as we can see in the official OpenShift documentation, Service Catalog is not supported beyond OpenShift 4.4.

I'm not sure how we could address installation of Service Catalog on CRC in this situation.