BMO/DeveloperBox: Difference between revisions

Latest revision as of 21:50, 6 November 2015

Creating a BMO Development System using Docker

Getting Bugzilla, as well as the latest code that is used by bugzilla.mozilla.org, installed and running locally in order to make changes, fix bugs, etc. is not the easiest thing for every one to do. Especially if you are not familiar with Linux systems, the Perl programming language, or installing all of the many CPAN module dependencies needed for Bugzilla to work properly. This Developer Box is designed to help people to be able to get up and running quickly and easily by providing a ready to run Docker container that should work on most platforms.

First you will need to check the latest BMO source code from https://git.mozilla.org/webtools/bmo/bugzilla into a local directory and change into the contrib/docker directory.

 $ git clone https://git.mozilla.org/webtools/bmo/bugzilla.git docker-bugzilla
 $ cd docker-bugzilla/docker

For instructions on how to get your platform setup to run Docker as well as information on how to start the container, see the README.md file in the current directory.

@@ Line 1: / Line 1: @@
-=== Creating a BMO Development System using VirtualBox and Vagrant ===
+== Creating a BMO Development System using Docker ==
-* Install Virtualbox on your workstation (http://www.virtualbox.org)
+Getting Bugzilla, as well as the latest code that is used by [http://bugzilla.mozilla.org bugzilla.mozilla.org], installed and running locally in order to
-* Install Vagrant on your workstation (http://www.vagrantup.com/)
+make changes, fix bugs, etc. is not the easiest thing for every one to do. Especially if you are not familiar with Linux systems, the Perl programming
-* From a terminal type: (note: ~7G file)
+language, or installing all of the many CPAN module dependencies needed for Bugzilla to work properly. This Developer Box is designed to help people
-  vagrant init
+to be able to get up and running quickly and easily by providing a ready to run Docker container that should work on most platforms.
-   vagrant box add bmo https://people.mozilla.com/~dkl/bugzilla.box
-* Edit Vagrantfile to allow port forward to VM of port 80
+First you will need to check the latest BMO source code from https://git.mozilla.org/webtools/bmo/bugzilla into a local directory and change into the
-   Uncomment line that says:
+contrib/docker directory.
-  # config.vm.forward_port 80, 8080
-* To start the VM:
+   $ git clone https://git.mozilla.org/webtools/bmo/bugzilla.git docker-bugzilla
-  vagrant up
+   $ cd docker-bugzilla/docker
-* To login simply type:
-  vagrant ssh
+For instructions on how to get your platform setup to run Docker as well as information on how to start the container, see the [https://github.com/mozilla/webtools-bmo-bugzilla/blob/master/docker/README.md README.md] file in the current directory.
-* Access the BMO UI at http://localhost:8080/bmo using your browser
-* To update the BMO code to latest in bzr:
-  vagrant ssh
-  cd htdocs/bmo
-  bzr merge
-* To make a patch of your changes:
-  bzr diff > /vagrant/<some_patch_name>_1.patch
-This will place the patch file in your home directory of the laptop and not on the VM
-so you can easily upload, etc.