Fabric8 Documentation

App Library

The App Library implements a RESTful service using a replication controller to provide a wiki of apps that can be run.

You can think of this as being a little like your library for Apps for your mobile device; its a way of populating your default set of Apps that are available so that you can easily run them.

The library is stored in a git based wiki and can be edited via git or via the console.

Features

When the App Library is running the console:

  • has a Run... button on the Apps tab which lets you easily pick which Apps you want to run in a few clicks
  • associates any resource (service, replication controller, pod) with the icon stored in the App Library wiki so that things look much nicer ;)
  • the Library tab allows you to explore all your installed Apps, browse the documentation and drag and drop apps from the internet or file system to or from the App Library to install or share Apps between environments or people.

Running on Kubernetes/OpenShift

If you start fabric8 using these instructions then it should be started by default.

If not you can run the App Library on any kubernetes environment as follows:

kube apply -f  http://central.maven.org/maven2/io/fabric8/jube/images/fabric8/app-library/2.2.16/app-library-2.2.16-kubernetes.json

Then make sure you have run the console

You can find specific URLs for REST/Git etc. by visiting the App Library service endpoint in a browser.

Pre-Populating Applications

The App Library can be configured to pre-populate itself using content downloaded via maven co-ordinates.

For example, the default App Library config file contains the following IMPORT_APP_URLS environment variable:

  "env": [
     {
         "name": "IMPORT_APP_URLS",
         "value": "mvn:io.fabric8.quickstarts/fabric8-quickstarts-parent/${FABRIC8_VERSION}/zip/app,mvn:io.fabric8.jube.images.fabric8/apps/${FABRIC8_VERSION}/zip/app"
     }
   ]

Download one of the above zips to see the structure used:

  http://central.maven.org/maven2/io/fabric8//quickstarts/fabric8-quickstarts-parent/2.2.16/fabric8-quickstarts-parent-2.2.16-app.zip