Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

Fresh Espresso & Open Source Cloud

I have a passion for all things open source. I live in Ipswich MA and work for Red Hat, on the fabric8 project. Fabric8 is a cloud micro-services platform so you can deploy your applications to an all open source cloud. I kayak on the Atlantic Ocean along the coastal North East from Massachusetts to Maine whenever I can.

One click to run Apiman on Fabric8

Apiman is a API Management application that help you add policies to your service and set up and enforce contracts between service producers and consumers. Fabric8 is cloud infrastructure build on Kubernetes and Docker.

If you already have fabric8 running you can skip to 'Run Apiman'.

1. Install Fabric8

1.1. Obtain the Fabric8 installer

This first step is specfic to OSX, if you are running something else it maybe slightly different. In that case please check

git clone
cd fabric8-installer/vagrant/openshift
vagrant plugin install landrush

Edit the Vagrant file so that you give about half your machine’s hardware to the virtual machine you are about to build. For me this is

v.memory = 4096
v.cpus = 2

Now you are ready to launch the fabric8 vm using

vagrant up

Depending on how fast your machine and internet connection is, this takes 20 minutes or so. Don’t forget to set the following environment variables

export DOCKER_IP=
export DOCKER_HOST=tcp://
export KUBERNETES_DOMAIN=vagrant.f8

So while this is going we can continue installing the client tooling.

1.2. Obtain and install the OpenShift client tools

Grab version 1.0.6 or newer, from Pick the archive with platform architecture right for your machine and simply extract and copy them to a location so that they are on your PATH.

1.3. Open the Fabric8 Console

Once the vagrant install completes we can open the fabric8-console at


It will redirect to the Openshift Login screen on secure screen. The certificate on this screen is self signed, so you will have to accept certificate. Try Chrome if you have issues with this.

2. Run Apiman

In the fabric8 console navigate to the apps in your namespace and click the green 'Run' button

Run Button.

Click to run the Apiman App group.

Run Apiman.

This will start ElasticSearch, Apiman and the Apiman Gateway. Check out the Apps screen and see all these applications starting up. Note that at the moment we have one known issue which is a race condition between Apiman and ElasticSearch starting up. In some cases you may have to kill the Apiman pod to get around this.

3. Conclusion

There is now new 'App Group' that gets you going with API Management on Fabric8 with one click.

About the author

Kurt Stam


comments powered by Disqus