Managed HA RabbitMQ 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

CloudAMQP Broker

Overview

CloudAMQP Broker provides RabbitMQ message broker instanses on demand as a Cloud Foundry service. The broker does not include a RabbitMQ server or cluster. Instead, it is meant to be deployed alongside a managed CloudAMQP account, which provide provision and maintainace of RabbitMQ instances though APIs.

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

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

Installation

1. Compile source code and package

  • Checkout the CloudAMQP broker from github and enter the project's directory.
$ git clone https://github.com/ipolyzos/cloudamqp-broker.git
$ cd cloudamqp-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
CLOUDAMQP_API_URL The default API URL as provided by CloudAMQO documentation i.e. https://cloud.mongodb.com/api/atlas/v1.0
CLOUDAMQP_REGION Region to provision servers. (please advie CloudAMQP Documentaion for the list of available regions) amazon-web-services::eu-west-1
CLOUDAMQP_API_KEY API Key as generated from CloudAMQP. -

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 cloudamqp admin P455w0rd https://cloudamqp-broker.{{ domain }}

3. Enable access to the broker

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

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.