Orientações aos Trusted Users (TUs) do AUR
De Wiki do Arch Linux Brasil
Tabela de conteúdo |
O Trusted User/Usuário Confiável (TU)
O Trusted User/Usuário Confiável (TU) é um membro da comunidade encarregado de deixar o AUR em ordem. Ele/ela mantém pacotes populares e vota em assuntos administrativos. Um TU é eleito dentre os membros mais ativos da comunidade em um processo democrático. Os TUs são os únicos membros que tem palavra final na direção do AUR.
Os TUs são regidos pelas Normas dos TUs
Deveres dos TUs
Lista de tarefas para os novos TUs
- Instalar o pacote devtools.
- Enviar sua chave pública SSH para Loui Chang. Se você não tiver uma, use ssh-keygen para gerá-la. Você pode ver a página Usando Chaves SSH para mais informações sobre a criação de chaves ssh e e a configuração de um ssh-agent para usá-las.
- Crie o diretório staging/community no seu diretório home em aur.archlinux.org. Este passo é importante já que os scripts do devtools usam este diretório para processar novos pacotes.
- Lembre ao Allan de mudar a sua conta nos forums.
- Tenha certeza que o seu sponsor/patrocinador lhe concedeu status de TU no AUR.
- Pergunte a algum TU sobre a chave #archlinux-tu@freenode.
- Adicione-se à página Trusted Users.
- Leia as Orientações aos Trusted Users TUs do AUR.
- Se você não for colocado no grupo Trusted User do bugtracker em dois dias, reporte isso como um bug para Roman.
- Comece a contribuir!
Os TUs e o repositório UNSUPPORTED
Os TUs devem também se esforçar para verificar se os arquivos enviados para o repositório UNSUPPORTED contém algum código malicioso e se tem bons padrões de PKGBUILD. Em torno de 80% dos casos os PKGBUILDs no repositório UNSUPPORTED são muito simples e podem ser facilmente verificados.
Os TUs também devem verificar os PKGBUILDs à procura de pequenos erros, sugerir correções e melhorias. O TU deve se empenhar para ter certeza de que todos os pacotes seguem as Orientações/Padrões de Empacotamento do Arch e fazendo assim eles irão compartilhar suas habilidades com outros empacotadores num esforço em conjunto para elevar a qualidade da criação dos pacotes da distribuição.
Os TUs também estão em uma excelente posição para documentar as práticas mais recomendadas.
Os TUs e o repositório [community], orientações sobre a manutenção de pacotes
Regras para que um pacote entre no repositório [community]
Para qualquer pacote ser adicionado ao repositório [community], ele deve seguir as orientações listadas na página nesta página.
Acessando e atualizando o repositório
Agora, o repositório [community] utiliza o devtools, que é o mesmo sistema utilizado para enviar pacotes para os repositórios [core] e [extra], com a única diferença de usar o servidor http://aur.archlinux.org em vez de http://archlinux.org. Portanto, a maior parte das intruções na página Guia de Criação de Pacotes funcionam sem nenhuma alteração. Informações específicas para o repositório [community] (como URLs alteradas) foram adicionadas lá.
Inicialmente você deve fazer uma verificação não-recursiva do repositório [community]:
svn checkout -N svn+ssh://aur.archlinux.org/srv/svn-packages
Isso criará um diretório chamado "svn-packages" sem conteúdo. No entanto, se tratará de um svn checkout (verificação SVN).
Para verificar, atualizar todos os pacotes ou adicionar um pacote veja o Guia de Criação de Pacotes.
Para remover um pacote
ssh aur.archlinux.org /arch/db-remove community nome-do-pacote arquitetura
Arquitetura pode ser i686 ou x86_64, que são as duas arquiteturas suportados pelo Arch Linux.
Quando você terminar de editar o PKGBUILD, etc, você deve enviar as mudanças
(svn commit).
Quando você quiser liberar um pacote, primeiro
copie o pacote para o diretório staging/community do aur.archlinux.org usando scp
e então tag/rotule o pacote indo até o diretório nome-do-pacote/trunk
e colocando archrelease community-arch.
Isso fará uma cópia svn do diretório trunk/estrutura em um diretório chamadocommunity-i686 ou community-x86_64, indicando que este pacote está no repositório [community] para aquela arquitetura.
NOTA: Em alguns casos, especialmente para pacotes do repositório [community], um TU da arquitetura x86_64 poderá incrementar o pkgrel em .1 (e não para +1).
Isso indica que as mudanças no PKGBUILD são específicas para a arquitetura x86_64 e os mantenedores da arquitetura i686 não devem recompilar o pacote para i686. Quando um TU decidir incrementar o pkgrel, isso deverá ser feito com o incremento de +1. No entanto, um pkgrel=2.1 não deve se tornar pkgrel=3.1 quando incrementado pelo TU, e em vez disso deve se tornar pkgrel=3. Deixe os releases com ponto (.) exclusivamente para os TUs da arquitetura x86_64.
Portanto, o processo de atulização de um pacote pode ser descrito assim:
- Atualize o diretório do pacote (
svn update nome-do-pacote) - Acesse a estrutura de diretórios do pacote (
cd nome-do-pacote/trunk) - Edite o PKGBUILD, faça as mudanças necessárias e execute o
makepkg. É recomendado criar o pacote em um ambiente chroot. - Use o Namcap para verificar o PKGBUILD e o pacote binário pkg.tar.gz.
- Envie as mundanças para o diretório trunk (
svn commit) - Copie o pacote para aur.archlinux.org (
scp pkgname-ver-rel-arch.pkg.tar.gz aur.archlinux.org:staging/community/) - Tag/rotule o pacote (
archrelease community-{i686,x86_64}) - Atualize o repositório (
ssh aur.archlinux.org /arch/db-community{,64})
Veja também a seção Miscelânea em Guia de Criação de Pacotes. Na seção Evite ter que digitar a senha todas as vezes use aur.archlinux.org em vez de archlinux.org e svn.archlinux.org.
Deixando de manter pacotes
Se um TU não puder ou não quiser mais manter um pacote, uma mensagem deve ser enviada à lista de discussão do AUR, para que outro TU possa manter o pacote. Um pacote pode ser abandonado mesmo se nenhum outro TU quiser mantê-lo, mas os TUs devem tentar não abandonar muitos pacotes (eles não devem se comprometer com mais pacotes do que podem dar conta). Se um pacote se tornou obsoleto e não é mais usado, ele pode ser completamente removido.
Se um pacote foi completamente removido, ele pode ser enviado novamente para o repositório UNSUPPORTED, onde um usuário comum poderá manter o pacote em vez de um TU.
Apagando pacotes do repositório UNSUPPORTED
Não há necessidade de apagar pacotes simulados, pois eles serão recriados em uma tentativa de sanar dependências. Se alguém enviar o pacote real, então todos os pacotes que dependem dele irão apontar para o lugar correto.
Veja um exemplo de pacote simulado em: http://aur.archlinux.org/packages.php?ID=23600
Movendo pacotes do repositório [community] para o repositório UNSUPPORTED
Remova o pacote usando as instruções acima e envie o seu tarball para o AUR.