archweb

Archweb Readme

Pour obtenir une jolie version de ce document, exécutez

 $ markdown README > README.html

Licence

Voir le fichier de licence.

Auteurs

Voir le fichier des auteurs.

Dépendances

• python
• RSYNC (facultatif pour Mirrorcheck avec des miroirs RSYNC)

Dépendances python

Plus de détails dans requirements.txt et requirements_prod.txt ; Il est préférable d'utiliser VirtualEnv et Pip pour les gérer. Mais si vous insistez sur les packages (Arch Linux), vous voudrez probablement ce qui suit:

• python-django
• python-psycopg2
• Markdown de Python
• python

Installation de tests

1. Exécutez python -m venv env .

    cd /path/to/archweb && python -m venv ./env/
   

2. Activez le virtualenv.

    source ./env/bin/activate
   

3. Installez les dépendances via pip .

    pip install -r requirements.txt
   

4. Copiez local_settings.py.example sur local_settings.py et modifiez. Assurez-vous de décommenter la section de base de données appropriée (SQLite ou PostgreSQL).

5. Migrer les changements.

    ./manage.py migrate
   

6. Chargez les luminaires pour remplir certaines données. Si vous ne voulez pas certaines des données fournies, ajustez le globe de fichier en conséquence.

    ./manage.py loaddata main/fixtures/*.json
    ./manage.py loaddata devel/fixtures/*.json
    ./manage.py loaddata mirrors/fixtures/*.json
    ./manage.py loaddata releng/fixtures/*.json
   

7. Utilisez les commandes suivantes pour démarrer une instance de service

    ./manage.py runserver
   

8. Pour remplir éventuellement la base de données avec des données réelles:

    wget http://mirrors.kernel.org/archlinux/core/os/x86_64/core.db.tar.gz
    ./manage.py reporead x86_64 core.db.tar.gz
    # Package file listing
    wget http://mirrors.kernel.org/archlinux/core/os/x86_64/core.files.tar.gz
    ./manage.py reporead --filesonly x86_64 core.files.tar.gz
   

Alter l'architecture et le dépôt pour obtenir x86_64 et les packages à partir d'autres références si nécessaire.

8. Mises à jour de la base de données pour les packages ajoutés / supprimés

    sqlite3 archweb.db < packages/sql/update.sqlite3.sql
   

Pour PostgreSQL, utilisez des packages / sql / update.postgresql_psycopg2.sql

Tester le serveur SMTP

Pour pouvoir créer un compte sur votre environnement de test, un serveur SMTP est requis. Un serveur SMTP de débogage simple peut être configuré à l'aide de Python et aiosmtpd .

Installer aiosmtpd

    pip install aiosmtpd

Exécuter le serveur

    python -m aiosmtpd -n -l localhost:1025

Dans local_settings.py, ajoutez des entrées pour définir un courriel_host à «localhost» et e-mail_port à 1025.

Exécution des tests et de la couverture

Installez les dépendances de test:

    pip install -r requirements_test.txt

Aux unittests Unittests les commandes suivantes:

    make collectstatic
    make test

Couverture de course:

    make coverage
    make open-coverage

Barre d'outils de débogage de Django

Pour utiliser la barre d'outils Django Debug, installez Django-debug-toolbar et dans local_settings.py set debug_toolbar sur true.

Commandes de gestion

Archweb fournit plusieurs commandes de gestion pour importer divers types de données. Un aperçu des commandes:

• Generate_keyring - Assemblez un clés GPG avec toutes les clés de développement connues.
• PGP_IMPORT - Importez des clés et des signatures à partir d'un clés GPG donné.
• read_rebuilderd_status - Importez le statut Rebuilderd dans archweb.
• RABATCH_DEVELOPERS - Rematch Flag Demandes and Packages où user_id / packager_id est nul à un développeur.
• Reporead - analyse un fichier repo.db.tar.gz, repo.files.tar.gz et met à jour la base de données Arch avec les modifications pertinentes.
• reporead_inotify - regarde un patch de modèle pour les mises à jour de * .files.tar.gz pour mettre à jour les bases de données Arch.
• donor_import - importe un seul donateur d'un courrier passé à stdin
• MirrorCheck - interroger toutes les URL de miroir actif pour stocker l'heure LastSNYC et enregistrer les détails de synchronisation du réseau.
• MirrorResolv - Polltez toutes les URL de miroir actif et déterminez Wheteher, ils ont des adresses IP4 et / ou IPv6.
• Populate_signoffs - récupère le dernier message de validation d'un package éligible à la signalisation.
• Update_planet - Importez tous les flux pour les utilisateurs qui ont un site Web valide et un site Web_RSS dans leur profil utilisateur.
• read_links - lit un fichier repo.links.db.tar.gz et met à jour le modèle Soname.
• read_links_inotify - regarde un patch de modèle pour les mises à jour de * .links.tar.gz pour mettre à jour les bases de données Arch.

Mise à jour des images IPXE

Les binaires requis pour Netboot basés sur IPXE sont mis à jour en les copyant du package IPXE au répertoire de contenu statique (avec le script run_ipxe , les binaires peuvent être testés à l'avance):

 cp -v /usr/share/ipxe/x86_64/ipxe-arch.efi /usr/share/ipxe/ipxe-arch.{ipxe,lkrn} sitestatic/releng

Ensuite, une signature PGP détachée à l'aide d'une touche Packager activée WKD valide est créée pour chaque fichier:

 for artifact in sitestatic/netboot/*.{efi,pxe,lkrn}; do
  gpg --sender "User Name <[email protected]>" --detach-sign "$artifact"
done

Installation de production

Arch Linux a un rôle ANSIBLE pour Archweb dans leur dépôt d'infrastructure.

VIM: Set Syntax = Markdown ET: