Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/fedora-infra/mirrormanager2

Rewrite of the MirrorManager application in Flask and SQLAlchemy
https://github.com/fedora-infra/mirrormanager2

Last synced: about 2 months ago
JSON representation

Rewrite of the MirrorManager application in Flask and SQLAlchemy

Awesome Lists containing this project

README 

        
Fedora MirrorManager

====================



MirrorManager2 is a rewrite of `mirrormanager `_

using flask and SQLAlchemy.



MirrorManager is the application that keeps track of the nearly 400 public mirrors,

and over 300 private mirrors, that carry Fedora, EPEL, and RHEL content, and is used

by rpmfusion.org, a third party repository. It automatically selects the "best"

mirror for a given user based on a set of fallback heuristics.



The complete MirrorManager functionality requires `generate-mirrorlist-cache`

and `mirrorlist-server` which can be found at

https://github.com/adrianreber/mirrorlist-server.



Mailing list for announcements and discussions:

https://lists.fedoraproject.org/archives/list/[email protected]/



The full documentation is hosted on ReadTheDocs:

http://mirrormanager.readthedocs.io/



Hacking

-------



Using Tinystage

~~~~~~~~~~~~~~~

MirrorManager2 authenticates using OpenID Connect. For this, it requires an

OIDC provider, and the tiny-stage environment provides that.



Download tiny-stage from Github with::



    $ git clone https://github.com/fedora-infra/tiny-stage

    $ cd tiny-stage



Now install Ansible, Vagrant and the vagrant-libvirt plugin from the official

Fedora repos, and startup tiny-stage::



    $ sudo dnf install ansible vagrant vagrant-libvirt vagrant-sshfs

    $ vagrant up ipa auth



It takes a bit of time, but tiny-stage will now be installed, with dummy users

and groups.



Hacking with Vagrant

~~~~~~~~~~~~~~~~~~~~

Quickly start hacking on mirrormanager2 using the vagrant setup that is included

in the repo is super simple.



From within main directory (the one with the Vagrantfile in it) of your git

checkout of mirrormanager2, run the ``vagrant up`` command to provision your dev

environment::



    $ vagrant up



When this command is completed (it may take a while) you will be able to the

command to start the mirrormanager server::



    $ vagrant ssh -c "sudo systemctl restart mirrormanager2"



Once that is running, simply go to https://mirrormanager2.tinystage.test/ in

your browser on your host to see your running mirrormanager test instance.



Manual Setup

~~~~~~~~~~~~

Here are some preliminary instructions about how to stand up your own instance

of mirrormanager2. All required packages for MirrorManager2 are part of Fedora

or RHEL/CentOS/EPEL. In the following example we will, however use a virtualenv

and a sqlite database and we will install our dependencies from the Python

Package Index (PyPI).



Note: this setup still needs tiny-stage running.



First, install development dependencies::



    $ sudo dnf install poetry tox



Next, install MirrorManager's dependencies::



    $ poetry install



Tinystage has a self-signed certificate, it needs to be added to the known

certificates::



    $ curl -k https://ipsilon.tinystage.test/ca.crt >> $(poetry run python -m certifi)

    $ poetry run oidc-register https://ipsilon.tinystage.test/idp/openidc/ http://localhost:5000/authorize



You should then create your own sqlite database for your development instance of

mirrormanager2::



    $ poetry run flask -A mirrormanager2.app db sync



If all goes well, you can start a development instance of the server by

running::



    $ poetry run ./runserver.py



Open your browser and visit http://localhost:5000 to check it out.



Once you made your changes please run the test suite to verify that nothing

covered by tests has been broken::



    $ tox