archweb

Archweb Readme

Um eine hübsche Version dieses Dokuments zu erhalten

 $ markdown README > README.html

Lizenz

Siehe Lizenzdatei.

Autoren

Siehe Autorendatei.

Abhängigkeiten

• Python
• RSYNC (optional für MirrorCheck mit RSYNC -Spiegeln)

Python -Abhängigkeiten

Weitere Details in requirements.txt und requirements_prod.txt ; Es ist am besten, Virtualenv und PIP zu verwenden, um diese zu verarbeiten. Wenn Sie jedoch auf (Arch Linux) Paketen bestehen, möchten Sie wahrscheinlich Folgendes:

• Python-Django
• Python-psycopg2
• Python-Markdown
• Python-Memcached

Testen der Installation

1. python -m venv env .

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

2. Aktivieren Sie den virtuellenv.

    source ./env/bin/activate
   

3. Installieren Sie Abhängigkeiten über pip .

    pip install -r requirements.txt
   

4. Kopieren Sie local_settings.py.example in local_settings.py und ändern Sie. Stellen Sie sicher, dass Sie den entsprechenden Datenbankabschnitt (entweder SQLite oder postgreSQL) überzeugen.

5. Veränderungen migrieren.

    ./manage.py migrate
   

6. Laden Sie die Vorrichtungen so, dass einige Daten vorgefertigt sind. Wenn Sie einige der bereitgestellten Daten nicht möchten, passen Sie die Dateikugel entsprechend an.

    ./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. Verwenden Sie die folgenden Befehle, um eine Serviceinstanz zu starten

    ./manage.py runserver
   

8. Um die Datenbank optional mit echten Daten zu füllen:

    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
   

Ändern Sie Architektur und Repo, um bei Bedarf X86_64 und Pakete von anderen Repos zu erhalten.

8. Datenbankaktualisierungen für hinzugefügte/entfernte Pakete

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

Für postgresql verwenden Pakete/sql/update.postgresql_psycopg2.sql

Testen von SMTP -Server

Um in Ihrer Testumgebung ein Konto erstellen zu können, ist ein SMTP -Server erforderlich. Ein einfacher Debugging -SMTP -Server kann mit Python und aiosmtpd eingerichtet werden.

Installieren Sie aiosmtpd

    pip install aiosmtpd

Führen Sie den Server aus

    python -m aiosmtpd -n -l localhost:1025

In local_setings.py fügen Sie Einträge hinzu, um E -Mail_host auf 'localhost' und E -Mail_port auf 1025 festzulegen.

Ausführen von Tests und Abdeckung

Installieren Sie die Testabhängigkeiten:

    pip install -r requirements_test.txt

In den Einittestern führen die folgenden Befehle aus:

    make collectstatic
    make test

Laufberichterstattung:

    make coverage
    make open-coverage

Django -Debug -Symbolleiste

Um die Django-Debug-Symbolleiste zu verwenden, installieren Sie Django-Debug-Toolbar und in Local_Settings.py debug_toolbar auf true.

Verwaltungsbefehle

Archweb bietet mehrere Verwaltungsbefehle zum Importieren verschiedener Datenarten. Ein Überblick über Befehle:

• generate_keyring - montieren Sie einen GPG -Schlüsselring mit allen bekannten Entwicklerschlüssel.
• PGP_IMPORT - Importieren von Schlüssel und Unterschriften aus einem bestimmten GPG -Schlüsselring.
• Read_Rebuilderd_Status - Importieren Sie den Status des Rebuilderd in Archweb.
• Rematch_Developer - Rematch Flag -Anforderungen und -Pakete, in denen user_id/packager_id für einen Entwickler null ist.
• Reporead - Pariert eine repo.db.tar.gz, repo.files.tar.gz -Datei und aktualisiert die Arch -Datenbank mit den relevanten Änderungen.
• reporead_inotify - schaut sich einen Vorlagen -Patch nach Updates von *.Files.tar.gz an, um die Bogendatenbanken mit zu aktualisieren.
• DONOR_IMPORT - Importieren Sie einen einzelnen Spender aus einer E -Mail an Stdin übergeben
• MILRORCECK - Um alle aktiven Mirror -URLs zu befragen, um die Zeitdetails zum Zeitpunkt der Lastsnyc zu speichern und das Netzwerk -Timing -Timing -Details aufzunehmen.
• Mirrorresolv - Bestimmen Sie jede aktive Mirror -URLs und bestimmen Sie, dass sie IP4- und/oder IPv6 -Adressen haben.
• Populate_signoffs - Ruft die neueste Commit -Nachricht eines Signoff -fähigen Pakets ab.
• UPDATE_PLANET - Importieren Sie alle Feeds für Benutzer, die eine gültige Website und Website_RSS in ihrem Benutzerprofil haben.
• read_links - liest eine repo.links.db.tar.gz -Datei und aktualisiert das Sonamesmodell.
• read_links_inotify - schaut sich einen Vorlagen -Patch nach Updates von *.links.tar.gz an, um die Bogendatenbanken mit zu aktualisieren.

Aktualisieren von IPXE -Bildern

Die für IPXE -basierten Netboot erforderlichen Binärdateien werden aktualisiert, indem sie aus dem IPXE -Paket auf das statische Inhaltsverzeichnis kopiert werden (mit dem Skript run_ipxe , die die Binärdateien zuvor getestet werden können):

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

Danach wird für jede Datei eine abgelöste PGP -Signatur mit einem gültigen WKD -fähigen Packager -Schlüssel erstellt:

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

Produktionsinstallation

Arch Linux spielt eine ansible Rolle für Archweb in ihrem Infrastruktur -Repo.

VIM: Set syntax = markdown et: