Chapter 1. Accessing the Fuse Console on OpenShift
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.
Type | Template | Description |
---|---|---|
cluster |
| 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 |
| 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):
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
-
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:
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
NoteYou can omit the ROUTE_HOSTNAME parameter for the *namespace* template because OpenShift automatically generates one.
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
- To access the Fuse Console from a browser, use the provided URL (for example, https://fuse-console.192.168.64.12.nip.io).