Replace docker.sh with Markdown

.gitignore

@@ -101,7 +101,6 @@ $RECYCLE.BIN/
 #=========================
 #Markdwon
 #========================
-*.md
 *.html
 .RData
 wiki

README.md

@@ -51,7 +51,7 @@ The package can be installed on Windows, Linux and macOS via a provided Docker c
 and "Apply & Restart". This is in order to run the SQL Server container
 otherwise it won't even start up.
 
-3. Open a Terminal and run [docker.sh](docker.sh)
+3. Open a Terminal with the repository as the working directory and follow [the instructions](UsingDocker.md)
 
 The **bcp** and **sqlcmd** tools are also [now available](https://docs.microsoft.com/en-us/sql/linux/sql-server-linux-setup-tools#macos)
 for macOS and Docker.
@@ -133,4 +133,3 @@ See the *rsqlserver* wiki page on [benchmarking](https://github.com/agstudy/rsql
 ## Acknowledgements
 
 I want to thank Jean-Michel Perraud the author of [rClr](http://r2clr.codeplex.com/) package.
-

UsingDocker.md

@@ -0,0 +1,120 @@
+# Using rsqlserver with Docker
+
+This file contains instructions on building a Docker container
+containing 'rsqlserver' side-by-side with an MS SQL Server database
+
+If you have any problems or questions please raise an issue
+
+## Command Line R
+
+### Pull the latest Docker images
+
+Due to the size of the Docker images, this may take some time depending
+on your internet speed however this "pull" step is a once-off and further
+updates to the images will make use of your existing local caches.
+
+```sh
+docker pull ruaridhw/rsqlserver:latest && docker pull microsoft/mssql-server-linux:latest
+```
+
+### Start up the server container
+
+Your Docker instance will need to be allocated at least 3-4GB of memory in
+order for the database to successfully start up.
+
+```sh
+docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=Password12!' -h mydockermsdb -p 1433:1433 --name mssqldb -d microsoft/mssql-server-linux
+```
+
+Edit the database password, hostname `-h` and container name `--name`
+parameters if required. It is possible (and advisable) to change the database
+password later once running to avoid showing it as plaintext.
+
+
+### Run a query against the server
+```sh
+docker exec -t mssqldb /opt/mssql-tools/bin/sqlcmd \
+   -S localhost -U SA -P 'Password12!' \
+   -Q "CREATE DATABASE rsqlserverdb;
+       GO
+       USE rsqlserverdb;
+       CREATE TABLE Inventory (id INT, name NVARCHAR(50), quantity INT);
+       INSERT INTO Inventory VALUES (1, 'banana', 150), (2, 'orange', 154);
+       GO
+       SELECT * FROM Inventory WHERE quantity > 152;"
+#> Changed database context to 'rsqlserverdb'.
+#>
+#> (2 rows affected)
+#> id          name                                               quantity
+#> ----------- -------------------------------------------------- -----------
+#>          2 orange                                                     154
+#>
+#> (1 rows affected)
+```
+
+### Run a command in the rsqlserver R session container
+```sh
+docker run --name testrsqlserver --link=mssqldb --rm ruaridhw/rsqlserver Rscript \
+   -e "library(rsqlserver)" \
+   -e "con <- dbConnect('SqlServer', host = 'mydockermsdb', dbname = 'rsqlserverdb', user = 'SA', password = 'Password12!')" \
+   -e "dbReadTable(con, 'Inventory')"
+#> Loading required package: methods
+#> Loading required package: rClr
+#> Assembly '/usr/local/lib/R/site-library/rClr/libs/ClrFacade.dll' doesn't have an entry point.
+#> Loading the dynamic library for Mono runtime...
+#> Loaded Common Language Runtime version 4.0.30319.17020
+#>   id   name quantity
+#> 1  1 banana      150
+#> 2  2 orange      154
+```
+
+The "Assembly entry point" warning message is a bug with rClr and can be ignored
+
+### Re-enter the R session interactively
+```sh
+docker run --name rsqlserver --link=mssqldb -i ruaridhw/rsqlserver
+#> R version 3.4.2 (2017-09-28) -- "Short Summer"
+#> Copyright (C) 2017 The R Foundation for Statistical Computing
+#> Platform: x86_64-pc-linux-gnu (64-bit)
+#> ...
+#> >
+```
+
+## RStudio
+
+In order to use RStudio instead for easier interactivity over command line R,
+you can replace the Dockerfile in this repository with the two files located [here](https://github.com/ruaridhw/dockerfiles/tree/master/rsqlserver/rstudio)
+
+The "Pull" command now requires a build from the local Dockerfile:
+
+```sh
+docker build -t rsqlserver-rstudio . && docker pull microsoft/mssql-server-linux:latest
+```
+
+For the `run` command, it is possible to persist a local directory on your
+host machine through to the container and have any updates to either directory
+immediately reflected in the other instance:
+
+```sh
+docker run -d -p 8787:8787 --name rsqlstudio --link=mssqldb \
+   --mount type=bind,source=/path/to/local/rsqlserver,destination=/home/rstudio/rsqlserver \
+   rsqlserver-rstudio
+```
+
+In this example, `/path/to/local/rsqlserver` is a copy of the repository on the
+host machine which is replicated at `/home/rstudio/rsqlserver` on the container
+
+The RStudio server will run as a service on the container so simply open
+a local browser window pointing to http://localhost:8787 and login using
+the username and password "rstudio"
+
+When you are done, call `docker stop rsqlstudio` to stop the server and `docker start rsqlstudio` whenever you need it again. The `run` command
+is only for the container instantiation.
+
+### Tested in the following environments:
+
+```
+R version 3.4.1 (2017-06-30)
+Platform: x86_64-apple-darwin15.6.0 (64-bit)
+Operating System: macOS Sierra 10.12.6
+```