Skip to main content

A python package for the V2 CF Service Broker API and Open Broker API (version 2.10+)

Project description

Build Status Coverage Status

Service Broker API

A Python package for building Service Brokers supporting API version 2.10+.

Following CF Service Broker API and Open Service Broker API

Installation

This package is available for Python 3.6+.

pip3 install openbrokerapi

Or install the development version from github:

pip3 install git+https://github.com/eruvanos/openbrokerapi.git

Getting started

from flask import Flask
from openbrokerapi import service_broker
from openbrokerapi.api import *
from openbrokerapi.log_util import *

# Implement a service broker by overriding methods of ServiceBroker
class CustomServiceBroker(service_broker.ServiceBroker):
    def catalog(self) -> List[Service]:
        pass

    def provision(self, instance_id: str, service_details: ProvisionDetails, async_allowed: bool) -> ProvisionedServiceSpec:
        pass

    def unbind(self, instance_id: str, binding_id: str, details: UnbindDetails):
        pass

    def update(self, instance_id: str, details: UpdateDetails, async_allowed: bool) -> UpdateServiceSpec:
        pass

    def bind(self, instance_id: str, binding_id: str, details: BindDetails) -> Binding:
        pass

    def deprovision(self, instance_id: str, details: DeprovisionDetails, async_allowed: bool) -> DeprovisionServiceSpec:
        pass

    def last_operation(self, instance_id: str, operation_data: str) -> LastOperation:
        pass

# Simpely start the server
serve(CustomServiceBroker(), BrokerCredentials("", ""))

# or register blueprint to your own FlaskApp instance
app = Flask(__name__)
logger = basic_config() #  Use root logger with a basic configuration provided by openbrokerapi.log_utils
openbroker_bp = get_blueprint(CustomServiceBroker(), BrokerCredentials("",""), logger)
app.register_blueprint(openbroker_bp)
app.run("0.0.0.0")

Error Types

Openbrokerapi defines a handful of error types in errors.py for some common error cases that your service broker may encounter. Raise these from your ServiceBroker methods where appropriate, and openbrokerapi will do the “right thing” (™), and give Cloud Foundry an appropriate status code, as per the Service Broker API specification.

Not Planned To Support

  • Provisioning
    • Response: 200 - If service already exists, a 409-Conflict will be returned
  • Bind
    • Response: 200 - If binding already exists, a 409-Conflict will be returned

Bugs or Issues

Please report bugs, issues or feature requests to Github Issues

Release Notes

v0.3.1

  • fix api.serve

v0.3

  • use LastOperationResponse for last_operation response
  • fix: catalog response was not convertible to json
  • fix: not required fields were still in catalog response
  • add missing tests for catalog endpoint
  • support for VolumeMounts is tested

v0.2

  • improve testing
  • fix: Bind and update getting dict instead of expected objects
  • support async for provision, update and deprovision
  • Handle unexpected exception with global error_handler (responding with 500)
  • get_blueprint() now expects a logger
  • add log_utils with basic_config()

v0.1

  • initial version
  • supported operations
  • provision
  • update
  • bind
  • unbind
  • deprovision

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openbrokerapi, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size openbrokerapi-0.3.1.tar.gz (12.0 kB) File type Source Python version None Upload date Hashes View
Filename, size openbrokerapi-0.3.1-py3-none-any.whl (21.3 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page