An open API service indexing awesome lists of open source software.

https://github.com/jiayihu/brokerapi-rs

V2.16 Open Service Broker API compliant brokers in Rust
https://github.com/jiayihu/brokerapi-rs

Last synced: 3 months ago
JSON representation

V2.16 Open Service Broker API compliant brokers in Rust

Awesome Lists containing this project

README

          

[![](https://badgen.net/crates/v/brokerapi)](https://crates.io/crates/brokerapi)
[![](https://docs.rs/brokerapi/badge.svg?version=0.1.0)](https://docs.rs/brokerapi/0.1.0/brokerapi/)

A Rust crate for building faster [V2.16 Open Service Brokers](https://github.com/openservicebrokerapi/servicebroker/).

## Installation

Add the dependency to `Cargo.toml`

```toml
[dependencies]
brokerapi = "0.1.0"
```

## Usage:

See in [/examples/osb.rs](/examples/osb.rs) for an example of how to use the crate.

```rust
use actix_web::middleware::Logger;
use actix_web::{guard, web, App, HttpResponse, HttpServer};
use brokerapi::{binding, catalog, polling, service};

#[actix_web::main]
async fn main() -> std::io::Result<()> {
HttpServer::new(|| {
App::new()
.wrap(Logger::new(LOG_DEFAULT))
.data(catalog::CatalogProvider::new(catalog::build_catalog()))
.service(
web::scope("/v2")
.route("/catalog", web::get().to(catalog::get_catalog))
.service(
web::resource("/service_instances/{instance_id}")
.route(web::put().to(service::put_service_instance))
.route(web::get().to(service::get_service_instance))
.route(web::patch().to(service::patch_service_instance))
.route(web::delete().to(service::delete_service_instance))
)
.service(
web::resource("/service_instances/{instance_id}/service_bindings/{binding_id}")
.route(web::put().to(binding::put_binding))
.route(web::get().to(binding::get_binding))
.route(web::delete().to(binding::delete_binding))
)
.route(
"/service_instances/{instance_id}/last_operation",
web::get().to(polling::get_service_instance_last_operation),
)
.route(
"/service_instances/{instance_id}/service_bindings/{binding_id}/last_operation",
web::get().to(polling::get_service_binding_state),
),
)
.default_service(web::route().to(|| HttpResponse::NotFound()))
})
.bind("0.0.0.0:8080")?
.run()
.await
}
```

You can then test the broker using the `svcat` [CLI commands](https://svc-cat.io/docs/cli/). The following commands assume the broker is reaachable by using a local network IP `192.168.1.126:8080`.

```console
svcat register my-broker --url http://192.168.1.126 --scope cluster
svcat get brokers
```

```
NAME NAMESPACE URL STATUS
+--------------+-----------+---------------------------+--------+
fedra-broker http://192.168.1.126:8080 Ready
```