README.sandbox

Document option of using docker

Change-Id: I5047447751b37f9cd16c8219ad0eb8c8600b35b1
Reviewed-on: https://review.linaro.org/26156
Reviewed-by: Benjamin Copeland <ben.copeland@linaro.org>

1 files changed, 32 insertions, 0 deletions

diff --git a/README.sandbox b/README.sandbox
index 250c8a9d..4f6db003 100644
--- a/README.sandbox
+++ b/README.sandbox
@@ -105,6 +105,38 @@ To login use private key counterpart of pubkey you used during "lxc-create":
     ssh ubuntu@<IP>
 
 
+Choice 3: Docker
+---------------
+
+With docker ansible docker connection module, it's possible to create sandboxes by
+prepending the playbook you want to try with:
+
+- name: start up sandbox
+  hosts: localhost
+  vars:
+    base_image: ansible/baseimage:16.04
+    docker_hostname: review.linaro.org
+  tasks:
+    - name: start docker container by running bash
+      local_action: docker image={{base_image}} name={{docker_hostname}} detach=yes tty=yes command=bash
+    - name: add the host to inventory
+      add_host: name={{docker_hostname}} groups="all, gerrit"
+
+Change the main part of play to include just the host you want to work on and set the connection to type to docker:
+
+- name: Test gerrit
+  hosts: review.linaro.org
+  connection: docker
+
+And then just run the playbook:
+
+    ansible-playbook gerrit.yml
+
+You can log in to the docker container with:
+
+    docker exec -it review.linaro.org /bin/bash
+
+
 After sandbox bring-up
 ----------------------