archweb

ArchWeb Readme

このドキュメントのきれいなバージョンを取得するには、実行してください

 $ markdown README > README.html

ライセンス

ライセンスファイルを参照してください。

著者

著者ファイルを参照してください。

依存関係

• Python
• rsync（rsyncミラー付きのMirrorcheckのオプション）

Python依存関係

requirements.txtの詳細。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を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

Unittestsに次のコマンドを実行します。

    make collectstatic
    make test

ランニングカバレッジ：

    make coverage
    make open-coverage

Djangoデバッグツールバー

Django Debug Toolbarを使用するには、Django-Debug-Toolbarおよびin Local_settings.py in set debug_toolbarをtrueにインストールします。

管理コマンド

ArchWebは、さまざまな種類のデータをインポートするための複数の管理コマンドを提供します。コマンドの概要：

• Generate_Keyring-すべての既知の開発者キーを使用してGPGキーリングを組み立てます。
• PGP_IMPORT-特定のGPGキーリングからキーと署名をインポートします。
• read_rebuilderd_status- rebuilderdステータスをArchwebにインポートします。
• rematch_developers -user_id/packager_idが開発者にnullである場合、フラグのリクエストとパッケージを再戦します。
• Reporead -repo.db.tar.gz、repo.files.tar.gzファイルを解析し、関連する変更でArchデータベースを更新します。
• reporead_inotify- *.files.tar.gzの更新用のテンプレートパッチを監視して、アーチデータベースを更新します。
• DONOR_IMPORT -STDINに渡されたメールから単一の寄付者を輸入する
• MirrorCheck-すべてのアクティブミラーURLを投票して、LastSNYC時間を保存し、ネットワークタイミングの詳細を記録します。
• MirrorSolv-すべてのアクティブミラーURLを投票し、IP4および/またはIPv6アドレスを持っている人を決定します。
• populate_signoffs-サインオフ対応パッケージの最新のコミットメッセージを取得します。
• update_planet-有効なWebサイトとWebサイト_RSSをユーザープロファイルに持っているユーザーにすべてのフィードをインポートします。
• read_links -repo.links.db.tar.gzファイルを読み取り、Sonameモデルを更新します。
• read_links_inotify- *.links.tar.gzの更新用のテンプレートパッチを監視して、アーチデータベースを更新します。

IPXE画像の更新

IPXEベースのNetBootに必要なバイナリは、IPXEパッケージから静的コンテンツディレクトリにコピーすることで更新されます（ run_ipxeスクリプトを使用すると、バイナリは事前にテストされる場合があります）：

 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は、インフラストラクチャリポジトリでArchWebのAnsible役割を持っています。

VIM：SET SYNTAX = MARKDOWN ET：