History

Derek Bender c966d809aa Revert "enable better_errors for development part two" This reverts commit `ba72375012`. Change-Id: I6b086a276c00abbebbe781ec42c1a43e3f3cf8fb Closes: CNVS-40917 Reviewed-on: https://gerrit.instructure.com/137873 Tested-by: Jenkins Reviewed-by: Spencer Olson <solson@instructure.com> Reviewed-by: Rob Orton <rob@instructure.com> QA-Review: Eric Coan <ecoan@instructure.com> Product-Review: Derek Bender <djbender@instructure.com>		2018-01-13 00:50:47 +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	Revert "enable better_errors for development part two"	2018-01-13 00:50:47 +00:00
getting_docker.md	fix typo in docker setup readme	2017-11-27 23:07:17 +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.