Merge pull request #42305 from adellape/revert_sbo

Revert "Merge pull request #41809 from Srivaralakshmi/RefactorGetting…

Author: Preeticp

applications/connecting_applications_to_services/binding-workloads-using-sbo.adoc

@@ -7,27 +7,29 @@ include::modules/servicebinding-document-attributes.adoc[]
 
 toc::[]
 
-[role="_abstract"]
 Application developers must bind a workload to one or more backing services by using a binding secret. This secret is generated for the purpose of storing information to be consumed by the workload.
 
 As an example, consider that the service you want to connect to is already exposing the binding data. In this case, you would also need a workload to be used along with the `ServiceBinding` custom resource (CR). By using this `ServiceBinding` CR, the workload sends a binding request with the details of the services to bind with.
 
 .Example of `ServiceBinding` CR
-[source,yaml]
 ----
 apiVersion: binding.operators.coreos.com/v1alpha1
 kind: ServiceBinding
 metadata:
-    name: spring-petclinic-pgcluster
-    namespace: my-petclinic
+    name: spring-petclinic-rest
+    namespace: my-postgresql
 spec:
     services: <1>
     - group: postgres-operator.crunchydata.com
       version: v1beta1
       kind: PostgresCluster
       name: hippo
+    - group: ""
+      version: v1
+      kind: Secret
+      name: hippo-pguser-hippo
     application: <2>
-      name: spring-petclinic
+      name: spring-petclinic-rest
       group: apps
       version: v1
       resource: deployments

applications/connecting_applications_to_services/exposing-binding-data-from-a-service.adoc

@@ -7,7 +7,6 @@ include::modules/servicebinding-document-attributes.adoc[]
 
 toc::[]
 
-[role="_abstract"]
 Application developers need access to backing services to build and connect workloads. Connecting workloads to backing services is always a challenge because each service provider requires a different way to access their secrets and consume them in a workload.
 
 The {servicebinding-title} enables application developers to easily bind workloads together with operator-managed backing services, without any manual procedures to configure the binding connection. For the {servicebinding-title} to provide the binding data, as an Operator provider or user who creates backing services, you must expose the binding data to be automatically detected by the {servicebinding-title}. Then, the {servicebinding-title} automatically collects the binding data from the backing service and shares it with a workload to provide a consistent and predictable experience.

applications/connecting_applications_to_services/getting-started-with-service-binding.adoc

@@ -7,7 +7,6 @@ include::modules/servicebinding-document-attributes.adoc[]
 
 toc::[]
 
-[role="_abstract"]
 {servicebinding-title} manages the data plane for workloads and backing services. This guide provides instructions with examples to help you create a database instance, deploy an application, and use {servicebinding-title} to create a binding connection between the application and the database service.
 
 // Prerequisites for getting started with Service Binding Operator
@@ -16,13 +15,9 @@ toc::[]
 
 * You have access to an {product-title} cluster using an account with `cluster-admin` permissions.
 * You have installed the `oc` CLI.
+* You have installed PostgreSQL `psql` CLI.
 * You have installed {servicebinding-title} from OperatorHub.
-* You have installed the Crunchy Postgres for Kubernetes Operator from OperatorHub using the *v5* Update channel. The installed Operator is available in an appropriate namespace, such as the `my-petclinic` namespace.
-+
-[NOTE]
-====
-You can create the namespace using the `oc create namespace my-petclinic` command.
-====
+* You have installed the Crunchy Postgres for Kubernetes Operator from OperatorHub using the *v5* Update channel. The installed Operator is available in an appropriate namespace, such as the `my-postgresql` namespace.
 
 //Creating a PostgreSQL database instance
 include::modules/sbo-creating-a-postgresql-database-instance.adoc[leveloffset=+1]

applications/connecting_applications_to_services/installing-sbo.adoc

@@ -7,7 +7,6 @@ include::modules/servicebinding-document-attributes.adoc[]
 
 toc::[]
 
-[role="_abstract"]
 This guide walks cluster administrators through the process of installing the {servicebinding-title} to an {product-title} cluster.
 
 You can install {servicebinding-title} on {product-title} 4.7 and later.

applications/connecting_applications_to_services/odc-connecting-an-application-to-a-service-using-the-developer-perspective.adoc

@@ -5,7 +5,6 @@ include::modules/common-attributes.adoc[]
 include::modules/servicebinding-document-attributes.adoc[]
 :context: odc-connecting-an-application-to-a-service-using-the-developer-perspective
 
-[role="_abstract"]
 In addition to grouping multiple components within an application, you can also use the *Topology* view to connect components with each other. You can either use a binding connector or a visual one to connect components.
 
 A binding connection between the components can be established only if the target node is an Operator-backed service. This is indicated by the *Create a binding connector* tool-tip which appears when you drag an arrow to such a target node. When an application is connected to a service using a binding connector a `ServiceBinding` resource is created. Then, the Service Binding Operator controller projects the necessary binding data into the application deployment. After the request is successful, the application is redeployed establishing an interaction between the connected components.
@@ -19,8 +18,8 @@ This procedure walks you through an example of creating a visual connection betw
 
 .Prerequisites
 
-* You have created and deployed a Spring PetClinic sample application using the *Developer* perspective.
-* You have created and deployed a Crunchy PostgreSQL database instance using the *Developer* perspective. This instance has the following four components: `hippo-backup`, `hippo-instance`, `hippo-repo-host`, and  `hippo-pgbouncer`.
+* Ensure that you have created and deployed a Spring PetClinic sample application using the *Developer* perspective.
+* Ensure that you have created and deployed a Crunchy PostgreSQL database instance using the *Developer* perspective. This instance has the following three components: `hippo-backup`, `hippo-instance`, and  `hippo-pgbouncer`.
 
 .Procedure
 
@@ -29,7 +28,7 @@ This procedure walks you through an example of creating a visual connection betw
 .Visual connector
 image::odc_connector.png[]
 . Click and drag the arrow towards the `hippo-pgbouncer` deployment to connect the Spring PetClinic sample application with it.
-. Click the `spring-petclinic` deployment to see the *Overview* panel. Under the *Details* tab, click the edit icon in the *Annotations* section to see the *Key = `app.openshift.io/connects-to`* and *Value = `[{"apiVersion":"apps/v1","kind":"Deployment","name":"hippo-pgbouncer"}]`* annotation added to the deployment.
+. Click on the `spring-petclinic-rest` deployment to see the *Overview* panel. Under the *Details* tab, click the edit icon in the *Annotations* section to see the *Key = `app.openshift.io/connects-to`* and *Value = `[{"apiVersion":"apps/v1","kind":"Deployment","name":"hippo-pgbouncer"}]`* annotation added to the deployment.
 
 Similarly you can create other applications and components and establish visual connections between them.
 
@@ -43,13 +42,13 @@ This procedure walks through an example of creating a binding connection between
 The PostreSQL Database Operator then creates and manages the `Database` resource, which exposes the binding information in secrets, config maps, status, and spec attributes.
 
 .Prerequisites
-* You have created and deployed a Spring PetClinic sample application using the *Developer* perspective.
-* You have installed the {servicebinding-title} from the OperatorHub.
-* You have installed the *Crunchy Postgres for Kubernetes* Operator from the OperatorHub using `v5` *Update* channel.
-* You have created and deployed a Crunchy PostgreSQL database instance using the *Developer* perspective. This instance has the following four components: `hippo-backup`, `hippo-instance`, `hippo-repo-host`, and `hippo-pgbouncer`.
+* Ensure that you have created and deployed a Spring PetClinic sample application using the *Developer* perspective.
+* Ensure that you have installed the {servicebinding-title} from the OperatorHub.
+* Ensure that you have installed the *Crunchy Postgres for Kubernetes* Operator from the OperatorHub using `v5` *Update* channel.
+* Ensure that you have created and deployed a Crunchy PostgreSQL database instance using the *Developer* perspective. This instance has the following three components: `hippo-backup`, `hippo-instance`, and  `hippo-pgbouncer`.
 
 .Procedure
-. Switch to the *Developer* perspective and ensure that you are in the appropriate project, for example, `my-petclinic`. In the *Topology* view, hover over the Spring PetClinic sample application to see a dangling arrow on the node.
+. Switch to the *Developer* perspective and ensure that you are in the appropriate project, for example, `my-postgresql`. In the *Topology* view, hover over the Spring PetClinic sample application to see a dangling arrow on the node.
 . Click and drag the arrow towards the *hippo* database Postgres Cluster to make a binding connection with the Spring PetClinic sample application.
 +
 Alternatively, in the *+Add* view, click the *YAML* option to see the *Import YAML* screen. Use the YAML editor and add the `ServiceBinding` resource:
@@ -60,16 +59,16 @@ Alternatively, in the *+Add* view, click the *YAML* option to see the *Import YA
 apiVersion: binding.operators.coreos.com/v1alpha1
 kind: ServiceBinding
 metadata:
-    name: spring-petclinic-pgcluster
-    namespace: my-petclinic
+    name: spring-petclinic-rest
+    namespace: my-postgresql
 spec:
     services:
     - group: postgres-operator.crunchydata.com
       version: v1beta1
       kind: PostgresCluster
       name: hippo
     application:
-      name: spring-petclinic
+      name: spring-petclinic-rest
       group: apps
       version: v1
       resource: deployments

applications/connecting_applications_to_services/projecting-binding-data.adoc

@@ -7,7 +7,6 @@ include::modules/servicebinding-document-attributes.adoc[]
 
 toc::[]
 
-[role="_abstract"]
 This section provides information on how you can consume the binding data.
 
 == Consumption of binding data

applications/connecting_applications_to_services/understanding-service-binding-operator.adoc

@@ -8,7 +8,6 @@ include::modules/servicebinding-document-attributes.adoc[]
 toc::[]
 
 
-[role="_abstract"]
 Application developers need access to backing services to build and connect workloads. Connecting workloads to backing services is always a challenge because each service provider suggests a different way to access their secrets and consume them in a workload. In addition, manual configuration and maintenance of this binding together of workloads and backing services make the process tedious, inefficient, and error-prone.
 
 The {servicebinding-title} enables application developers to easily bind workloads together with Operator-managed backing services, without any manual procedures to configure the binding connection.