archweb

Archweb ReadMe

Para obter uma versão bonita deste documento, execute

 $ markdown README > README.html

Licença

Consulte o arquivo de licença.

Autores

Consulte o arquivo de autores.

Dependências

• Python
• RSYNC (opcional para Mirrorcheck com espelhos RSYNC)

Dependências Python

Mais detalhes em requirements.txt e requirements_prod.txt ; É melhor usar o VirtualEnv e o PIP para lidar com isso. Mas se você insistir em pacotes (Arch Linux), provavelmente desejará o seguinte:

• Python-django
• Python-Psycopg2
• Python-Markdown
• Python Memcached

Testando a instalação

1. Execute python -m venv env .

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

2. Ative o virtualenv.

    source ./env/bin/activate
   

3. Instale dependências através pip .

    pip install -r requirements.txt
   

4. Copie local_settings.py.example para local_settings.py e modifique. Certifique -se de descomentar a seção de banco de dados apropriada (sqlite ou postgreSQL).

5. Migrar mudanças.

    ./manage.py migrate
   

6. Carregue os acessórios para preencher alguns dados. Se você não deseja alguns dos dados fornecidos, ajuste o arquivo de arquivo de acordo.

    ./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 os seguintes comandos para iniciar uma instância de serviço

    ./manage.py runserver
   

8. Preencher opcionalmente o banco de dados com dados reais:

    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
   

Alterar arquitetura e repositório para obter x86_64 e pacotes de outros repositórios, se necessário.

8. Atualizações de banco de dados para pacotes adicionais/removidos

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

Para pós -gresql, use pacotes/sql/update.postgresql_psycopg2.sql

Testando o servidor SMTP

Para poder criar uma conta em seu ambiente de teste, é necessário um servidor SMTP. Um servidor SMTP de depuração simples pode ser configurado usando o Python e aiosmtpd .

Instale aiosmtpd

    pip install aiosmtpd

Execute o servidor

    python -m aiosmtpd -n -l localhost:1025

Em local_settings.py Adicionar entradas para definir email_host como 'localhost' e email_port para 1025.

Testes de execução e cobertura

Instale as dependências de teste:

    pip install -r requirements_test.txt

Para os unittests executar os seguintes comandos:

    make collectstatic
    make test

Cobertura em execução:

    make coverage
    make open-coverage

Barra de ferramentas de depuração do django

Para usar a barra de ferramentas Django Debug, instale django-debug-toolbar e em local_settings.py define debug_toolbar como true.

Comandos de gerenciamento

A Archweb fornece vários comandos de gerenciamento para importar vários tipos de dados. Uma visão geral dos comandos:

• Gereate_keyring - Monte um chaveiro GPG com todas as teclas de desenvolvedor conhecidas.
• PGP_IMPORT - Importar teclas e assinaturas de um determinado chaveiro GPG.
• read_rebuilderd_status - importar o status de rebuilderd para o archweb.
• REMATCH_DEVENDERS - REMACK SPING SOLECTES E PACAGES onde user_id/packager_id é nulo para um desenvolvedor.
• Reporead - analisa um arquivo repo.db.tar.gz, repo.files.tar.gz e atualiza o banco de dados do ARCH com as alterações relevantes.
• REPOREAD_INOTIFY - Observa um patch modelado para atualizações de *.files.tar.gz para atualizar os bancos de dados de arco com.
• doador_import - importar um único doador de um e -mail passado para stdin
• MirrorCheck - Pesquise todos os URLs de espelho ativo para armazenar o tempo LastSNYC e gravar detalhes de tempo da rede.
• Mirrorresolv - Pesquise todos os URLs de espelho ativo e determine o WHETEHER que eles possuem endereços IP4 e/ou IPv6.
• POPULE_SIGNOFFS - Recupera a mais recente mensagem de comprometimento de um pacote elegível para o Signoff.
• UPDATE_PLANET - Importe todos os feeds para usuários que possuem um site válido e site_rss em seu perfil de usuário.
• read_links - lê um arquivo repo.links.db.tar.gz e atualiza o modelo soname.
• Read_links_inotify - Relva um patch modelado para atualizações de *.links.tar.gz para atualizar os bancos de dados de arco com.

Atualizando imagens ipxe

Os binários necessários para o Netboot baseado em IPXE são atualizados copiando -os do pacote IPXE para o diretório de conteúdo estático (com o script run_ipxe que os binários podem ser testados com antecedência):

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

Posteriormente, uma assinatura PGP destacada usando uma tecla Packager habilitada por WKD válida é criada para cada arquivo:

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

Instalação de produção

O Arch Linux tem um papel Ansible para o Archweb em seu repositório de infraestrutura.

vim: set sintaxe = markdown et: