archweb

Archweb Readme

Para obtener una versión bonita de este documento, ejecute

 $ markdown README > README.html

Licencia

Ver archivo de licencia.

Autores

Ver archivo de autores.

Dependencias

• pitón
• RSYNC (opcional para Mirrorcheck con espejos RSYNC)

Dependencias de Python

Más detalle en requirements.txt y requirements_prod.txt ; Es mejor usar VirtualEnv y PIP para manejarlos. Pero si insiste en los paquetes (Arch Linux), probablemente desee lo siguiente:

• python-django
• Python-Psycopg2
• Markdown de Python
• Python-Memcached

Instalación de pruebas

1. Run python -m venv env .

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

2. Active el VirtualEnv.

    source ./env/bin/activate
   

3. Instalar dependencias a través de pip .

    pip install -r requirements.txt
   

4. Copie local_settings.py.example a local_settings.py y modifique. Asegúrese de desenchufar la sección de base de datos apropiada (ya sea SQLite o PostgreSQL).

5. Migrar cambios.

    ./manage.py migrate
   

6. Cargue los accesorios para precopular algunos datos. Si no desea algunos de los datos proporcionados, ajuste la globa del archivo en consecuencia.

    ./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. Use los siguientes comandos para iniciar una instancia de servicio

    ./manage.py runserver
   

8. Para completar opcionalmente la base de datos con datos reales:

    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
   

Altere la arquitectura y el repositorio para obtener X86_64 y los paquetes de otros reposos si es necesario.

8. Actualizaciones de la base de datos para paquetes agregados/eliminados

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

Para PostgreSQL, use paquetes/sql/update.postgresql_psycopg2.sql

Prueba del servidor SMTP

Para poder crear una cuenta en su entorno de prueba, se requiere un servidor SMTP. Se puede configurar un servidor SMTP de depuración simple utilizando Python y aiosmtpd .

Instalar aiosmtpd

    pip install aiosmtpd

Ejecutar el servidor

    python -m aiosmtpd -n -l localhost:1025

En local_settings.py Agregue entradas para establecer correo electrónico_host en 'localhost' y correo electrónico_port al 1025.

Ejecución de pruebas y cobertura

Instale las dependencias de prueba:

    pip install -r requirements_test.txt

A los unittests ejecutar los siguientes comandos:

    make collectstatic
    make test

Cobertura de carrera:

    make coverage
    make open-coverage

Barra de herramientas de depuración de django

Para usar la barra de herramientas de depuración de Django, instale django-debug-toolbar y en local_settings.py establecer debug_toolbar en verdadero.

Comandos de gestión

Archweb proporciona múltiples comandos de gestión para importar varios tipos de datos. Una descripción general de los comandos:

• Generate_Keyring: ensamble un llavero GPG con todas las claves de desarrollador conocidas.
• PGP_IMPORT - Importar claves y firmas de un llavero GPG determinado.
• Read_rebuilderd_status - Importar el estado de reconstrucción en Archweb.
• Revatch_developers: solicitudes y paquetes de bandera de revancha donde user_id/packager_id es nulo a un desarrollador.
• Reporad: analiza un archivo Repo.db.tar.gz, repo.files.tar.gz y actualiza la base de datos Arch con los cambios relevantes.
• REPOREAD_INOTIFY: observa un parche plantado para actualizaciones de *.files.tar.gz para actualizar las bases de datos Arch con.
• Donor_import: importe un solo donante de un correo pasado a Stdin
• Mirrorcheck: encueste todas las URL de espejo activos para almacenar la última hora y los detalles de sincronización de la red.
• MirRorResolv: encueste todas las URL activas de espejo y determine las que tienen direcciones IP4 y/o IPv6.
• Populate_signoffs: recupera el último mensaje de confirmación de un paquete elegible para firmar.
• update_planet: importe todos los feeds para los usuarios que tienen un sitio web válido y un sitio web_RSS en su perfil de usuario.
• Read_links: lee un archivo Repo.links.db.tar.gz y actualiza el modelo Soname.
• read_links_inotify: observa un parche plantado para actualizaciones de *.links.tar.gz para actualizar las bases de datos Arch con.

Actualización de imágenes IPXE

Los binarios necesarios para NetBoot basado en IPXE se actualizan copiándolos desde el paquete IPXE al directorio de contenido estático (con el script run_ipxe , los binarios se pueden probar de antemano):

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

Posteriormente, se crea una firma PGP separada utilizando una tecla Packager habilitada WKD válida para cada archivo:

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

Instalación de producción

Arch Linux tiene un papel ansible para Archweb en su repositorio de infraestructura.

vim: set sintax = markdown et: