Prerequisites

To view your applications in the Topology view and interact with them, ensure that:

Viewing the topology of your application

You can navigate to the Topology view using the left navigation panel in the Developer perspective. After you deploy an application, you are directed automatically to the Graph view where you can see the status of the application pods, quickly access the application on a public URL, access the source code to modify it, and see the status of your last build. You can zoom in and out to see more details for a particular application.

The Topology view also provides you the option to monitor your applications using the List view. Use the List view icon (odc list view icon) to see a list of all your applications and use the Graph view icon (odc topology view icon) to switch back to the graph view.

You can customize the views as required using the following:

  • Use the Find by name field to find the required components. Search results may appear outside of the visible area; click Fit to Screen from the lower-left toolbar to resize the Topology view to show all components.

  • Use the Display Options drop-down list to configure the Topology view of the various application groupings. The options are available depending on the types of components deployed in the project:

    • Mode (Connectivity or Consumption)

      • Connectivity: Select to show all the connections between the different nodes in the topology.

      • Consumption: Select to show the resource consumption for all nodes in the topology.

    • Expand group

      • Virtual Machines: Toggle to show or hide the virtual machines.

      • Application Groupings: Clear to condense the application groups into cards with an overview of an application group and alerts associated with it.

      • Helm Releases: Clear to condense the components deployed as Helm Release into cards with an overview of a given release.

      • Knative Services: Clear to condense the Knative Service components into cards with an overview of a given component.

      • Operator Groupings: Clear to condense the components deployed with an Operator into cards with an overview of the given group.

    • Show elements based on Pod Count or Labels

      • Pod Count: Select to show the number of pods of a component in the component icon.

      • Labels: Toggle to show or hide the component labels.

Interacting with applications and components

The Topology view in the Developer perspective of the web console provides the following options to interact with applications and components:

  • Click Open URL (odc open url) to see your application exposed by the route on a public URL.

  • Click Edit Source code to access your source code and modify it.

    This feature is available only when you create applications using the From Git, From Catalog, and the From Dockerfile options.

  • Hover your cursor over the lower left icon on the Pod to see the name of the latest build and its status. The status of the application build is indicated as New (odc build new), Pending (odc build pending), Running (odc build running), Completed (odc build completed), Failed (odc build failed), and Canceled (odc build canceled).

  • The status or phase of the pod is indicated by different colors and tooltips as Running (odc pod running), Not Ready (odc pod not ready), Warning(odc pod warning), Failed(odc pod failed), Pending(odc pod pending), Succeeded(odc pod succeeded), Terminating(odc pod terminating), or Unknown(odc pod unknown). For more information about pod status, see the Kubernetes documentation.

  • After you create an application and an image is deployed, the status is shown as Pending. After the application is built, it is displayed as Running.

    odc application topology
    Figure 1. Application topology

    The application resource name is appended with indicators for the different types of resource objects as follows:

    • CJ: CronJob

    • D: Deployment

    • DC: DeploymentConfig

    • DS: DaemonSet

    • J: Job

    • P: Pod

    • SS: StatefulSet

    • odc serverless app (Knative): A serverless application

      Serverless applications take some time to load and display on the Graph view. When you deploy a serverless application, it first creates a service resource and then a revision. After that, it is deployed and displayed on the Graph view. If it is the only workload, you might be redirected to the Add page. After the revision is deployed, the serverless application is displayed on the Graph view.

Scaling application pods and checking builds and routes

The Topology view provides the details of the deployed components in the Overview panel. You can use the Overview and Resources tabs to scale the application pods, check build status, services, and routes as follows:

  • Click on the component node to see the Overview panel to the right. Use the Overview tab to:

    • Scale your pods using the up and down arrows to increase or decrease the number of instances of the application manually. For serverless applications, the pods are automatically scaled down to zero when idle and scaled up depending on the channel traffic.

    • Check the Labels, Annotations, and Status of the application.

  • Click the Resources tab to:

    • See the list of all the pods, view their status, access logs, and click on the pod to see the pod details.

    • See the builds, their status, access logs, and start a new build if needed.

    • See the services and routes used by the component.

    For serverless applications, the Resources tab provides information on the revision, routes, and the configurations used for that component.

Grouping multiple components within an application

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
  • Ensure that you have created and deployed a Node.js application on OKD using the Developer perspective.

Procedure
  1. Create and deploy the MariaDB service to your project:

    1. In the Developer perspective, navigate to the +Add view and select the From Catalog option to view all available services in the Developer Catalog.

    2. Select Databases to list all the database services and then click MariaDB option to see the details for the service.

    3. 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.

  2. To add the MariaDB service to the existing application group, press 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.

  3. 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.

    odc app grouping label
    Figure 2. Application grouping

