BMO/DeveloperBox: Difference between revisions

From MozillaWiki
< BMO
Jump to navigation Jump to search
No edit summary
No edit summary
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Creating a BMO Development System using VirtualBox and Vagrant ==
== Creating a BMO Development System using Docker ==


=== Getting your system setup ===
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
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.


* Install Virtualbox on your workstation (http://www.virtualbox.org)
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
* Install Vagrant on your workstation (http://www.vagrantup.com/)
contrib/docker directory.


=== Installing and running the BMO Vagrant box ===
  $ git clone https://git.mozilla.org/webtools/bmo/bugzilla.git docker-bugzilla
  $ cd docker-bugzilla/docker


* Create following file called 'Vagrantfile' in a directory by itself.
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.
 
  Vagrant.configure("2") do |config|
    config.vm.box = "bugzilla"
    config.vm.box_url = "https://people.mozilla.com/~dkl/bugzilla.box"
    config.vm.network :forwarded_port, guest: 80, host: 8080
  end
 
* Execute the following in the directory where the 'Vagrantfile' is located. This will download the box and then start the VM.
 
  $ vagrant up
 
* The following will log you into the VM over SSH and drop you into the 'vagrant' user's home directory.
 
$ vagrant ssh
 
=== Working with the latest BMO code in the VM ===
 
* For starters you will need change your login password to a known value and also make yourself a Bugzilla admin (substitute your bmo address below).
 
  $ vagrant ssh
  $ cd ~/htdocs/bmo
  $ ./checksetup.pl --make-admin=<email> --reset-password=<email>
 
* You should now be able to access the web UI at http://localhost:8080/bmo using your browser on the same system.
** You may need to update the values for urlbase and sslbase in /home/vagrant/htdocs/bmo/data/params to match the port number you chose for redirection earlier. If the port is different than 8080.
 
* Updating the BZR code to the latest revision. Note: http://doc.bazaar.canonical.com/migration/en/survival/bzr-for-git-users.html
 
  $ cd ~/htdocs/bmo
  $ bzr merge  (This will merge upstream changes into your local branch. There may be conflicts if you have made changes as well)
  $ bzr commit (commit the merged files to your branch)
 
* Run the built in test suite located in the /home/vagrant/htdocs/bmo/t directory.
 
  $ perl runtests.pl
 
* You can run just one of the tests in /t, for example to run the template compilation tests:
 
  perl t/004template.t
 
* Making a patch for review of your latest changes
** (see https://wiki.mozilla.org/Bugzilla:Patches)
** This will place the patch file in your home directory of the laptop and not on the VM so you can easily upload, etc.
 
  $ cd ~/htdocs/bmo
  $ bzr diff > /vagrant/<some_patch_name>_1.patch
 
* File any bugs or feature requests [https://bugzilla.mozilla.org/enter_bug.cgi?product=bugzilla.mozilla.org&component=Developer%20Box here]

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.

Retrieved from "https://wiki.mozilla.org/index.php?title=BMO/DeveloperBox&oldid=1104656"