Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 1. Accessing the Fuse Console on OpenShift

Note

Security and user management for the Fuse Console is handled by OpenShift. Role-based access control is not yet available for Fuse on OpenShift.

For a Fuse on OpenShift distribution, deploy the Fuse Console using the corresponding OpenShift template.

1.1. OpenShift templates for Fuse Console

Table 1.1, “Fuse Console templates” describes the two OpenShift templates that you can use to access the Fuse Console, depending on the type of Fuse application deployment.

Table 1.1. Fuse Console templates

TypeTemplateDescription

cluster

fis-console-cluster-template.json

Use an OAuth client that requires the cluster-admin role to be created. The Fuse Console can discover and connect to Fuse applications deployed across multiple namespaces or projects.

namespace

fis-console-namespace-template.json

Use a service account as OAuth client, which only requires the admin role in a project to be created. This restricts the Fuse Console access to this single project, and as such acts as a single tenant deployment.

Optionally, you can view a list of the template parameters by running the following command: 

oc process --parameters -f fis-console-namespace-template.json

1.2. Deploying the Fuse Console on your OpenShift cluster

You can deploy the Fuse Console from the OpenShift Console or from the command line.

1.2.1. Using the OpenShift Console

To deploy the Fuse Console on your OpenShift cluster, follow these steps (where myproject is the name of your project):

  1. If the Fuse Console templates are not already installed on OpenShift, run the following command to create the template as a resource in OpenShift: 

    oc create -n openshift -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-000099-redhat-5/fis-console-namespace-template.json
  2. In the OpenShift console, select Add to Project → Select from Project to see the Fuse Console template.

1.2.2. Using the command line

To deploy the Fuse Console from the command line:

  1. Create a new application based on a Fuse Console template by running one of the following commands (where myproject is the name of your project):

    • For the Fuse Console cluster template, where myhost is the hostname: 

      oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-000099-redhat-5/fis-console-cluster-template.json -p ROUTE_HOSTNAME=myhost

    • For the Fuse Console namespace template: 

      oc new-app -n myproject -f https://raw.githubusercontent.com/jboss-fuse/application-templates/application-templates-2.1.fuse-000099-redhat-5/fis-console-namespace-template.json
      Note
      You can omit the ROUTE_HOSTNAME parameter for the *namespace* template because OpenShift automatically generates one.

  2. Obtain the status of your deployment by running this command: 

    oc status

    Here is an example response: 

    In project myproject on server https://192.168.64.12:8443
https://fuse-console.192.168.64.12.nip.io (redirects) (svc/fuse70-console-service)
dc/fuse70-console deploys openshift/jboss-fuse70-console:1.0
deployment #1 deployed 2 minutes ago - 1 pod
  3. To access the Fuse Console from a browser, use the provided URL (for example, https://fuse-console.192.168.64.12.nip.io).