Fabric8 Documentation

Fabric8 Developer Console

Fabric8 Developer Console provides a rich HTML5 web application for creating, building, testing and managing Microservices on Kubernetes or Openshift.

See the Getting Started Guide for how to install it.

Opening the Fabric8 Console

If you are using minishift or minikube then you open the fabric8 console via the command

minikube service fabric8
minishift service fabric8

Depending on if you are using minikube or minishift.

Otherwise you typically use a URL like http://fabric8.${DOMAIN} where DOMAIN is the domain you used to install fabric8

Getting Started

When you open the fabric8 console you should see a screen like this:

fabric8 developer console: Start page

A Team is a kubernetes namespace running your development tools (like Jenkins, Nexus, JBoss Forge) and is associated with a number of environments (Testing, Staging, Production etc).

Click on the Team Dashboard which should take you to the Team Dashboard where you can create new apps or view your existing apps:

fabric8 developer console: Team Dashboard

If you click the Create Application you get to the create wizard page:

fabric8 developer console: Create App

Then you get to pick what kind of project you wish to create and its name:

fabric8 developer console: Select Project Type

Then choose your CD Pipeline:

fabric8 developer console: Choose CD Pipeline

If you choose Copy pipeline to project then the Jenkinsfile that defines the pipeline gets copied into your project's git repository so that you can easily edit it later on via a versioned source code change just like any other code change.

Now you will be taken to the App Dashboard where you can see all the environments and active pipelines along with recent commits on a single pane of glass. This is how it looks once the Canary release, Testing and Staging is complete; waiting for Promotion to Production

fabric8 developer console: App Dashboard

You can click on the Proceed button to promote to Production, or Abort to stop the pipeline.

You can easily switch between all your development tools (Gogs, Jenkins, Nexus etc) using the tool drop down menu at the top right of the screen:

Clicking on the tools drop down to see development apps

Runtime tabs

The Team page has a Runtime tab that lets you browse the runtime of your development environment. Or from the home page you can click on an environment page to view its runtime.

The Runtime pages have a number of tabs that let you work with the various Kubernetes resources. We'll highlight the main ones you'll need to use:


The main tab to get a feel for what's running in your system is the Replicas tab which shows all the replication controllers or ReplicaSets on Kubernetes.

To scale up or down a controller to run more or less pods (containers) just increase or decrease the Desired Replicas value and hit Save and hey presto pods are created or destroyed.

controllers tab screenshot


The Overview tab gives you a feel for how all the various services and replication controllers interact:

overview tab screenshot


The Library tab lets you drag and drop Apps into your library from downloaded App Zips so that you can see all the available applications you can run. Click on an app then hit Run to run them.

You can also drag folder from the Library to your desktop and local file system to save them.

library tab screenshot

Using Kubernetes/OpenShift

If you are using Kubernetes or OpenShift you need to find the URL for the console service. From there you should be able to navigate to the tabs for pods, [replication controllers] and services.

If you use the Fabric8 Vagrant approach then the URL is http://fabric8.vagrant.f8/.

Otherwise you need to find the host name to use.

e.g. on OpenShift V3 you can find it via:

oc get route fabric8