Merge pull request #29275 from rishumehra/devcatalog

[RHDEVDOCS-2332] - Documentation of using the Developer Catalog

Author: kalexand-rh

applications/application_life_cycle_management/odc-creating-applications-using-developer-perspective.adoc

@@ -37,3 +37,5 @@ To create serverless applications, in addition to the preceding prerequisites, e
 endif::[]
 
 include::modules/odc-importing-codebase-from-git-to-create-application.adoc[leveloffset=+1]
+
+include::modules/odc-using-the-developer-catalog-to-add-services-or-components.adoc[leveloffset=+1]

images/odc_app_grouping_label.png

@@ -5,8 +5,8 @@
 [id="odc-grouping-multiple-components_{context}"]
 = Grouping multiple components within an application
 
-You can use the *Add* page to add multiple components or services to your project and use the *Topology* page to group applications and resources within an application group.
-The following procedure adds a MongoDB database service to an existing application with a Node.js component.
+You can use the *+Add* view to add multiple components or services to your project and use the *Topology* view to group applications and resources within an application group.
+The following procedure adds a MariaDB database service to an existing application with a Node.js component.
 
 
 .Prerequisites
@@ -15,23 +15,16 @@ The following procedure adds a MongoDB database service to an existing applicati
 
 .Procedure
 
-. Create and deploy the MongoDB service to your project as follows:
-.. In the *Developer* perspective, navigate to the *Add* view and select the *Database* option to see the *Developer Catalog*, which has multiple options that you can add as components or services to your application.
-.. Click on the *MongoDB* option to see the details for the service.
-.. Click *Instantiate Template* to see an automatically populated template with details for the MongoDB service, and click *Create* to create the service.
+. Create and deploy the MariaDB service to your project:
+.. In the *Developer* perspective, navigate to the *+Add* view and select the *From Catalog* option to view all available services in the *Developer Catalog*.
+.. Select *Databases* to list all the database services and then click *MariaDB* option to see the details for the service.
+.. Click *Instantiate Template* to see an automatically populated template with details for the MariaDB service, and then click *Create* to create and view the MariaDB service in the *Topology* view.
 
-. On the left navigation panel, click *Topology* to see the MongoDB service deployed in your project.
-. To add the MongoDB service to the existing application group, select the *mongodb* pod and drag it to the application; the MongoDB service is added to the existing application group.
-. Dragging a component and adding it to an application group automatically adds the required labels to the component. Click on the MongoDB service node to see the label `app.kubernetes.io/part-of=myapp` added to the *Labels* section in the *Overview* Panel.
+. To add the MariaDB service to the existing application group, press kbd:[Shift]+ drag the *mariadb* pod to the application group that contains the Node.Js component. The MariaDB service is added to the existing application group.
+
+. Click the MariaDB service node and confirm that the `app.kubernetes.io/part-of=<application-name>` label is in the *Labels* section in the *Overview* Panel. Adding a component to an application group automatically adds the required labels to the component.
 +
 .Application grouping
 image::odc_app_grouping_label.png[]
 
-Alternatively, you can also add the component to an application as follows:
-
-. To add the MongoDB service to your application, click on the *mongodb* pod to see the *Overview* panel to the right.
-. Click the *Actions* drop-down menu on the upper right of the panel and select *Edit Application Grouping*.
-. In the *Edit Application Grouping* dialog box, click the *Select an Application* drop-down list, and select the appropriate application group.
-. Click *Save* to see the MongoDB service added to the application group.
-
 You can remove a component from an application group by selecting the component and using kbd:[Shift]+ drag to drag it out of the application group.

images/odc_devcatalog_mariadb.png

@@ -0,0 +1,22 @@
+// Module included in the following assemblies:
+//
+// applications/application_life_cycle_management/odc-creating-applications-using-developer-perspective.adoc
+
+[id="odc-using-the-developer-catalog-to-add-services-or-components_{context}"]
+= Using the Developer Catalog to add services or components to your application
+
+You use the Developer Catalog to deploy applications and services based on Operator backed services such as Databases, Builder Images, and Helm Charts. The Developer Catalog contains a collection of application components, services, event sources, or source-to-image builders that you can add to your project. Cluster administrators can customize the content made available in the catalog.
+
+.Procedure
+
+. In the *Developer* perspective, navigate to the *+Add* -> *From Catalog* to view all the available services in the *Developer Catalog*.
+. Under *All Items*, select the kind of service or the component you need to add to your project. For this example, select *Databases* to list all the database services and then click *MariaDB* to see the details for the service.
++
+.Developer Catalog
+image::odc_devcatalog_mariadb.png[]
++
+. Click *Instantiate Template* to see an automatically populated template with details for the *MariaDB* service, and then click *Create* to create and view the MariaDB service in the *Topology* view.
++
+.MariaDB in Topology
+image::odc_devcatalog_toplogy.png[]
++