Hawtio Console on OpenShift
Switch branches/tags
v1.6.0 v1.5.1 v1.5.0 v1.4.3 v1.4.2 v1.4.1 v1.4.0 v1.3.1 v1.3.0 v1.2.0 v1.1.0 v1.0.3 v1.0.2 v1.0.1 v1.0.0 hawtio-online-1.0.0.fuse-730001 hawtio-online-1.0.0.fuse-720039 hawtio-online-1.0.0.fuse-720038 hawtio-online-1.0.0.fuse-720037 hawtio-online-1.0.0.fuse-720036 hawtio-online-1.0.0.fuse-720035 hawtio-online-1.0.0.fuse-720034 hawtio-online-1.0.0.fuse-720033 hawtio-online-1.0.0.fuse-720032 hawtio-online-1.0.0.fuse-720031 hawtio-online-1.0.0.fuse-720030 hawtio-online-1.0.0.fuse-720029 hawtio-online-1.0.0.fuse-720028 hawtio-online-1.0.0.fuse-720027 hawtio-online-1.0.0.fuse-720026 hawtio-online-1.0.0.fuse-720025 hawtio-online-1.0.0.fuse-720024 hawtio-online-1.0.0.fuse-720023 hawtio-online-1.0.0.fuse-720022 hawtio-online-1.0.0.fuse-720021 hawtio-online-1.0.0.fuse-720020 hawtio-online-1.0.0.fuse-720019 hawtio-online-1.0.0.fuse-720018 hawtio-online-1.0.0.fuse-720017 hawtio-online-1.0.0.fuse-720016 hawtio-online-1.0.0.fuse-720015 hawtio-online-1.0.0.fuse-720014 hawtio-online-1.0.0.fuse-720013 hawtio-online-1.0.0.fuse-720012 hawtio-online-1.0.0.fuse-720011 hawtio-online-1.0.0.fuse-720010 hawtio-online-1.0.0.fuse-720009 hawtio-online-1.0.0.fuse-720008 hawtio-online-1.0.0.fuse-720007 hawtio-online-1.0.0.fuse-720006 hawtio-online-1.0.0.fuse-720005 hawtio-online-1.0.0.fuse-720004 hawtio-online-1.0.0.fuse-720003 hawtio-online-1.0.0.fuse-720002 hawtio-online-1.0.0.fuse-720001 hawtio-online-1.0.0.fuse-711005 hawtio-online-1.0.0.fuse-711004 hawtio-online-1.0.0.fuse-711003 hawtio-online-1.0.0.fuse-711002 hawtio-online-1.0.0.fuse-711001 hawtio-online-1.0.0.fuse-710020 hawtio-online-1.0.0.fuse-710019 hawtio-online-1.0.0.fuse-710018 hawtio-online-1.0.0.fuse-710017 hawtio-online-1.0.0.fuse-710016 hawtio-online-1.0.0.fuse-710015 hawtio-online-1.0.0.fuse-710014 hawtio-online-1.0.0.fuse-710013 hawtio-online-1.0.0.fuse-710012 hawtio-online-1.0.0.fuse-710011 hawtio-online-1.0.0.fuse-710010 hawtio-online-1.0.0.fuse-710009 hawtio-online-1.0.0.fuse-710008 hawtio-online-1.0.0.fuse-710007 hawtio-online-1.0.0.fuse-710006 hawtio-online-1.0.0.fuse-710005 hawtio-online-1.0.0.fuse-710004 hawtio-online-1.0.0.fuse-710003 hawtio-online-1.0.0.fuse-710002 hawtio-online-1.0.0.fuse-710001 hawtio-online-1.0.0.fuse-000072 hawtio-online-1.0.0.fuse-000071 hawtio-online-1.0.0.fuse-000070 hawtio-online-1.0.0.fuse-000069 hawtio-online-1.0.0.fuse-000068 hawtio-online-1.0.0.fuse-000067 hawtio-online-1.0.0.fuse-000066 hawtio-online-1.0.0.fuse-000065 hawtio-online-1.0.0.fuse-000064 hawtio-online-1.0.0.fuse-000063 hawtio-online-1.0.0.fuse-000062 hawtio-online-1.0.0.fuse-000061 hawtio-online-1.0.0.fuse-000060 hawtio-online-1.0.0.fuse-000059 hawtio-online-1.0.0.fuse-000058 hawtio-online-1.0.0.fuse-000057 hawtio-online-1.0.0.fuse-000056 hawtio-online-1.0.0.fuse-000055 hawtio-online-1.0.0.fuse-000054 hawtio-online-1.0.0.fuse-000053
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

hawtio-online

An Hawtio console that eases the discovery and management of hawtio-enabled 1 applications deployed on OpenShift.

Deployment

You can run the following instructions to deploy the Hawtio Online console on your OpenShift cluster. You may want to read how to get started with the CLI for more information about the oc client tool.

There exist two OpenShift templates to choose from, depending on the following characteristics:

Template Descripton
deployment-cluster.yml Use an OAuth client that requires the cluster-admin role to be created. The Hawtio Online console can discover and connect to hawtio-enabled 1 applications deployed across multiple namespaces / projects.
deployment-namespace.yml Use a service account as OAuth client, which only requires admin role in a project to be created. This restricts the Hawtio Online console access to this single project, and as such acts as a single tenant deployment.

To deploy the Hawtio Online console, execute the following command:

$ oc new-app -f https://raw.githubusercontent.com/hawtio/hawtio-online/master/deployment-namespace.yml \
  -p ROUTE_HOSTNAME=<HOST>

Note that the ROUTE_HOSTNAME parameter can be omitted when using the deployment-namespace template. In that case, OpenShift automatically generates one for you.

You can obtain more information about the template parameters, by executing the following command:

$ oc process --parameters -f https://raw.githubusercontent.com/hawtio/hawtio-online/master/deployment-namespace.yml
NAME                DESCRIPTION                                                                   GENERATOR           VALUE
ROUTE_HOSTNAME      The externally-reachable host name that routes to the Hawtio Online service

You can obtain the status of your deployment, by running:

$ oc status
In project hawtio on server https://192.168.64.12:8443

https://hawtio-online-hawtio.192.168.64.12.nip.io (redirects) (svc/hawtio-online)
  dc/hawtio-online deploys istag/hawtio-online:latest 
    deployment #1 deployed 2 minutes ago - 1 pod

Open the route URL displayed above from your Web browser to access the Hawtio Online console.

Development

Tools

You must have the following tools installed:

Build

$ yarn install

Install

In order to authenticate and obtain OAuth access tokens for the Hawtio console be authorized to watch for hawtio-enabled 1 applications deployed in your cluster, you have to create an OAuth client that matches localhost development URLs.

Cluster mode
$ oc create -f oauthclient.yml

See OAuth Clients for more information.

Namespace mode
$ oc create -f serviceaccount.yml

See Service Accounts as OAuth Clients for more information.

Run

Cluster mode
$ yarn start --master=`oc whoami --show-server` --mode=cluster
Namespace mode
$ yarn start --master=`oc whoami --show-server` --mode=namespace --namespace=`oc project -q`

You can access the console at http://localhost:2772/.


1. Containers with a configured port named jolokia and that exposes the Jolokia API.