Managed Apache Kafka servers in the cloud
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
.gitignore
CONTRIBUTING.md
LICENSE
NOTICE
README.md
manifest-sample.yml
pom.xml

README.md

CloudKarafka Broker

Overview

CloudKarafka Broker offers hosted publish-subscribe messaging systems in the cloud instanses on demand as a Cloud Foundry service. The broker does not include a Apache Kafka server or cluster. Instead, it is meant to be deployed alongside a managed CloudKarafka account, which provide provision and maintainace of Apache Kafka instances though APIs.

The CloudKarafka Broker tasks that the broker performs are as follows:

  • Provisioning of a Apache Kafka broker instances (create)
  • Provide access to broker credentials (bind)
  • Remove access to broker credentials (unbind)
  • Remove of Apache Kafka instanses instances (delete)
  • Update instance plan (update)

Installation

1. Compile source code and package

  • Checkout the CloudKarafka broker from github and enter the project's directory.
$ git clone https://github.com/ipolyzos/cloudkarafka-broker.git
$ cd cloudkarafka-broker
  • Clean compile and package the project.
$ > mvn clean
$ > mvn package

2. Edit the manifest.yml file.

The sample manifest.yml provided can be used as a reference. The specific variables for the mongodb atlas broker are :

Key Description Default
CLOUDKARAFKA_API_URL The default API URL as provided by CloudKarafka documentation i.e. https://cloud.mongodb.com/api/atlas/v1.0
CLOUDKARAFKA_REGION Region to provision servers. (please advie CloudKarafka Documentaion for the list of available regions) amazon-web-services::eu-west-1
CLOUDKARAFKA_API_KEY API Key as generated from CloudKarafka. -

3. Push the code and create register thr broker

  1. Push the broker into CF i.e. cf push
  2. Register service broker in CF :
cf create-service-broker cloudkarafka admin P455w0rd https://cloudkarafka-broker.{{ domain }}

3. Enable access to the broker

Finally you need to allow access to the broker e.g. cf enable-service-access cloudkarafka

Developing

See the contribution guidelines.

Disclaimer

Please NOTE the broker is still under development and does not intend to be used in production.

License

Copyright 2017 Ioannis Polyzos

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.