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：