diff --git a/images/odc-binding-connector.png b/images/odc-binding-connector.png index be3a632b72..a4606e850c 100644 Binary files a/images/odc-binding-connector.png and b/images/odc-binding-connector.png differ diff --git a/images/odc-sbc-modal.png b/images/odc-sbc-modal.png index a23f00e380..c8fcf755fd 100644 Binary files a/images/odc-sbc-modal.png and b/images/odc-sbc-modal.png differ diff --git a/images/odc_connecting_multiple_applications.png b/images/odc_connecting_multiple_applications.png index 0c11e5456c..9d18ea3cca 100644 Binary files a/images/odc_connecting_multiple_applications.png and b/images/odc_connecting_multiple_applications.png differ diff --git a/images/odc_connector.png b/images/odc_connector.png index 570446e219..6add9a7dfc 100644 Binary files a/images/odc_connector.png and b/images/odc_connector.png differ diff --git a/modules/odc-creating-a-binding-connection-between-components.adoc b/modules/odc-creating-a-binding-connection-between-components.adoc index 931984c789..4dc6e56bd0 100644 --- a/modules/odc-creating-a-binding-connection-between-components.adoc +++ b/modules/odc-creating-a-binding-connection-between-components.adoc @@ -1,36 +1,33 @@ // Module included in the following assemblies: // // * applications/connecting_applications_to_services/odc-connecting-an-application-to-a-service-using-the-developer-perspective.adoc + :_content-type: PROCEDURE [id="odc-creating-a-binding-connection-between-components_{context}"] = Creating a binding connection between components -You can establish a binding connection with Operator-backed components. - -This procedure walks through an example of creating a binding connection between a PostgreSQL Database service and a Spring PetClinic sample application. To create a binding connection with a service that is backed by the PostgreSQL Database Operator, you must first add the Red Hat-provided PostgreSQL Database Operator to the *OperatorHub*, and then install the Operator. -The PostreSQL Database Operator then creates and manages the `Database` resource, which exposes the binding information in secrets, config maps, status, and spec attributes. +You can create a binding connection with Operator-backed components, as demonstrated in the following example, which uses a PostgreSQL Database service and a Spring PetClinic sample application. To create a binding connection with a service that the PostgreSQL Database Operator backs, you must first add the Red Hat-provided PostgreSQL Database Operator to the *OperatorHub*, and then install the Operator. The PostreSQL Database Operator then creates and manages the Database resource, which exposes the binding data in secrets, config maps, status, and spec attributes. .Prerequisites -* You have created and deployed a Spring PetClinic sample application by using the *Developer* perspective. -* You have installed {servicebinding-title} from the OperatorHub. -* You have installed the *Crunchy Postgres for Kubernetes* Operator from the OperatorHub by using the `v5` *Update* channel. -* You have created and deployed a Crunchy PostgreSQL database instance by using the *Developer* perspective. This instance has the following components: `hippo-backup`, `hippo-instance`, `hippo-repo-host`, and `hippo-pgbouncer`. +* You created and deployed a Spring PetClinic sample application in the *Developer* perspective. +* You installed {servicebinding-title} from the *OperatorHub*. +* You installed the *Crunchy Postgres for Kubernetes* Operator from the OperatorHub in the `v5` *Update* channel. +* You created a *PostgresCluster* resource in the *Developer* perspective, which resulted in a Crunchy PostgreSQL database instance with the following components: `hippo-backup`, `hippo-instance`, `hippo-repo-host`, and `hippo-pgbouncer`. .Procedure -. Switch to the *Developer* perspective and ensure that you are in the appropriate project, for example, `my-petclinic`. +. In the *Developer* perspective, switch to the relevant project, for example, `my-petclinic`. . 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 in the Postgres Cluster to make a binding connection with the Spring PetClinic sample application. +. Drag and drop the arrow onto the *hippo* database icon in the Postgres Cluster to make a binding connection with the Spring PetClinic sample application. -.. Enter the name and click *Create*. +. In the *Create Service Binding* dialog, keep the default name or add a different name for the service binding, and then click *Create*. + .Service Binding dialog image::odc-sbc-modal.png[] - - -Alternatively, in the *+Add* view, click the *YAML* option to see the *Import YAML* screen. Use the YAML editor and add the `ServiceBinding` resource: - +. Optional: If there is difficulty in making a binding connection using the Topology view, go to *+Add* -> *YAML* -> *Import YAML*. +. Optional: In the YAML editor, add the `ServiceBinding` resource: ++ [source,YAML] ---- apiVersion: binding.operators.coreos.com/v1alpha1 @@ -50,16 +47,24 @@ spec: version: v1 resource: deployments ---- - -A service binding request is created and the {servicebinding-title} controller projects the database service connection information into the application deployment as files by using a volume mount. After the request is successful, the application is redeployed and the connection is established. - ++ +A service binding request is created and a binding connection is created through a `ServiceBinding` resource. When the database service connection request succeeds, the application is redeployed and the connection is established. ++ .Binding connector image::odc-binding-connector.png[] - -[NOTE] ++ +[TIP] ==== You can also use the context menu by dragging the dangling arrow to add and create a binding connection to an operator-backed service. .Context menu to create binding connection image::odc_context_operator.png[] ==== + +. In the navigation menu, click *Topology*. The spring-petclinic deployment in the Topology view includes an Open URL link to view its web page. + +. Click the *Open URL* link. + +You can now view the Spring PetClinic sample application remotely to confirm that the application is now connected to the database service and that the data has been successfully projected to the application from the Crunchy PostgreSQL database service. + +The Service Binding Operator has successfully created a working connection between the application and the database service. \ No newline at end of file