archweb

Archweb readme

Untuk mendapatkan versi cantik dari dokumen ini, jalankan

 $ markdown README > README.html

Lisensi

Lihat file lisensi.

Penulis

Lihat File Penulis.

Dependensi

• Python
• Rsync (opsional untuk mirrorcheck dengan cermin rsync)

Ketergantungan Python

Lebih detail dalam requirements.txt dan requirements_prod.txt ; Yang terbaik adalah menggunakan VirtualEnv dan PIP untuk menangani ini. Tetapi jika Anda bersikeras pada paket (Arch Linux), Anda mungkin menginginkan yang berikut:

• Python-Django
• Python-psycopg2
• Markdown Python
• Python-memacached

Pengujian instalasi

1. Jalankan python -m venv env .

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

2. Aktifkan VirtualEnv.

    source ./env/bin/activate
   

3. Pasang dependensi melalui pip .

    pip install -r requirements.txt
   

4. Salin local_settings.py.example ke local_settings.py dan ubah. Pastikan untuk membongkar bagian basis data yang sesuai (baik SQLite atau PostgreSQL).

5. Migrasi perubahan.

    ./manage.py migrate
   

6. Muat perlengkapan untuk mengisi beberapa data. Jika Anda tidak ingin beberapa data yang disediakan, sesuaikan file Glob yang sesuai.

    ./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. Gunakan perintah berikut untuk memulai instance layanan

    ./manage.py runserver
   

8. Untuk secara opsional mengisi database dengan data nyata:

    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
   

Ubah arsitektur dan repo untuk mendapatkan x86_64 dan paket dari repo lain jika diperlukan.

8. Pembaruan database untuk paket yang ditambahkan/dihapus

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

Untuk POSTGRESQL Gunakan paket/sql/update.postgresql_psycopg2.sql

Menguji server SMTP

Untuk dapat membuat akun di lingkungan pengujian Anda diperlukan server SMTP. Server SMTP debugging sederhana dapat diatur menggunakan Python dan aiosmtpd .

Instal aiosmtpd

    pip install aiosmtpd

Jalankan server

    python -m aiosmtpd -n -l localhost:1025

Di local_settings.py menambahkan entri untuk mengatur email_host ke 'localhost' dan email_port ke 1025.

Menjalankan tes dan cakupan

Instal Ketergantungan Tes:

    pip install -r requirements_test.txt

Kepada yang Unittest melaksanakan perintah berikut:

    make collectstatic
    make test

Cakupan Menjalankan:

    make coverage
    make open-coverage

Toolbar Debug Django

Untuk menggunakan django debug toolbar instal django-debug-toolbar dan di local_settings.py set debug_toolbar ke true.

Perintah manajemen

Archweb menyediakan beberapa perintah manajemen untuk mengimpor berbagai jenis data. Tinjauan perintah:

• Generate_keyring - Rakitkan keyring GPG dengan semua kunci pengembang yang dikenal.
• PGP_Import - Kunci impor dan tanda tangan dari keyring GPG yang diberikan.
• read_rebuilderd_status - Impor status pembangunan kembali ke Archweb.
• Rematch_Developers - Permintaan dan paket bendera ulang di mana user_id/packager_id nol ke pengembang.
• Reporead - Parses a repo.db.tar.gz, repo.files.tar.gz File dan perbarui database ARCH dengan perubahan yang relevan.
• reporead_inotify - menonton patch templated untuk pembaruan *.files.tar.gz untuk memperbarui database arch dengan.
• Donor_import - Impor satu donator dari surat yang diteruskan ke Stdin
• MirrorCheck - Polling setiap URL cermin aktif untuk menyimpan waktu lastsnyc dan merekam detail waktu jaringan.
• Mirrorresolv - Polling setiap URL cermin aktif dan tentukan wahah mereka memiliki alamat IP4 dan/atau IPv6.
• POPULATE_SIGNOFFS - Mengambil pesan komit terbaru dari paket yang memenuhi syarat.
• update_planet - Impor semua umpan untuk pengguna yang memiliki situs web dan situs web_rss yang valid di profil pengguna mereka.
• read_links - Membaca file repo.links.db.tar.gz dan memperbarui model Soname.
• read_links_inotify - menonton patch templated untuk pembaruan *.links.tar.gz untuk memperbarui database arch dengan.

Memperbarui gambar IPXE

Binari yang diperlukan untuk netboot berbasis IPXE diperbarui dengan menyalinnya dari paket IPXE ke direktori konten statis (dengan skrip run_ipxe Binari dapat diuji sebelumnya):

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

Setelah itu tanda tangan PGP yang terpisah menggunakan kunci Packager yang diaktifkan WKD yang valid dibuat untuk setiap file:

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

Instalasi Produksi

Arch Linux memiliki peran yang tidak jelas untuk Archweb dalam repo infrastruktur mereka.

vim: atur sintaks = markdown et: