Name: bluemix-cloudant-replicator
Owner: IBM jStart
Description: a cf cli plugin for configuring replication between the cloudant databases of a multiregion app
Created: 2016-02-19 21:33:31.0
Updated: 2018-02-28 22:13:30.0
Pushed: 2016-06-09 14:47:36.0
Homepage: http://ibm.biz/bluemix-multiregion
Size: 11227
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
A cf cli plugin for configuring continuous replication between Cloudant databases in multiple regions of IBM Bluemix
If you've already installed the plugin and are updating, run cf uninstall-plugin bluemix-cloudant-replicator before the install.
loudant-replicate [-a APP] [-d DATABASE] [-p PASSWORD] [--all-dbs] [--create]
The plugin will
PASSWORD
to log into each of the different Bluemix regions (using the org and space names of the current target)APP
in each regionDATABASE
(comma-separated) or between all databases when –all-dbs is passedIf you call the command with no arguments, it will interactively prompt you to choose your app and databases from your current cf target. The interactive mode will guide you to your app in each region if necessary.
Running the command will create pair-wise replications between the databases in each region, as shown in the image below.
Configuring continuous replication will result in frequent API calls between the configured regions. With the default (“Shared”) plan on Bluemix, these calls will count toward the totals on your monthly bill. Consider setting Spending notifications to avoid unexpected charges. Alternatively, consider upgrading to an Enterprise plan that is better suited for the continuous replication feature.
There may be a case where you do not want to use all locations or you may want to add additional endpoints. To do this, you must fork the project and modify ENDPOINTS(found in bc-replicator.go). When you do this, it is up to you to recompile the code and re-install the plugin following the same instructions found above. The only difference is you will now point install-plugin to the newly compiled binary path.
This plugin was developed to help automate 'Step 3. Configure Cloudant replication' in this article.