Bug 1544554

Summary:	Clarify asynchronous Service Catalog operations
Product:	OpenShift Container Platform	Reporter:	Jay Boyd <jaboyd>
Component:	Documentation	Assignee:	Ashley Hardin <ahardin>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Vikram Goyal <vigoyal>
Severity:	high	Docs Contact:	Vikram Goyal <vigoyal>
Priority:	urgent
Version:	3.7.0	CC:	ahardin, aos-bugs, chezhang, jokerman, mmccomas, pmorie, vigoyal
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:	1543530	Environment:
Last Closed:	2018-02-19 21:34:38 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1543530
Bug Blocks:

Description Jay Boyd 2018-02-12 21:02:18 UTC

This document https://docs.openshift.com/container-platform/3.7/architecture/service_catalog/index.html  needs to be refined with a discussion about asynchronous operations.  

In 3.7 Service Instances could be provisioned, updated and deprovisioned asynchronously (in the backgound) if supported by the Service Broker.  Some operations may take a long time to complete (5-10 minutes or more).  Also, sometimes a Service Broker may be unavailable and Service Catalog will have to queue and retry an operation.  In these situations, end users may not be aware that the operation is still in progress and Service Catalog will continuously try to bring reality into accordance with the desired state.

When a user deletes a project that contains applications created by Service Catalog, it may take some time for the Catalog and the Broker to fully clean up.  Until these operations are done successfully the project and namespace can not be deleted.

Please see comment #5 in https://bugzilla.redhat.com/show_bug.cgi?id=1541350  for additional details.  

In 3.9 we add the async operations for Service Bindings (create/updated/delete).

Comment 1 Jay Boyd 2018-02-13 20:49:28 UTC

pending fix by https://github.com/openshift/openshift-docs/pull/7752

Comment 2 Ashley Hardin 2018-02-19 21:34:38 UTC

This content is now published: 
https://access.redhat.com/documentation/en-us/openshift_container_platform/3.7/html/architecture/service-catalog-components#architecture-additional-concepts-service-catalog

Comment 3 Kathryn Alexander 2021-04-07 15:46:46 UTC

*** Bug 1548618 has been marked as a duplicate of this bug. ***