Getting Started

OpenShift / Kubernetes setup

First you need an OpenShift or Kubernetes environment, which can be setup in multiple ways. For a quick start choose one of these recipes:

  • Vagrant - OpenShift Origin

    This is the easiest and fastest way to get started with fabric8 locally. All you need is Vagrant and VirtualBox installed locally. The detailed steps are described in "Fabric8 Vagrant Image"

  • Native OpenShift - OpenShift Origin

    If you have OpenShift V3 installed locally, this guide helps you step-by-step how to install fabric8 on it.

  • Google Container Engine - Kubernetes

    Google Container Engine (GKE) is a Google hosted Kubernetes platform. There are many other ways to install Kubernetes as listed on the Kubernetes Getting Started page however if you want to get up and running quickly without having to setup infrastructure and run through installations then GKE is a great option. This guide will help you step-by-step install fabric8 using vanilla Kubernetes hosted on GKE.

Local client setup

For a smooth developer experience and for using the fabric8 tools a local OpenShift client needs to be setup. How this is done is described in this recipe.

What's next

Troubleshooting

Hopefully that will get you started quickly; if you hit any issues check out the FAQ, get in touch or raise an issue