You can remove a component from an application group by selecting the component and using Shift+ drag to drag it out of the application group.

Connecting components within an application and across applications

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 service binding request is created. Then, the Service Binding Operator controller uses an intermediate secret to inject the necessary binding data into the application deployment as environment variables. After the request is successful, the application is redeployed establishing an interaction between the connected components.

A visual connector establishes only a visual connection between the components, depicting an intent to connect. No interaction between the components is established. If the target node is not an Operator-backed service the Create a visual connector tool-tip is displayed when you drag an arrow to a target node.

Creating a visual connection between components

You can depict an intent to connect application components using the visual connector.

This procedure walks through an example of creating a visual connection between a MongoDB service and a Node.js application.

Prerequisites
  • Ensure that you have created and deployed a Node.js application using the Developer perspective.

  • Ensure that you have created and deployed a MongoDB service using the Developer perspective.

Procedure
  1. Hover over the MongoDB service to see a dangling arrow on the node.

    odc connector
    Figure 3. Connector
  2. Click and drag the arrow towards the Node.js component to connect the MongoDB service with it.

  3. Click on the MongoDB service to see the Overview Panel. In the Annotations section, click the edit icon to see the Key = app.openshift.io/connects-to and Value = [{"apiVersion":"apps.openshift.io/v1","kind":"DeploymentConfig","name":"nodejs-ex"}] annotation added to the service.

Similarly you can create other applications and components and establish connections between them.

odc connecting multiple applications
Figure 4. Connecting multiple applications

Creating a binding connection between components

Service Binding is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information about the support scope of Red Hat Technology Preview features, see https://access.redhat.com/support/offerings/techpreview/.

Currently, a few specific Operators like the etcd and the PostgresSQL Database Operator’s service instances are bindable.

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 Node.js 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 using a CatalogSource resource, 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.

Prerequisites
  • Ensure that you have created and deployed a Node.js application using the Developer perspective.

  • Ensure that you have installed the Service Binding Operator from OperatorHub.

Procedure
  1. Create a CatalogSource resource that adds the PostgresSQL Database Operator provided by Red Hat to the OperatorHub.

    1. In the +Add view, click the YAML option to see the Import YAML screen.

    2. Add the following YAML file to apply the CatalogSource resource:

      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
          name: sample-db-operators
          namespace: openshift-marketplace
      spec:
          sourceType: grpc
          image: quay.io/redhat-developer/sample-db-operators-olm:v1
          displayName: Sample DB OLM registry
          updateStrategy:
              registryPoll:
                  interval: 30m
    3. Click Create to create the CatalogSource resource in your cluster.

  2. Install the Red Hat-provided PostgreSQL Database Operator:

    1. In the Administrator perspective of the console, navigate to Operators → OperatorHub.

    2. In the Database category, select the PostgreSQL Database Operator and install it.

  3. Create a database (DB) instance for the application:

    1. Switch to the Developer perspective and ensure that you are in the appropriate project, for example, test-project.

    2. In the +Add view, click the YAML option to see the Import YAML screen.

    3. Add the service instance YAML in the editor and click Create to deploy the service. Following is an example of what the service YAML will look like:

      apiVersion: postgresql.baiju.dev/v1alpha1
      kind: Database
      metadata:
       name: db-demo
      spec:
       image: docker.io/postgres
       imageName: postgres
       dbName: db-demo

      A DB instance is now deployed in the Topology view.

  4. In the Topology view, hover over the Node.js component to see a dangling arrow on the node.

  5. Click and drag the arrow towards the db-demo-postgresql service to make a binding connection with the Node.js application. A service binding request is created and the Service Binding Operator controller injects the DB connection information into the application deployment as environment variables. After the request is successful, the application is redeployed and the connection is established.

    odc binding connector
    Figure 5. Binding connector

Labels and annotations used for the Topology view

The Topology view uses the following labels and annotations:

Icon displayed in the node

Icons in the node are defined by looking for matching icons using the app.openshift.io/runtime label, followed by the app.kubernetes.io/name label. This matching is done using a predefined set of icons.

Link to the source code editor or the source

The app.openshift.io/vcs-uri annotation is used to create links to the source code editor.

Node Connector

The app.openshift.io/connects-to annotation is used to connect the nodes.

App grouping

The app.kubernetes.io/part-of=<appname> label is used to group the applications, services, and components.

For detailed information on the labels and annotations OKD applications must use, see Guidelines for labels and annotations for OpenShift applications.