Added example of custom forests

Author: rjrudin

examples/custom-forests-and-replicas-project/README.md

@@ -0,0 +1,6 @@
+This project shows an example of configuring any forests and replicas you'd like for a database. See
+the forests/custom-forest-example-content directory.
+
+Note that you'll need to run this against a cluster with at least two nodes (failover requires three nodes, but you
+only need two nodes to see how ml-gradle will create replica forests).
+ 

examples/custom-forests-and-replicas-project/build.gradle

@@ -0,0 +1,3 @@
+plugins {
+	id "com.marklogic.ml-gradle" version "2.3.0-RC1"
+}

examples/custom-forests-and-replicas-project/gradle.properties

@@ -0,0 +1,7 @@
+mlHost=localhost
+mlAppName=custom-forest-example
+mlRestPort=8013
+mlUsername=admin
+mlPassword=admin
+mlContentForestsPerHost=1
+

examples/custom-forests-and-replicas-project/src/main/ml-config/databases/content-database.json

@@ -0,0 +1,3 @@
+{
+  "database-name": "%%DATABASE%%"
+}

examples/custom-forests-and-replicas-project/src/main/ml-config/forests/custom-forests-example-content/README.md

@@ -0,0 +1,14 @@
+Starting in version 2.3.0 of ml-gradle, both mlDeploy and mlDeployCustomForests will process
+each directory under ./ml-config/forests. The directory can be named anything - but a good practice is
+to name it after the database for the forests, just to keep things simple. 
+
+Currently, only JSON files in the directories are supported. A JSON file may contain a single JSON object,
+defining a single forest, or it can contain an array of many JSON objects, each defining a single forest. This
+is a little different from how ml-gradle normally works, where the contents of a file match exactly what
+the Management REST API expects. But in this scenario, where it's common to have many forests that are all
+very similar in their configuration, it seemed worth supporting an array of objects to avoid creating a lot
+of different files. 
+
+Also, note that the custom forests all use "localhost". It's more common, in a large cluster, to specify
+the exact host so you have precise control over where each forest is created.
+

examples/custom-forests-and-replicas-project/src/main/ml-config/forests/custom-forests-example-content/custom-forests.json

@@ -0,0 +1,14 @@
+[
+	{
+		"forest-name": "custom-forests-example-content-custom-1",
+		"enabled": true,
+		"host": "localhost",
+		"database": "%%DATABASE%%"
+	},
+	{
+		"forest-name": "custom-forests-example-content-custom-2",
+		"enabled": true,
+		"host": "localhost",
+		"database": "%%DATABASE%%"
+	}
+]

examples/custom-forests-and-replicas-project/src/main/ml-config/forests/custom-forests-example-content/single-custom-forest.json

@@ -0,0 +1,6 @@
+{
+	"forest-name": "custom-forests-example-content-custom-3",
+	"enabled": true,
+	"host": "localhost",
+	"database": "%%DATABASE%%"
+}