#407 - document solr customizations and multiple cores

docs/using_lagoon/drupal/services/solr.md

@@ -0,0 +1,36 @@
+# Solr
+
+## Standard use
+  For Solr 5.5 and 6.6 we ship the default schema files provided by (search_api_solr)[https://www.drupal.org/project/search_api_solr] version 8.x-1.2. Add the Solr version you would like to us in your docker-compose.yml file, following (our example)[https://github.com/amazeeio/drupal-example/blob/master/docker-compose.yml#L103-L111]
+
+## Custom schema
+To implement schema customizations for Solr in your project look to how Lagoon (creates our standard images)[https://github.com/amazeeio/lagoon/blob/master/images/solr-drupal/Dockerfile].
+
+* In the `solr` section of your docker-compose file replace `image: amazeeio/solr:6.6` with:
+
+```
+  build:
+    context: .
+    dockerfile: Dockerfile.solr
+```
+
+*  Place your schema files in your code repo, we typically like to us `.lagoon/solr`
+*  Create a Dockerfile.solr
+
+```
+FROM amazeeio/solr:6.6
+
+COPY .lagoon/solr /solr-conf/conf
+
+CMD ["solr-precreate", "drupal", "/solr-conf"]
+```
+
+The goal is to have your solr configuration files exist at `/solr-conf/conf` in the image you are building.
+
+## Multiple cores
+
+To implement multiple cores, you will also need to ship your own solr schema as above, the only change needed is to the `CMD` of the Dockerfile, repeat the pattern of `precreate corename /solr-conf/ ;` for each core you require.
+
+```
+CMD ["sh", "-c", "precreate-core drupal /solr-conf/ ; precreate-core core1 /solr-conf/ ; precreate-core core2 /solr-conf/ ; precreate-core core3 /solr-conf/ ; solr start -f"]
+```

mkdocs.yml

@@ -25,8 +25,9 @@ pages:
     - First Deployment: using_lagoon/drupal/first_deployment.md
     - Drush 9: using_lagoon/drupal/drush9.md
     - Services:
-      - Varnish: using_lagoon/drupal/services/varnish.md
       - MariaDB: using_lagoon/drupal/services/mariadb.md
+      - Solr: using_lagoon/drupal/services/solr.md
+      - Varnish: using_lagoon/drupal/services/varnish.md
   - Migrations:
     - From amazee.io: using_lagoon/migrations/amazeeio.md
 - Administration: