Add docker instructions.

docs/installation/docker.md

@@ -0,0 +1,109 @@
+# Docker Compose (ISLE)
+
+The ISLE Islandora Enterprise 8 Prototype ([Islandora-Devops/isle-dc](https://github.com/Islandora-Devops/isle-dc)) is a Docker project to manage Islandora 8 infrastructure under Docker using Docker Compose. These instructions cover the basics of using Docker locally to create a development Islandora sandbox. More detailed configuration options are described in the project's [README](https://github.com/Islandora-Devops/isle-dc).
+
+## Why use Docker?
+
+Docker is a way to separate out your site (i.e. all the files and configurations and data that you entered) from the underlying software that runs it (e.g. webserver, database engine, etc). This allows for easier upgrades, faster development, and more flexible deployment. The ISLE project, run by the Islandora Collaboration Group (ICG) was the driving force behing dockerizing Islandora. 
+
+## Requirements
+
+* Docker (version 19.x+)
+
+To see if you have Docker installed, type `docker --version` in a shell. 
+
+## Installing Docker
+
+If you are installing Docker, we recommend using the application [Docker Desktop](https://www.docker.com/products/docker-desktop). It provides a GUI for managing Docker container in Windows and MacOS, along with the Docker engine and suite of command-line tools. Linux users can download the Engine and command-line tools from that same link. 
+
+There is also a legacy project called [Docker Toolbox](https://docs.docker.com/toolbox/overview/) which may be of interest if your machine cannot run Docker Desktop, or if you already have it installed. 
+
+
+[Download Docker](https://www.docker.com/products/docker-desktop) 
+
+
+## Launching Islandora with Docker
+
+In a shell, clone the isle-dc project. In that directory, enter the command `make` (or `make dev` - see note) to build the docker infrastructure. Then use the command `docker-compose up -d` to start the containers.
+
+!!! Note
+    The `make` command alone will spin up a sandbox-like version of Isle on the front end, but the code files will be inaccessible. The `make dev` command will copy the files locally in a way that is live to the Isle site. This method takes longer, but is required if you will be testing pull requests or writing code. 
+
+```bash
+clone https://github.com/islandora-devops/isle-dc
+cd isle-dc
+make
+```
+
+
+Results:
+```
+isle-dc$ make
+  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
+                                 Dload  Upload   Total   Spent    Left  Speed
+100  3562  100  3562    0     0  12779      0 --:--:-- --:--:-- --:--:-- 12812
+  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
+                                 Dload  Upload   Total   Spent    Left  Speed
+100  1708  100  1708    0     0   6809      0 --:--:-- --:--:-- --:--:--  6832
+docker-compose pull
+Pulling activemq   ... done
+Pulling alpaca     ... done
+Pulling blazegraph ... done
+Pulling cantaloupe ... done
+Pulling fcrepo     ... done
+Pulling fits       ... done
+Pulling crayfits   ... done
+Pulling gemini     ... done
+Pulling homarus    ... done
+Pulling houdini    ... done
+Pulling hypercube  ... done
+Pulling mariadb    ... done
+Pulling matomo     ... done
+Pulling milliner   ... done
+Pulling recast     ... done
+Pulling solr       ... done
+Pulling drupal     ... done
+Pulling traefik    ... done
+Pulling watchtower ... done
+```
+
+!!! Troubleshooting
+    If you get an error such as: `ERROR: Version in "./docker-compose.activemq.yml" is unsupported.`, then you need to upgrade Docker, and then enter the command `make clean`. If you forget to `make clean`, then the next time `make` runs you may see an error such as: `ERROR: Top level object in './docker-compose.yml' needs to be an object not '<class 'NoneType'>'.`
+
+!!! Troubleshooting
+    If you get an error such as: `make[1]: *** [create-codebase-from-demo] Error 143 make: *** [dev] Error 21` ... documentation to come.
+
+
+Once `make` has successfully completed, launch the Isle containers using `docker-compose up`. The `-d` flag allows you to return to using the command line. Without it, your shell will be stuck in the `docker-compose` process as long as the containers are running.
+
+
+```bash
+docker-compose up -d
+```
+
+## Visiting your Islandora site
+
+Direct a browser to [https://islandora-isle-dc.traefik.me/](https://islandora-isle-dc.traefik.me/) (yes, it's awkward and we hope to resolve that). Your first time, you will probably see a white screen. This will persist until all containers are successfully warmed up. Then, you should see a basic Drupal login screen.
+
+[ image of the white screen ]
+[ image of the login screen ]
+
+To log in:
+
+* username: **admin**
+* password: **password**
+
+!!! Note
+    `docker logs -tf isle-dc_drupal_1` shows Docker logs
+
+## Spinning down your Islandora site
+
+To shut down the containers without destroying your site, use `docker-compose down`. To also destroy your data, use `docker-compose down -v`.
+
+## Editing Code
+
+Documentation to come.
+
+## Updating Isle 
+
+Documentation to come.

docs/installation/playbook.md

@@ -1,6 +1,6 @@
 # Islandora Playbook
 
-The Islandora Playbook ([islandora-playbook](https://github.com/Islandora-Devops/islandora-playbook)) is a tool for installing Islandora Defaults. It can be used both as a Vagrant project to create a local development environment, or as an Ansible playbook which can provision a remote server. 
+The Islandora Playbook ([Islandora-Devops/islandora-playbook](https://github.com/Islandora-Devops/islandora-playbook)) is a tool for installing Islandora Defaults on a single virtual machine. It can be used both as a [Vagrant](https://www.vagrantup.com/) project to create a local development environment, and/or as an [Ansible](https://www.ansible.com/community) playbook which can provision a remote server.
 
 !!! Note 
     This repository has two active branches. The **main** branch's playbook will install the latest release of Islandora and its components. The **dev** branch, when configured to use Ansible, will provision with the most recent code of Islandora and its components. 

mkdocs.yml

@@ -37,7 +37,8 @@ nav:
   - Overview: 'index.md'
   - Installation:
       - 'Component Overview': 'installation/component_overview.md'
-      - 'Automatic Provisioning': 'installation/playbook.md'
+      - 'Ansible Playbook': 'installation/playbook.md'
+      - 'Docker (Isle)': 'installation/docker.md'
       - Manual Installation:
         - 'Introduction': 'installation/manual/introduction.md'
         - 'Preparing a LAPP Webserver': 'installation/manual/preparing_a_webserver.md'