From a8db810d24494137b58d207ea41e1569e943bd6f Mon Sep 17 00:00:00 2001 From: Dylan William Hardison Date: Mon, 12 Feb 2018 12:25:45 -0500 Subject: Add docker-compose setup for local development --- README.rst | 39 +++++++++++++++++++++++++++++++-------- 1 file changed, 31 insertions(+), 8 deletions(-) (limited to 'README.rst') diff --git a/README.rst b/README.rst index 555d5f951..2a7006fd6 100644 --- a/README.rst +++ b/README.rst @@ -14,16 +14,14 @@ BMO is Mozilla's highly customized version of Bugzilla. 1.2 Making Changes and Seeing them 1.3 Technical Details 1.4 Perl Shell (re.pl, repl) - 2 Docker Container - 2.1 Container Arguments - 2.2 Environmental Variables - 2.3 Persistent Data Volume - -If you are looking to run Bugzilla, you should see -https://github.com/bugzilla/bugzilla. + 2 Using Docker Compose (For Development) + 3 Docker Container + 3.1 Container Arguments + 3.2 Environmental Variables + 3.3 Persistent Data Volume If you want to contribute to BMO, you can fork this repo and get a local copy -of BMO running in a few minutes using Vagrant. +of BMO running in a few minutes using Vagrant or Docker. Using Vagrant (For Development) =============================== @@ -148,6 +146,31 @@ You can use the 'p' command (provided by `Data::Printer`_) to inspect variables .. _`Devel::REPL`: https://metacpan.org/pod/Devel::REPL .. _`Data::Printer`: https://metacpan.org/pod/Data::Printer + +Using Docker (For Development) +============================== + +While not yet as featureful or complete as the vagrant setup, this repository now contains a +docker-compose file that will create a local bugzilla for testing. + +To use docker-compose, ensure you have the latest Docker install for your environemnt +(Linux, Windows, or Mac OS). + +.. code-block:: bash + + docker-compose up --build + + +Then, you must configure your browser to use http://localhost:1091 as an HTTP proxy. +For setting a proxy in Firefox, see `Firefox Connection Settings`_. +The procecure should be similar for other browsers. + +.. _`Firefox Connection Settings`: https://support.mozilla.org/en-US/kb/connection-settings-firefox + +After that, you should be able to visit http://bmo-web.vm/ from your browser. +You can login as vagrant@bmo-web.vm with the password "vagrant01!" (without +quotes). + Docker Container ================ -- cgit v1.2.3-24-g4f1b