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)
- 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
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. | - |
- Push the broker into CF i.e.
cf push - Register service broker in CF :
cf create-service-broker cloudkarafka admin P455w0rd https://cloudkarafka-broker.{{ domain }}
Finally you need to allow access to the broker e.g. cf enable-service-access cloudkarafka
See the contribution guidelines.
Please NOTE the broker is still under development and does not intend to be used in production.
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.