A go package for building V2 CF Service Brokers in Go. Depends on lager and gorilla/mux.
Requires go 1.4 or greater.
brokerapi defines a ServiceBroker interface with 7 methods. Simply create
a concrete type that implements these methods, and pass an instance of it to
brokerapi.New, along with a lager.Logger for logging and a
brokerapi.BrokerCredentials containing some HTTP basic auth credentials.
e.g.
package main
import (
"github.com/pivotal-cf/brokerapi"
"github.com/pivotal-golang/lager"
)
type myServiceBroker struct {}
func (*myServiceBroker) Services() []brokerapi.Service {
// Return a []brokerapi.Service here, describing your service(s) and plan(s)
}
func (*myServiceBroker) Provision(
instanceID string,
details brokerapi.ProvisionDetails,
asyncAllowed bool,
) (brokerapi.ProvisionedServiceSpec, error) {
// Provision a new instance here. If async is allowed, the broker can still
// chose to provision the instance synchronously.
}
func (*myServiceBroker) LastOperation(instanceID string) (brokerapi.LastOperation, error) {
// If the broker provisions asynchronously, the Cloud Controller will poll this endpoint
// for the status of the provisioning operation.
// This also applies to deprovisioning (work in progress).
}
func (*myServiceBroker) Deprovision(instanceID string, details brokerapi.DeprovisionDetails, asyncAllowed bool) (brokerapi.IsAsync, error) {
// Deprovision a new instance here. If async is allowed, the broker can still
// chose to deprovision the instance synchronously, hence the first return value.
}
func (*myServiceBroker) Bind(instanceID, bindingID string, details brokerapi.BindDetails) (brokerapi.Binding, error) {
// Bind to instances here
// Return a binding which contains a credentials object that can be marshalled to JSON,
// and (optionally) a syslog drain URL.
}
func (*myServiceBroker) Unbind(instanceID, bindingID string, details brokerapi.UnbindDetails) error {
// Unbind from instances here
}
func (*myServiceBroker) Update(instanceID string, details brokerapi.UpdateDetails, asyncAllowed bool) (brokerapi.IsAsync, error) {
// Update instance here
}
func main() {
serviceBroker := &myServiceBroker{}
logger := lager.NewLogger("my-service-broker")
credentials := brokerapi.BrokerCredentials{
Username: "username",
Password: "password",
}
brokerAPI := brokerapi.New(serviceBroker, logger, credentials)
http.Handle("/", brokerAPI)
http.ListenAndServe(":3000", nil)
}brokerapi defines a handful of error types in service_broker.go for some
common error cases that your service broker may encounter. Return these from
your ServiceBroker methods where appropriate, and brokerapi will do the
right thing, and give Cloud Foundry an appropriate status code, as per the V2
Service Broker API specification.
The error types are:
ErrInstanceAlreadyExists
ErrInstanceDoesNotExist
ErrInstanceLimitMet
ErrBindingAlreadyExists
ErrBindingDoesNotExist
ErrAsyncRequired- 724bdb1
adds a new parameter and return type to
Provisionmethod ofServiceBrokerto support asynchronous provisioning. Also addsLastOperationmethod for the same purpose. - d97ebdd adds a new map property to the
brokerapi.BindDetailsstruct in order to support arbitrary bind parameters. This allows API clients to send configuration parameters with their bind request. - Starting with 10997ba the
Bindfunction now takes an additional input parameter of typebrokerapi.BindDetails. The corresponding struct specifies bind-specific properties sent by the CF API client. - 8d9dd34 adds support for arbitrary provision parameters. The broker can access the
Parametersmap inbrokerapi.ProvisionDetailsto lookup any configuration parameters sent by the client as part of their provision request.