Fabric8 Developer Platform

This project generates the distribution of the fabric8 developer platform

The fabric8 developer platform is based on lots of different open source projects. Here's the main fabric8 repositories:

Projects

Maven Tooling

• fabric8-maven-plugin provides Apache Maven support for Kubernetes, OpenShift and Fabric8

Developer Console

• fabric8-console the web console for fabric8
• fabric8-forge contains the main JBoss Forge addons and REST service which provides developer wizards to create and edit projects

CI / CD

• fabric8-pipeline-library provides a set of reusable Jenkins Pipeline steps and functions that you can reuse inside your Jenkinsfile via the @Library annotation
• fabric8-jenkinsfiles-library provides a set of reusable Jenkinsfile files you can use on your projects. The Jenkisnfiles resue the [fabric8-pipeline-library](https://github.com/fabric8io/fabric8-pipeline-library and they are used by the Developer Console when creating projects or choosing pipelines.
• kubernetes-plugin is the Jenkins plugin which adds native Kubernetes support for defining build slave pods with custom pods, images, volumes and secrets. Its reused by the fabric8-jenkinsfiles-library
• fabric8-jenkins-workflow-steps the Jenkins Pipeline steps for working with Microservices Platform

DevOps

• fabric8-devops contains the main DevOps microservices for the Developer Platform

iPaaS

• fabric8-ipaas contains the main iPaaS applications
• ipaas-quickstarts contains the quickstarts and archetypes for the iPaaS

kubeflix

• kubeflix provides Kubernetes integration with Netflix OSS like Hystrix, Ribbon and Turbine

Tools

• gofabric8 is a go based CLI tool for installing and managing fabric8

Suppport for non-docker

Some folks have work loads they need to orchestrate on operating systems that don't yet have production quality docker support (e.g. Windows, AIX, Solaris, HPUX).

• kansible lets you orchestrate operating system processes on Windows or any Unix in the same way as you orchestrate your Docker containers with Kubernetes by using Ansible to provision the software onto hosts and Kubernetes to orchestrate the processes and the containers in a single system

Java Libraries

If you want to write any Java/JVM based tools to interact with Kubernetes we have a number of libraries to help:

Kubernetes

Kubernetes provides the main REST API for working with the Kubernetes Platform. It should provide all you need for writing most services and plugins for Kubernetes.

• kubernetes-model the Java DTOs for working with kubernetes and OpenShift which are generated from the go source code in kubernetes and OpenShift

• kubernetes-client provides a Java API for working with the Kubernetes and OpenShift REST API (pods, replication controllers, services etc)

• fabric8 contains the main java libraries such as:

• kubernetes-api provides helper APIs around the kubernetes-client for working with Kubernetes and OpenShift

• kubernetes-jolokia makes it easy to work with the Jolokia Client API and Java containers running in Pods inside Kubernetes which expose the Jolokia port

Testing

• fabric8-arquillian provides a plugin for Arquillian for integration testing Apps on top of Kubernetes; using Kubernetes to provision and orchestrate the containers and then making assertions that the required resources startup correctly.
• fabric8-selenium provides a library to make it easier to create Selenium WebDriver based integration and system tests on Kubernetes using fabric8-arquillian
• kubernetes-assertions provides a set of assertj assertions of the form assertThat(kubernetesResource) for working with the kubernetes-api
• jolokia-assertions makes it easy to perform assertions on remote JVMs via JMX using Jolokia over HTTP/JSON

#### Spring

• spring-cloud-kubernetes provides Kubernetes integration with Spring Cloud
• kubernetes-zipkin provides Kubernetes integration with Zipkin for tracing microservices

ActiveMQ

• mq-client provides the the io.fabric8.mq.core.MQConnectionFactory class which implements the JMS ConnectionFactory to connect to Apache ActiveMQ Artemis using the Kubernetes Service discovery mechanism which requires no user configuration (other than a single environment variable if you wish to switch to a non default service implementation)

Camel

• camel-amq provides the Camel amq: component which uses the Kubernetes Service discovery mechanism to discover and connect to the ActiveMQ Artemis brokers so that no configuration is required (other than a single environment variable if you wish to switch to a non default service implementation)

• camel-master provides the Camel master: component which provides a locking mechanism to ensure that only one pod implements a consumer at any time; if that pod dies then another one takes over.

CDI

• fabric8-cdi provides an easy way to work with Kubernetes services using the CDI Dependency Injection approach
• fabric8-apt provides an APT code generator to create a JSON Schema file for each environment variable injected by the @ConfigProperty annotation from deltaspike - giving dteails of the name, type, default value and description. This can then be used by the fabric8:json maven goal to list all of the environment variables and their

DevOps

• fabric8-devops-connector provides a Java library for connecting the various DevOps services like git hosting, chat, issue tracking and jenkins for a project reusing the optional fabric8.yml file

### Git Repos

• gitrepo-api provides a Java API for working with git repositories such as gogs or github

### Hubot

• hubot-api provides a Java API for working with the Hubot chat bot for sending notifications to chat services like Lets Chat, IRC, Slack, HipChat and Campfire

### Letschat

• letschat-api provides a Java API for working with the Let's Chat to auto-create rooms etc.

### Taiga

• taiga-api provides a Java API for working with the Taiga issue tracker / kanban / scrum management system

Additional projects

The web console uses many different hawtio 2 modules. In particular the main dependency of is hawtio-kubernetes

Docker images

There are numerous docker images created via separate github repositories such as the following:

• docker-gerrit
• docker-grafana
• docker-gogs
• docker-prometheus
• nexus-docker
• hubot-irc
• hubot-lets-chat
• hubot-slack
• fabric8-eclipse-orion
• fabric8-kiwiirc
• jenkins-docker
• lets-chat
• taiga-docker
• openshift-auth-proxy

Base images

The above-packaged docker images leverage some of these base Docker images:

Java Alpine Linux

• docker.io/fabric8/java-alpine-openjdk8-jdk
• docker.io/fabric8/java-alpine-openjdk8-jre
• docker.io/fabric8/java-alpine-openjdk7-jdk
• docker.io/fabric8/java-alpine-openjdk7-jre

Java Centos Linux

• docker.io/fabric8/java-centos-openjdk8-jdk
• docker.io/fabric8/java-centos-openjdk8-jre
• docker.io/fabric8/java-centos-openjdk7-jdk
• docker.io/fabric8/java-centos-openjdk7-jre

JBoss

• docker.io/fabric8/java-jboss-openjdk8-jdk

Jetty

• docker.io/fabric8/jetty-9
• docker.io/fabric8/jetty-8

Karaf

• docker.io/fabric8/karaf-2.4
• docker.io/fabric8/karaf-3.0

Tomcat

• docker.io/fabric8/tomcat-8.0
• docker.io/fabric8/tomcat-7.0

s2i

• docker.io/fabric8/s2i-java
• docker.io/fabric8/s2i-karaf