Overview Broker

Job	Status
Unit
Conformance
Dockerhub

A simple service broker conforming to the Open Service Broker API specification that hosts a dashboard showing information on service instances and bindings created by any platform the broker is registered with.

Other fun features this broker provides include:

Edit the broker catalog without redeploys to speed up testing
History of recent requests and responses
Ability to enable different error modes to test platform integrations
Change the response mode on the fly (sync only/async only/async where possible)
A range of configuration parameter schemas for provision service instance, update service instance and create service binding
Asynchronous service instance provisions, updates and deletes
Asynchronous service binding creates and deletes
Fetching service instances and bindings
Generic extensions for fetching the Health and Info for a service instance

What is the Open Service Broker API?

Open Service Broker API

The Open Service Broker API project allows developers, ISVs, and SaaS vendors a single, simple, and elegant way to deliver services to applications running within cloud native platforms such as Cloud Foundry, OpenShift, and Kubernetes. The project includes individuals from Fujitsu, Google, IBM, Pivotal, RedHat and SAP.

Quick start

Dockerhub

The latest version of overview-broker can always be found on Dockerhub. You can pull and run the latest image with:

docker pull ismteam/overview-broker
docker run ismteam/overview-broker

Build it

git clone git@github.com:cloudfoundry/overview-broker.git
cd overview-broker
npm install

# Start overview-broker
npm start

# Or to run the tests
npm test

Configuration

To set the BasicAuth credentials, set the BROKER_USERNAME and BROKER_PASSWORD environmental variables. Otherwise the defaults of admin and password will be used.
To expose a route service, set the ROUTE_URL environmental variable to a url. It must have https scheme.
To expose a syslog drain service, set the SYSLOG_DRAIN_URL environmental variable to a url.
To expose a volume mount service, set the EXPOSE_VOLUME_MOUNT_SERVICE environmental variable to true.
To generate many plans with a range of configuration parameter schemas, set the ENABLE_EXAMPLE_SCHEMAS environmental variable to true.
By default, all asynchronous operations take 1 second to complete. To override this, set the ASYNCHRONOUS_DELAY_IN_SECONDS environmental variable to the number of seconds all operations should take.
To specify how long platforms should wait before timing out an asynchronous operation, set the MAXIMUM_POLLING_DURATION_IN_SECONDS environmental variable.
To specify how long Platforms should wait in between polling the /last_operation endpoint for service instances or bindings, set the POLLING_INTERVAL_IN_SECONDS environmental variable to the number of seconds a platform should wait before trying again.
To change the name of the service(s) exposed by the service broker, set the SERVICE_NAME environmental variable.
To change the description of the service(s) exposed by the service broker, set the SERVICE_DESCRIPTION environmental variable.
To set the response mode of the service broker (note that this can also be changed via the broker dashboard), set the RESPONSE_MODE environmental variable to one of the available modes.
To set the error mode of the service broker (note that this can also be changed via the broker dashboard), set the ERROR_MODE environmental variable to one of the available modes.

Platforms

Cloud Foundry

1. Deploying the broker

First you will need to deploy the broker as an application:

cf push overview-broker -i 1 -m 256M -k 256M --random-route -b https://github.com/cloudfoundry/nodejs-buildpack

You can also use an application manifest to deploy the broker as an application:

wget https://raw.githubusercontent.com/cloudfoundry/overview-broker/master/examples/cloudfoundry/manifest.yaml
cf push

The overview broker dashboard should now be accessible:

open "https://$(cf app the-best-broker | awk '/routes:/{ print $2 }')/dashboard"

2. Registering the broker

To register the broker to a space (does not require admin credentials), run:
```
cf create-service-broker --space-scoped overview-broker admin password <url-of-deployed-broker>
```
The basic auth credentials "admin" and "password" can be specified if needed (see Configuration).
The services and plans provided by this broker should now be available in the marketplace:
```
cf marketplace
```

3. Creating a service instance

Now for the exciting part... it's time to create a new service instance:
```
cf create-service overview-service small my-instance
```
You can give your service a specific name in the dashboard by providing the name configuration parameter:
```
cf create-service overview-service small my-instance -c '{ "name": "My Service Instance" }'
```
If you now head back to the dashboard, you should see your new service instance!

4. Creating a service binding

To bind the service instance to your application, you will need to first push an application to Cloud Foundry with cf push. You can then create a new binding with:
```
cf bind-service <app-name> my-instance
```

Kubernetes

1. Deploying the broker

Deploy the broker and a load balancer that will be used to access it:

wget https://raw.githubusercontent.com/cloudfoundry/overview-broker/master/examples/kubernetes/overview-broker-app.yaml
wget https://raw.githubusercontent.com/cloudfoundry/overview-broker/master/examples/kubernetes/overview-broker-service.yaml
kubectl create -f overview-broker-app.yaml
kubectl create -f overview-broker-service.yaml

You can check this has succeeded by running kubectl get deployments and kubectl get services.

Once the load balancer is up and running, he overview broker dashboard should be accessible:

open "http://$(kubectl get service overview-broker-service -o json | jq -r .status.loadBalancer.ingress[0].ip)/dashboard"

2. Registering the broker

To register the broker, you first need to install the Service Catalog. The instructions to do this can be found here. If service catalog fails to install due to permissions, you might want to look at this guide.

You should now be able to register the service broker you deployed earlier by creating a clusterservicebrokers custom resource:

BROKER_URL="http://$(kubectl get service overview-broker-service -o json | jq -r .status.loadBalancer.ingress[0].ip)"
cat <<EOF | kubectl create -f -
apiVersion: v1
kind: Secret
metadata:
  name: overview-broker-secret
  namespace: default
type: Opaque
stringData:
  username: admin
  password: password
EOF
cat <<EOF | kubectl create -f -
apiVersion: servicecatalog.k8s.io/v1beta1
kind: ClusterServiceBroker
metadata:
  name: overview-broker
  namespace: default
spec:
  url: ${BROKER_URL}
  authInfo:
    basic:
      secretRef:
        name: overview-broker-secret
        namespace: default
EOF

Note that if you changed the default basic auth credentials (see Configuration), then you will need to change the Secret defined above.

The services and plans provided by this broker should now be available:
```
kubectl get clusterserviceclasses
kubectl get clusterserviceplans
```

3. Creating a service instance

Now for the exciting part... it's time to create a new service instance:

cat <<EOF | kubectl create -f -
apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceInstance
metadata:
  name: my-instance
  namespace: default
spec:
  clusterServiceClassExternalName: overview-service
  clusterServicePlanExternalName: small
EOF

If you now head back to the dashboard, you should see your new service instance!

4. Creating a service binding

Creating a service binding with service-catalog will result in a new Secret being created which represents the information returned from the service broker for the binding. To create a new service binding, you can run:
```
cat <<EOF | kubectl create -f -
apiVersion: servicecatalog.k8s.io/v1beta1
kind: ServiceBinding
metadata:
  name: my-instance-binding
  namespace: default
spec:
  instanceRef:
    name: my-instance
  secretName: my-instance-secret
EOF
```
To see the contents of the service binding, you can get the associated secret with:
```
kubectl get secret my-instance-secret -o yaml
```
Note that the data shown will be base64 encoded.

cloudfoundry / overview-broker

readme

Overview Broker

What is the Open Service Broker API?

Quick start

Dockerhub

Build it

Configuration

Platforms

Cloud Foundry

1. Deploying the broker

2. Registering the broker

3. Creating a service instance

4. Creating a service binding

Kubernetes

1. Deploying the broker

2. Registering the broker

3. Creating a service instance

4. Creating a service binding