APIMan provides common management capabilities for API providers and consumers. You can learn more about the project at its home page or the code at its github page.

Once this integration is deployed, APIs deployed as services on OpenShift can be exposed externally via the APIMan gateway which controls API usage. The management policy can be configured via the APIMan web console, which is available to producers and consumers of APIs according to their roles in OpenShift projects.

This project supplies the code and configuration for building the APIMan integration.

• The deployer is an image that is used to deploy the integration. It provides templates and configuration for the other components.
• apiman-builder is a custom builder for OpenShift to build the APIMan components from source.
• ElasticSearch is used as configuration and metrics storage.
• Curator expires data in ElasticSearch to save space.

The image for the integration can be built on OpenShift. Create the builds from the build template:

$ oc new-app -f hack/dev-builds.yaml

This builds from the standard source repository locations. To build from a fork or branch, you can supply template parameters to new-app.

ImageStreams for the deployer components are created and the builds populate them when they complete.

The deployer README gives general directions for deployment. To use images from source builds, supply the IMAGE_PREFIX corresponding to the local registry which can be found in the ImageStreams. For instance, for the following output:

$ oc get is
NAME                   DOCKER REPO                                     TAGS                           UPDATED
apiman-builder         172.30.7.241:5000/apiman/apiman-builder         latest                         18 hours ago
apiman-console         172.30.7.241:5000/apiman/apiman-console         latest                         18 hours ago
apiman-curator         172.30.7.241:5000/apiman/apiman-curator         latest                         18 hours ago
apiman-deployer        172.30.7.241:5000/apiman/apiman-deployer        latest                         18 hours ago
apiman-elasticsearch   172.30.7.241:5000/apiman/apiman-elasticsearch   latest                         18 hours ago
apiman-gateway         172.30.7.241:5000/apiman/apiman-gateway         latest                         18 hours ago
centos                 library/centos                                  6.7,7,latest + 2 more...       18 hours ago
origin                 openshift/origin                                latest,v0.4,v0.5 + 2 more...   18 hours ago

... supply the template parameter IMAGE_PREFIX=172.30.7.241:5000/apiman/ so that the deployer will run with the built image.

Dev builds can be tested with the e2e script. See the testing README for details.