Next generation update service for Mozilla products
Python JavaScript HTML Other
Permalink
Failed to load latest commit information.
agent Bug 1310217 - teach the Balrog Agent how to look for and enact Requir… Feb 23, 2017
api-tests Add initial version of contract tests (#210). r=bhearsum Jan 18, 2017
aus-data-snapshots Fix up issues in locale-level-overrides test; address more pep8 stuff… Dec 15, 2015
auslib Web APIs for Required Signoffs (#218). r=nthomas,jlorenzo Feb 21, 2017
client Migrate balrog.submitter.api to balrogclient (#159). r=bhearsum Oct 24, 2016
docs Web APIs for Required Signoffs (#218). r=nthomas,jlorenzo Feb 21, 2017
scripts Bug 1308625 : Preventing same release row data from getting inserted … Jan 27, 2017
ui bug 1304561: move "view data" button next to other Release buttons (#262 Feb 24, 2017
uwsgi Add SeaMonkey to domain whitelists (#250). r=bhearsum Feb 13, 2017
.coveragerc Move coverage config to .coveragerc, turn on branch coverage, and sto… Jan 13, 2016
.dockerignore Add docker-compose support Feb 12, 2016
.editorconfig Bug 1299213 - Clean up ui/* now that no submodule is used (#115). r=b… Sep 12, 2016
.gitattributes Add .gitattributes file (#134). r=bhearsum Oct 4, 2016
.gitignore bug 1315369: pull latest balrogdb from hosted location when rebuildin… Dec 21, 2016
.gitmodules bug 1096531: figure out how to integrate new balrog ui with existing … Nov 20, 2014
.hgignore bug 668345: create initial testing framework for AUS3 - merge in all … Jul 18, 2011
.taskcluster.yml Update .taskcluster.yml with new settings. (#251). r=rail Feb 13, 2017
Dockerfile bug 1315365: Add mysql-client so that mysqldump will be available. (#179 Nov 21, 2016
Dockerfile.dev bug 1304082: fix issues with change notifier in production (#142). r=… Oct 13, 2016
LICENSE Add LICENSE. Sep 19, 2016
MANIFEST.in Include version.txt in MANIFEST.in. Mar 2, 2016
README.rst Update docs with new bug links. (#216) r=jlorenzo Jan 24, 2017
conftest.py Add initial version of contract tests (#210). r=bhearsum Jan 18, 2017
docker-compose-test.yml bug 1304101: Split Dockerfile into dev+prod version (#131). r=rail,jl… Oct 5, 2016
docker-compose.yml Forward SMTP_TLS to balrogadmin to match other env vars Nov 8, 2016
requirements-test.txt Add initial version of contract tests (#210). r=bhearsum Jan 18, 2017
requirements-tox.txt bug 1304101: Split Dockerfile into dev+prod version (#131). r=rail,jl… Oct 5, 2016
requirements.txt Pin Sphinx in requirements.txt (#248). r=jlorenzo Feb 9, 2017
run-tests.sh Use volume mount when running tests in local dev, but not in Taskclus… Oct 17, 2016
setup.py bug 1246675: fully functional balrog agent (#103). r=rail,aki Aug 31, 2016
tox.ini bug 1304101: Split Dockerfile into dev+prod version (#131). r=rail,jl… Oct 5, 2016
version.json bug 1266392: Add link to Taskcluster build in version.json; create ar… Apr 21, 2016
version.txt Version bump. (#258). r=nthomas Feb 21, 2017

README.rst

Balrog

Coverage

Balrog is the software that runs the server side component of the update system used by Firefox and other Mozilla products.

Download

Clone from git using

$ git clone https://github.com/mozilla/balrog

Installation

To run a development environment you must have Docker and docker-compose installed (if you're on Windows or Mac you need "Docker for Windows" or "Docker for Mac" at least v1.12.0)

Once these prerequisites are installed, run the following command to create and run the necessary images:

$ docker-compose up

Once it completes, you should be able to access

Tests

To execute all tests, run

$ ./run-tests.sh

For executing test only for backend, run

$ ./run-tests.sh backend

For executing test only for frontend, run

$ ./run-tests.sh frontend

Tests can also run by using tox

$ tox

Documentation

Balrog's documentation is hosted at http://mozilla-balrog.readthedocs.io/en/latest/index.html

Getting Involved

If you like to get involved in the development of Balrog there're lots of areas where we could use some help. To start with, it's recommended that you look at a Good First Bug. Once you're more comfortable with Balrog, we've got a long list of other bugs ready to be worked on.

Come talk to us in #balrog if you're interested!

If you find a problem and wish to report it, please file a bug .

License

Balrog is released under Mozilla Public License 2.0.