BMO is Mozilla's highly customized version of Bugzilla.
Contents
If you are looking to run Bugzilla, you should see https://github.com/bugzilla/bugzilla.
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.
You will need to install the following software:
- Vagrant 1.9.1 or later
Doing this on OSX can be accomplished with homebrew:
brew install vagrant
For Ubuntu 16.04, download the vagrant .dpkg directly from https://vagrantup.com. The one that ships with Ubuntu is too old.
From your BMO checkout run the following command:
vagrant up
Depending on the speed of your computer and your Internet connection, this will take from a few minutes to much longer.
If this fails, please file a bug using this link.
Otherwise, you should have a working BMO developer machine!
To test it, you'll want to add an entry to /etc/hosts for bmo-web.vm pointing to 192.168.3.43.
After that, you should be able to visit http://bmo-web.vm/ from your browser. You can login as [email protected] with the password "vagrant01!" (without quotes).
After editing files in the bmo directory, you will need to run
vagrant rsync && vagrant provision --provision-with update
to see the changes applied to your vagrant VM. If the above command fails or db is changed, do a full provision:
vagrant rsync && vagrant provision
This Vagrant environment is a very complete but scaled-down version of production BMO. It uses roughly the same RPMs (from CentOS 6, versus RHEL 6 in production) and the same perl dependencies (via https://github.com/mozilla-bteam/carton-bundles).
It includes a couple example products, some fake users, and some of BMO's real groups. Email is disabled for all users; however, it is safe to enable email as the box is configured to send all email to the 'vagrant' user on the web vm.
Most of the cron jobs and the jobqueue daemon are running. It is also configured to use memcached.
The push connector is not currently configured, nor is the Pulse publisher.
Installed on the vagrant vm is also a program called re.pl.
re.pl an interactive perl shell (somtimes called a REPL (short for Read-Eval-Print-Loop)). It loads Bugzilla.pm and you can call Bugzilla internal API methods from it, an example session is reproduced below:
re.pl
$ my $product = Bugzilla::Product->new({name => "Firefox"});
Took 0.0262260437011719 seconds.
$Bugzilla_Product1 = Bugzilla::Product=HASH(0x7e3c950);
$ $product->name
Took 0.000483036041259766 seconds.
Firefox
It supports tab completion for file names, method names and so on. For more information see Devel::REPL.
You can use the 'p' command (provided by Data::Printer) to inspect variables as well.
$ p @INC
[
[0] ".",
[1] "lib",
[2] "local/lib/perl5/x86_64-linux-thread-multi",
[3] "local/lib/perl5",
[4] "/home/vagrant/perl/lib/perl5/x86_64-linux-thread-multi",
[5] "/home/vagrant/perl/lib/perl5",
[6] "/vagrant/local/lib/perl5/x86_64-linux-thread-multi",
[7] "/vagrant/local/lib/perl5",
[8] "/usr/local/lib64/perl5",
[9] "/usr/local/share/perl5",
[10] "/usr/lib64/perl5/vendor_perl",
[11] "/usr/share/perl5/vendor_perl",
[12] "/usr/lib64/perl5",
[13] "/usr/share/perl5",
[14] sub { ... }
]
This repository is also a runnable docker container.
Currently, the entry point takes a single command argument. This can be httpd or shell.
- httpd
- This will start apache listening for connections on
$PORT
- shell
- This will start an interactive shell in the container. Useful for debugging.
- PORT
- This must be a value >= 1024. The httpd will listen on this port for incoming plain-text HTTP connections.
- BMO_db_driver
- What SQL database to use. Default is mysql. List of supported databases can be obtained by listing Bugzilla/DB directory - every module corresponds to one supported database and the name of the module (before ".pm") corresponds to a valid value for this variable.
- BMO_db_host
- The DNS name or IP address of the host that the database server runs on.
- BMO_db_name
- The name of the database.
- BMO_db_user
- The database user to connect as.
- BMO_db_pass
- The password for the user above.
- BMO_site_wide_secret
- This secret key is used by your installation for the creation and validation of encrypted tokens. These tokens are used to implement security features in Bugzilla, to protect against certain types of attacks. It's very important that this key is kept secret.
- BMO_inbound_proxies
- This is a list of IP addresses that we expect proxies to come from. This can be '*' if only the load balancer can connect to this container. Setting this to '*' means that BMO will trust the X-Forwarded-For header.
- BMO_memcached_namespace
- The global namespace for the memcached servers.
- BMO_memcached_servers
- A list of memcached servers (ip addresses or host names). Can be empty.
- BMO_shadowdb
- The database name of the read-only database.
- BMO_shadowdbhost
- The hotname or ip address of the read-only database.
- BMO_shadowdbport
- The port of the read-only database.
- BMO_apache_size_limit
- This is the max amount of unshared memory (in kb) that the apache process is allowed to use before Apache::SizeLimit kills it.
This container expects /app/data to be a persistent, shared, writable directory owned by uid 10001. This must be a shared (NFS/EFS/etc) volume between all nodes.