archweb

Archweb Readme

Чтобы получить красивую версию этого документа, запустите

 $ markdown README > README.html

Лицензия

См. Файл лицензии.

Авторы

Смотрите файл авторов.

Зависимости

• питон
• rsync (необязательно для зеркал -зеркал RSYNC)

Зависимости от питона

Более подробно в requirements.txt и requirements_prod.txt ; Лучше всего использовать VirtualEnv и PIP, чтобы справиться с ними. Но если вы настаиваете на пакетах (Arch Linux), вам, вероятно, понадобится следующее:

• Python-Django
• Python-Psycopg2
• Python-Markdown
• Python-Memcached

Тестирование установки

1. Запустите python -m venv env .

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

2. Активировать VirtualEnv.

    source ./env/bin/activate
   

3. Установите зависимости через pip .

    pip install -r requirements.txt
   

4. Скопируйте local_settings.py.example to local_settings.py и изменить. Обязательно не понаблюдайте в соответствующем разделе базы данных (SQLite или PostgreSQL).

5. Мигрировать изменения.

    ./manage.py migrate
   

6. Загрузите приспособления, чтобы заранее заполнить некоторые данные. Если вам не нужны некоторые предоставленные данные, отрегулируйте глобус файла соответственно.

    ./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. Используйте следующие команды, чтобы запустить экземпляр службы

    ./manage.py runserver
   

8. Необязательно заполнить базу данных реальными данными:

    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
   

Измените архитектуру и репо, чтобы получить x86_64 и пакеты из других репо, если это необходимо.

8. Обновления базы данных для добавленных/удаленных пакетов

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

Для PostgreSQL Использовать пакеты/sql/update.postgresql_psycopg2.sql

Тестирование SMTP -сервера

Чтобы иметь возможность создать учетную запись в вашей тестовой среде, требуется SMTP -сервер. Простую отладку SMTP -сервера можно настроить с помощью Python и aiosmtpd .

Установите aiosmtpd

    pip install aiosmtpd

Запустите сервер

    python -m aiosmtpd -n -l localhost:1025

В local_settings.py Добавьте записи, чтобы установить email_host в «localhost» и email_port в 1025.

Проводя тесты и покрытие

Установите тестовые зависимости:

    pip install -r requirements_test.txt

В соответствии с ними выполнять следующие команды:

    make collectstatic
    make test

Покрытие бега:

    make coverage
    make open-coverage

Панель инструментов отладки Джанго

Чтобы использовать панель инструментов отладки Django, установите django-debug-toolbar и в local_settings.py set debug_toolbar в true.

Команды управления

Archweb предоставляет несколько команд управления для импорта различных видов данных. Обзор команд:

• Generate_keyring - Соберите GPG Keyring со всеми известными ключами разработчика.
• PGP_IMPORT - импортные клавиши и подписи из данного GPG Keyring.
• read_rebuilderd_status - Статус Импорта перестраивания в Archweb.
• Reminch_developers - Запросы и пакеты флаг -реванш, где user_id/packager_id является нулевым для разработчика.
• Reporead - Подготовка A Repo.db.tar.gz, Repo.files.tar.gz и обновляет базу данных ARCH с соответствующими изменениями.
• Reporead_inotify - Смотреть шаблон для обновлений *.files.tar.gz для обновления баз данных ARCH.
• Donor_Import - импортируйте одного пожертвователя из почты, переданного в Stdin
• MirrorCheck - Опрос всех активных зеркальных URL -адресов для хранения данных о времени и записи времени сети.
• MirrorResolv - Опрос всех активных зеркальных URL -адресов и определяйте Wheteher, что у них есть адреса IP4 и/или IPv6.
• opulate_signoffs - получает последнее сообщение о коммите пакета, имеющего право.
• update_planet - импортировать все каналы для пользователей, которые имеют действительный веб -сайт и веб -сайт и веб -сайт в своем профиле пользователя.
• read_links - читает файл repo.links.db.tar.gz и обновляет модель Soname.
• read_links_inotify - Смотреть шаблон для обновлений *.links.tar.gz для обновления баз данных Arch.

Обновление изображений IPXE

Двойки, необходимые для NetBoot на основе IPXE, обновляются путем копирования их из пакета IPXE в каталог статического контента (со сценарием run_ipxe , двоичные файлы могут быть протестированы заранее):

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

После этого отдельная подпись PGP с использованием допустимого клавиши WKD с включенным пакетом создается для каждого файла:

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

Производственная установка

Arch Linux играет очень полезную роль для Archweb в их инфраструктурной репо.

VIM: SET SYNTAX = MARCHDONE ET: