Next generation update service for Mozilla products
Python JavaScript HTML Other
Permalink
Failed to load latest commit information.
agent bug 1398237: Only make version tags when releasing (#424) Oct 13, 2017
api-tests bug 1407392: remove support for backgroundInterval (#426). r=bhearsum Oct 18, 2017
aus-data-snapshots Fix up issues in locale-level-overrides test; address more pep8 stuff… Dec 15, 2015
auslib bug 1311765: Add rule_id to INSERT to rules email (#393). r=bhearsum,… Nov 9, 2017
client Bug 1384540: use releng image for test runner (#358). r=bhearsum Jul 27, 2017
docs bug 1402411: add support for JAWS in SYSTEM_CAPABILITIES (#433). r=jl… Oct 19, 2017
scripts Add debug info to stage db reset script. Nov 7, 2017
ui bug 1403974: improving styling on "ASAP" button to make it clear that… Nov 9, 2017
uwsgi Revert "Bug 1380605 - add new OpenH264 download host to whitelists (#363 Aug 4, 2017
.coveragerc Move coverage config to .coveragerc, turn on branch coverage, and sto… Jan 13, 2016
.dockerignore bug 1276289: fix coveralls.io support Jul 19, 2017
.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 1376331: improve database initialization for dev environments (#397 Oct 12, 2017
.pyup.yml Set-up pyup. Jul 13, 2017
.taskcluster.yml bug 1398237: Only make version tags when releasing (#424) Oct 13, 2017
Dockerfile Add another missing script to docker container (#434). r=bhearsum Oct 17, 2017
Dockerfile.database Bug 1344716: Add health checks to Docker-compose file (#297). r=bhearsum Apr 7, 2017
Dockerfile.dev Install curl in dev dockerfile to try to get coveralls working. Jul 19, 2017
LICENSE Add LICENSE. Sep 19, 2016
MANIFEST.in bug 1325377 - reorg of web code and swaggerification of existing publ… May 10, 2017
README.rst Add Taskcluster badge. Oct 25, 2017
conftest.py Add initial version of contract tests (#210). r=bhearsum Jan 18, 2017
docker-compose.yml bug 1384816: Bump retries for balrogadmin (#359). r=nthomas Jul 28, 2017
requirements-test.txt bug 1386756: allow mig64 query argument to be present (#369). r=jlorenzo Aug 10, 2017
requirements-tox.txt bug 1276289: fix coveralls.io support Jul 19, 2017
requirements.txt Update connexion (#423) Oct 13, 2017
run-tests.sh Remove systemCapabilities column (#350). r=nthomas Jul 20, 2017
setup.py Bug 1331992: Update the requirement files with working hash values an… Mar 15, 2017
tox.ini bug 1276289: fix coveralls.io support Jul 19, 2017
version.json bug 1266392: Add link to Taskcluster build in version.json; create ar… Apr 21, 2016
version.txt Version bump ahead of next release. Oct 27, 2017

README.rst

Balrog

CI 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

The run-tests.sh script runs tests inside a Docker container, which is convenient but can be slow. You can also set up a virtualenv yourself and run tests "locally" using tox:

$ tox

or py.test:

$ py.test -n2 --cov=. --doctest-modules auslib

Note that Docker may have set files to be owned by root, so you may need to chmod -R $(whoami) . to make them writable by tox and hypothesis.

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.