archweb

Archweb readme

要獲得此文檔的漂亮版本，請運行

 $ markdown README > README.html

執照

請參閱許可證文件。

作者

請參閱作者文件。

依賴性

• Python
• rsync（帶rsync鏡子的鏡面檢查可選）

python依賴性

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. copy 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服務器。可以使用Python和aiosmtpd設置簡單的調試SMTP服務器。

安裝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

對Unitests執行以下命令：

    make collectstatic
    make test

運行覆蓋範圍：

    make coverage
    make open-coverage

Django調試工具欄

要使用django調試工具欄安裝django-debug-toolbar和local_settings.py設置debug_toolbar到true。

管理命令

ArchWeb提供了多個管理命令，用於導入各種數據。命令的概述：

• GENTATE_KEYRING-與所有已知開發人員密鑰組裝GPG鍵架。
• PGP_IMPORT-從給定的GPG鍵環的導入密鑰和簽名。
• READ_REBUILDERD_STATUS-將Rebuilderd狀態導入到ArchWeb中。
• rembatch_developers -rembatch flag請求和軟件包在其中user_id/packager_id對開發人員無效。
• reporead -parses repo.db.tar.gz，repo.files.tar.gz文件，並使用相關更改更新Arch數據庫。
• Reporead_Inotify-觀看一個模板修補程序，以更新 *.files.tar.gz以更新Arch數據庫。
• donor_import-從傳遞給stdin的郵件中導入一個捐贈者
• Mirror Check-輪詢每個活動的鏡像URL，以存儲LastSNYC時間並記錄網絡正時詳細信息。
• MIRRERERESOLV-輪詢每個活動鏡URL，並確定它們具有IP4和/或IPv6地址的惠特。
• populate_signoffs-檢索符合簽名包的最新提交消息。
• UPDATE_PLANET-將所有供稿導入所有用戶配置文件中具有有效網站和網站_RSS的用戶。
• read_links-讀取repo.links.db.tar.gz文件並更新Soname模型。
• READ_LINKS_INOTIFY-觀看一個模板補丁，以更新 *.links.tar.gz以更新Arch數據庫。

更新IPXE圖像

通過將IPXE軟件包複製到靜態內容目錄（使用run_ipxe腳本，可以事先測試二進製文件），可以更新基於IPXE的NetBoot所需的二進製文件：

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

之後，使用有效的WKD啟用Packager鍵為每個文件創建了獨立的PGP簽名：

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

生產安裝

Arch Linux在其基礎架構存儲庫中扮演了Ardsible的角色。

VIM：SET語法= Markdown et：