archweb

archweb readme

หากต้องการรับเอกสารนี้เวอร์ชันสวย ๆ ให้เรียกใช้

 $ markdown README > README.html

ใบอนุญาต

ดูไฟล์ใบอนุญาต

ผู้เขียน

ดูไฟล์ผู้เขียน

การพึ่งพาอาศัยกัน

• งูหลาม
• RSYNC (เป็นตัวเลือกสำหรับ MirrorCheck พร้อมกระจก RSYNC)

การพึ่งพา Python

รายละเอียดเพิ่มเติมใน requirements.txt และ requirements_prod.txt ; เป็นการดีที่สุดที่จะใช้ VirtualEnV และ PIP เพื่อจัดการสิ่งเหล่านี้ แต่ถ้าคุณยืนยันแพ็คเกจ (Arch Linux) คุณอาจต้องการสิ่งต่อไปนี้:

• Python-Django
• Python-psycopg2
• Python-Markdown
• งูหลาม

การทดสอบการติดตั้ง

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 ถึง local_settings.py และแก้ไข ตรวจสอบให้แน่ใจว่าไม่สามารถยกเลิกการเขียนบทฐานข้อมูลที่เหมาะสม (ทั้ง SQLite หรือ PostgreSQL)

5. โยกย้ายการเปลี่ยนแปลง

    ./manage.py migrate
   

6. โหลดการติดตั้งเพื่อเติมข้อมูลล่วงหน้า หากคุณไม่ต้องการข้อมูลที่ให้ไว้ให้ปรับไฟล์ Glob ให้เหมาะสม

    ./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
   

เปลี่ยนสถาปัตยกรรมและ repo เพื่อรับ x86_64 และแพ็คเกจจาก repos อื่น ๆ หากจำเป็น

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

ไปยัง unittests ดำเนินการคำสั่งต่อไปนี้:

    make collectstatic
    make test

ความคุ้มครองการวิ่ง:

    make coverage
    make open-coverage

แถบเครื่องมือ Django Debug

ในการใช้แถบเครื่องมือ Django Debug ติดตั้ง Django-debug-toolbar และใน local_settings.py set debug_toolbar เป็น TRUE

คำสั่งการจัดการ

ArchWeb มีคำสั่งการจัดการหลายคำสำหรับการนำเข้าข้อมูลประเภทต่างๆ ภาพรวมของคำสั่ง:

• generate_keyring - ประกอบพวงมาลัย GPG กับคีย์นักพัฒนาที่รู้จักทั้งหมด
• PGP_IMPORT - คีย์นำเข้าและลายเซ็นจากพวงกุญแจ GPG ที่กำหนด
• read_rebuilderd_status - นำเข้าสถานะ rebenilderd ลงใน Archweb
• Rematch_developers - การคัดเลือกคำขอธงและแพ็คเกจที่ user_id/packager_id เป็นโมฆะไปยังนักพัฒนา
• RepoRead - แยกวิเคราะห์ไฟล์ repo.db.tar.gz, repo.files.tar.gz และอัปเดตฐานข้อมูล Arch ด้วยการเปลี่ยนแปลงที่เกี่ยวข้อง
• Reporead_inotify - ดูแพตช์แบบ templated สำหรับการอัปเดตของ *.files.tar.gz เพื่ออัปเดตฐานข้อมูล Arch ด้วย
• donor_import - นำเข้าผู้บริจาครายเดียวจากจดหมายที่ส่งไปยัง stdin
• MirrorCheck - โพล URL Mirror ทุกตัวที่ใช้งานอยู่เพื่อจัดเก็บเวลาสุดท้ายและบันทึกรายละเอียดการกำหนดเวลาเครือข่าย
• Mirrorresolv - โพล URL Mirror ทุกตัวที่ใช้งานอยู่และกำหนดว่าพวกเขามีที่อยู่ IP4 และ/หรือ IPv6
• populate_signoffs - ดึงข้อความคอมมิชชันล่าสุดของแพ็คเกจที่มีสิทธิ์ลงชื่อเข้าใช้
• update_planet - นำเข้าฟีดทั้งหมดสำหรับผู้ใช้ที่มีเว็บไซต์ที่ถูกต้องและเว็บไซต์ _rss ในโปรไฟล์ผู้ใช้ของพวกเขา
• read_links - อ่านไฟล์ repo.links.db.tar.gz และอัปเดตโมเดล soname
• read_links_inotify - ดูแพตช์แบบ templated สำหรับการอัปเดตของ *.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 ที่แยกออกโดยใช้คีย์ Packager ที่เปิดใช้งาน WKD ที่ถูกต้องถูกสร้างขึ้นสำหรับแต่ละไฟล์:

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

การติดตั้งการผลิต

Arch Linux มีบทบาทที่น่าเชื่อถือสำหรับ Archweb ใน repo โครงสร้างพื้นฐานของพวกเขา

VIM: SET SYNTAX = Markdown ET: