Balrog ist die Software, die die serverseitige Komponente des von Firefox und anderen Mozilla -Produkten verwendeten Aktualisierungssystems ausführt.
Um eine Entwicklungsumgebung auszuführen, müssen Docker und Docker-Compose installiert sein (wenn Sie unter Windows oder Mac sind, benötigen Sie mindestens v1.12.0 "Docker for Windows" oder "Docker für Mac").
Wenn Sie Zugriff darauf haben, richten Sie das Maschinen -Token für den Agenten ein. Wenn Sie keinen Zugriff darauf haben, überspringen Sie diesen Schritt einfach. Der Agent wird nicht funktionieren, aber alles andere wird funktionieren.
$ export auth0_m2m_client_secret = abcdef123456
Führen Sie den folgenden Befehl aus, um die erforderlichen Container zu erstellen und auszuführen:
$ docker-compose up
Notiz
Auf Arm (M1) Chips
Stellen Sie sicher, dass Sie eine aktuelle Version von Docker Compose ausführen:
$ docker-compose Version Docker komponieren Version V2.2.3
Führen Sie dann den folgenden Befehl aus, um die erforderlichen Container zu erstellen und auszuführen:
$ docker-compose -f docker-compose.yml -f docker-compose.arm.yml up
Sobald es abgeschlossen ist, sollten Sie in der Lage sein, zugreifen zu können
http: // localhost: 9010 - Die öffentliche API
https: // localhost: 8010 - Die Admin -API
https: // localhost: 9000 - Die Administratorschnittstelle
Sie müssen die selbst signierten SSL -Zertifikate in Ihrem Browser für jede der oben genannten Links akzeptieren, damit alles (insbesondere die Benutzeroberfläche) richtig funktioniert.
Sie müssen die Schaltfläche "Anmelden ..." verwenden, um mit der Admin -Schnittstelle etwas Nützliches zu tun, wodurch Sie aufgefordert werden, sich bei einem Drittanbieter anzumelden (zB Google Mail, GitHub). Wenn Sie dies getan haben, führen Sie Folgendes aus, um einen lokalen Administratorbenutzer zu erstellen, um einen Schreibzugriff zu erhalten:
$ export local_admin = <E -Mail -Adresse, in der Sie sich angemeldet haben,> $ docker-compose rennen balrogadmin create-lokal-admin
Um alle Tests auszuführen, führen Sie einfach aus:
$ tox
Dadurch werden alle Unit -Tests in einem Docker -Container durchgeführt.
Die Dokumentation von Balrog wird unter http://mozilla-balrog.readthedocs.io/en/latest/index.html gehostet
Balrog wird unter Mozilla Public Lizenz 2.0 veröffentlicht.