History

Spencer Olson 0b7d4135a0 tweak docker_dev_setup script Adds the dinghy tap before trying to install it. Test Plan: 1. On a machine running OSX without dinghy installed, run the docker_dev_setup script. Verify dinghy is set up without issue. Change-Id: I0479323aefd21554fb3bc2a8f00ced727b497496 Reviewed-on: https://gerrit.instructure.com/132850 Reviewed-by: Omar Khan <okhan@instructure.com> Tested-by: Jenkins QA-Review: Omar Khan <okhan@instructure.com> Product-Review: Omar Khan <okhan@instructure.com>		2017-11-15 22:19:08 +00:00
..
README.md	tweak docker_dev_setup script	2017-11-15 22:19:08 +00:00
consul.md	Add rake task to populate Consul from dynamic_settings.yml	2017-09-19 18:08:39 +00:00
developing_with_docker.md	Add docker_dev_setup.sh script	2017-11-01 23:02:50 +00:00
getting_docker.md	Add docker_dev_setup.sh script	2017-11-01 23:02:50 +00:00

README.md

Using Docker to run Canvas

Prerequisites

You need Docker. Don't have Docker yet? Go here for details on getting it setup.

Development

This command should get you going:

./script/docker_dev_setup.sh

Now you can do docker-compose up and you should be good to go. If you're using Dinghy or Dory. You should be able to access Canvas by going to: http://canvas.docker/

On Linux you may want to run this to avoid a few permissions issues:

touch mkmf.log .listen_test
chmod 777 !:2 !:3
sudo chown -R `whoami`:9999 .
chmod 775 gems/canvas_i18nliner
chmod 775 . log tmp gems/selinimum gems/canvas_i18nliner
chmod 664 ./app/stylesheets/_brand_variables.scss

For more information checkout Developing with Docker

Known Issues

Long URL Gateway 502

If a URL is long enough, you may see a Gateway 502 error. This problem has been patched in dinghy-http-proxy#36 however until a new release is cut the follow can be done as a work around:

In ~/.dinghy/proxy.conf add the following:

proxy_buffers 8 1024k;
proxy_buffer_size 1024k;

Restart dinghy afterwards.