Skip to content

Commit 3a22cfa

Browse files
committed
RHDEVDOCS-4234: Adding SME feedback
1 parent 7b98173 commit 3a22cfa

File tree

5 files changed

+25
-20
lines changed

5 files changed

+25
-20
lines changed

images/odc-binding-connector.png

29.9 KB
Loading

images/odc-sbc-modal.png

779 Bytes
Loading
-17.6 KB
Loading

images/odc_connector.png

-21.2 KB
Loading
Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,33 @@
11
// Module included in the following assemblies:
22
//
33
// * applications/connecting_applications_to_services/odc-connecting-an-application-to-a-service-using-the-developer-perspective.adoc
4+
45
:_content-type: PROCEDURE
56
[id="odc-creating-a-binding-connection-between-components_{context}"]
67
= Creating a binding connection between components
78

8-
You can establish a binding connection with Operator-backed components.
9-
10-
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.
11-
The PostreSQL Database Operator then creates and manages the `Database` resource, which exposes the binding information in secrets, config maps, status, and spec attributes.
9+
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.
1210

1311
.Prerequisites
1412

15-
* You have created and deployed a Spring PetClinic sample application by using the *Developer* perspective.
16-
* You have installed {servicebinding-title} from the OperatorHub.
17-
* You have installed the *Crunchy Postgres for Kubernetes* Operator from the OperatorHub by using the `v5` *Update* channel.
18-
* 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`.
13+
* You created and deployed a Spring PetClinic sample application in the *Developer* perspective.
14+
* You installed {servicebinding-title} from the *OperatorHub*.
15+
* You installed the *Crunchy Postgres for Kubernetes* Operator from the OperatorHub in the `v5` *Update* channel.
16+
* 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`.
1917
2018
.Procedure
2119

22-
. Switch to the *Developer* perspective and ensure that you are in the appropriate project, for example, `my-petclinic`.
20+
. In the *Developer* perspective, switch to the relevant project, for example, `my-petclinic`.
2321
. In the *Topology* view, hover over the Spring PetClinic sample application to see a dangling arrow on the node.
24-
. Click and drag the arrow towards the *hippo* database in the Postgres Cluster to make a binding connection with the Spring PetClinic sample application.
22+
. 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.
2523

26-
.. Enter the name and click *Create*.
24+
. In the *Create Service Binding* dialog, keep the default name or add a different name for the service binding, and then click *Create*.
2725
+
2826
.Service Binding dialog
2927
image::odc-sbc-modal.png[]
30-
31-
32-
Alternatively, in the *+Add* view, click the *YAML* option to see the *Import YAML* screen. Use the YAML editor and add the `ServiceBinding` resource:
33-
28+
. Optional: If there is difficulty in making a binding connection using the Topology view, go to *+Add* -> *YAML* -> *Import YAML*.
29+
. Optional: In the YAML editor, add the `ServiceBinding` resource:
30+
+
3431
[source,YAML]
3532
----
3633
apiVersion: binding.operators.coreos.com/v1alpha1
@@ -50,16 +47,24 @@ spec:
5047
version: v1
5148
resource: deployments
5249
----
53-
54-
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.
55-
50+
+
51+
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.
52+
+
5653
.Binding connector
5754
image::odc-binding-connector.png[]
58-
59-
[NOTE]
55+
+
56+
[TIP]
6057
====
6158
You can also use the context menu by dragging the dangling arrow to add and create a binding connection to an operator-backed service.
6259

6360
.Context menu to create binding connection
6461
image::odc_context_operator.png[]
6562
====
63+
64+
. In the navigation menu, click *Topology*. The spring-petclinic deployment in the Topology view includes an Open URL link to view its web page.
65+
66+
. Click the *Open URL* link.
67+
68+
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.
69+
70+
The Service Binding Operator has successfully created a working connection between the application and the database service.

0 commit comments

Comments
 (0)