Dockerized Sandbox Runtime

This is a Dockerized version of the Sandbox runtime suitable for local testing. For more information on Sandbox, please visit the website at [https://getsandbox.com/].

RUNNING

The Sandbox server will start on port 8080 using the default main.js Sandbox API definition.

docker run --name sandbox \
           -p 8080:8080 \
           deardooley/getsandbox

You can access the api by directing your browser to http://<docker_host>/test.

DEVELOPMENT

In order to publish your own definition, mount your own definition file in the /sandbox directory.

The following command will start a sandbox container and serve the example/main.js mock api definition.

docker run --name sandbox \
           -p 8080:8080 \
           -v $(pwd)/example:/sandbox \
           deardooley/getsandbox

Note: To include external dependencies into your test suite, just include them in the mounted directory and reference them as relative paths to the /sandbox directory.

MICROSERVICE ORCHESTRATION

To maintain logical separation of your microservices yet, keep a logical cohesion to your development space, use a dynamic proxy to expose each API behind a single URL structure.

proxy:
  image: jwilder/nginx-proxy
  ports:
    - "80:80"
    - "443:443"
  volumes:
    - /var/run/docker.sock:/tmp/docker.sock:ro

users:
  image: deardooley/getsandbox
  environment:
    - "VIRTUAL_HOST=users.example.com"
  volumes:
    - ./example:/sandbox

test:
  image: deardooley/getsandbox
  environment:
    - "VIRTUAL_HOST=test.example.com"