Sumário. Organização do repositório com reprepro...1 Como Configurar um repositório utilizando o reprepro...4 Utilizando o Incoming...

Transcrição

1 1 Sumário Organização do repositório com reprepro...1 Como Configurar um repositório utilizando o reprepro...4 Utilizando o Incoming...9

2 1 Organização do repositório com reprepro O reprepro é o gerenciador de repositórios tipo Debian utilizado pelo Vix Linux, Sua estrutura é definida como a descrição abaixo. OBS: '''/home/repositorio''':: utilizando essa pasta como raiz do reprepro Suas sobpastas internas são: \_ '''debian''': repositório ProLinux; \_ '''debian-cd''': criação de imagens com o Debian-CD; \_ '''disk-build''': arquivos temporários de criação das imagens; \_ '''iso-archive''': pasta de ''histórico'' de imagens isso. /debian Este é um diretório raiz do repositório, referenciado pelo link simbólico em /var/www/debian. Nele também estão os arquivos de configuração do reprepro, além do pool de pacotes e da pasta dists com os arquivos de índice das distribuições. Dentro desse diretório, encontram-se: '''conf''': o diretório de configuração do reprepro. Nele os arquivos que descrevem as distribuições, seus mecanismos de atualização, e a estrutura de incoming. '''db''': o diretório de base de dados do reprepro. Nele estão os arquivos.db que armazenam as informações sobre os pacotes e as distribuições. '''dists''': o diretório de índices das distribuições, utilizados pelo apt-get. '''doc''': a pasta doc, copiada do repositório antigo, que é inserida nas imagens de instalação. '''incoming''': a pasta onde devem ser copiados os pacotes para serem adicionados ao repositório. '''indices''': a pasta onde estão os arquivos de ''overrides''. TODO: adicioná-los corretamente ao reprepro.

3 2 '''lists''': cache do reprepro para arquivos de índice. '''logs''': arquivos de log gerados pela atualização, cópia e remoção de pacotes nas distribuições (Veja em conf/distributions). '''pool''': você já sabe ;) '''README.*''' : arquivos README utilizados pelo Debian-CD '''tools''': diretório de ferramentas que são adicionadas nas imagens de instalação, também copiada do repositório antigo. /debian/conf Este é o diretório de configuração das distribuições. Nele temos os seguintes arquivos: '''distributions''': arquivo que define os codinomes das distribuições, as suítes (podem ser alteradas, pois são apenas links), e as configurações para upload de pacotes. ''incoming''': arquivo de configuração da(s) pasta(s) incoming. Podemos alterar para que cada usuário do repositório possua a sua pasta incoming, que por padrão adiciona os pacotes no unstable, e deixar um job no cron. Depois é só ''copiar'' os pacotes de uma distro para a outra (veja man reprepro, comandos copy e pull). '''lists/*''': arquivo com listas de seleção para a opção!listfilter dos arquivos de configuração. Neste diretório, adicionei as listas que são usadas como filtros. As listas são arquivos estilo dpkg --get-selections que o reprepro utiliza para filtrar ações de uploads/copy/pulls/incomings/... '''pulls''': arquivo de configuração que indica como devem ser realizadas as movimentações de pacotes de uma distribuição para outra. '''tools/*''': pequenos scripts auxiliares (Ex: update-current-di, adaptado da versão antiga para usar o reprepro) '''updates''': arquivo de configuração de como são realizadas as atualizações. Já deixamos algumas configurações pré-definidas. /debian-cd Neste diretório residem os arquivos de configuração do debian-cd, utilizado para a criação das imagens.

4 3 /disk-build Diretório temporário de criação das imagens. Pode ser removido completamente. /iso-archive Diretório de saída para os arquivos ISO.

5 4 Como Configurar um repositório utilizando o reprepro Primeiro escolha onde você quer armazenar seu repositório, e depois siga os passos abaixo: 1. Configuração: Crie um diretório chamado conf/. Crie neste diretório um arquivo com o nome "distributions". Adicione entradas como: Ou: Origin: Debian Label: Debian-All Suite: stable Codename: woody Version: 3.0 Architectures: i386 sparc mips source Components: main non-free contrib Description: Debian woody + woody/non-us + woody/updates #Update: debian non-us security #SignWith: yes Origin: PCPool Label: PCPool Suite: stable Codename: <codename> Version: 3.0 Architectures: i386 source Components: main non-free contrib bad protected server UDebComponents: main Description: PCPool specific (or backported) packages SignWith: yes DebOverride: override UDebOverride: override DscOverride: srcoverride Entradas múltiplas são separadas com uma linha em branco. O apelido da distribuição (woody, etch, lenny) é especificada com "Codename:". Este é o nome primário da distribuição e, por exemplo, pode ser utilizado para determinar o diretório para criar e colocar os arquivos de índice. "Update:" será descrito posteriormente. Se "SignWith:" estiver presente, ele tentará autenticar: também use "yes" ou dê algum gpg para identificar a chave que você quer utilizar. Os outros campos são copiados dentro do arquivos de "Release" apropriados que foram

6 5 gerados. 2. Adicionando arquivos ao repositorio: para adicionar um.deb manualmente: reprepro -Vb. includedeb <codename> /var/cache/apt/archives/libc6_ _i386.deb para adicionar um arquivo.changes: reprepro -Vb. include <codename> test.changes Dica: você pode adicionar "-C component", "-A architecture", "-S section" e "- P priority" para definir campos adicionais de onde ele deve mecher. Note que -A não irá sobrescrever algo para ir em outra arquitetura, mas simplesmente ignorará os que não correspondem, somente os pacotes de "Architecture: all" são colocados exatamente nesta arquitetura. Ajuda quando não estiver disponível em todas as arquiteturas e onde cada versão binária necessitar de uma versão correspondente ao pacote da "Architecture: all".* Pode-se também criar uma pasta denominada incoming. Nessa pasta adicione os pacotes com o.changes e execute o comando: reprepro processincoming to-<codename> Para mais informações, vá ao capítulo 3 3) Removendo arquivos do Repositório: reprepro -Vb. remove <codename> libc6 para somente remover de um componete ou arquitetura específico: reprepro -Vb. -C main -A i386 remove <codename> libc6 4) Obtendo informações sobre o pacote: Para ver em qual arquitetura/componente um pacote existe e qual a versão utilizada: reprepro -b. list <codename> libc6 5) Override-Files: Quando incluir pacotes por "includedeb", "includedsc" ou "include" o arquivo de override aplicável à distribuição que o pacote será incluído é utilizado. O arquivo dado pelo "DebOverride:" é para os ".deb"s, o arquivo dado pelo "UdebOverride:" é para os ".udeb"s e o arquivo dado pelo "DscOverride:" é para os ".dsc"s. Se o nome do arquivo começar com uma barra(/), não será relativo ao diretório

7 conf dado com --conf, padronizado ao "conf" dentro do diretório. (ou no diretório especificado com --basedir, se for dado). Note que o Formato pe como o do!extraoverride do apt-ftparchive, não o velho formato. Um exemplo de linha fara o arquivo poderia ser: libc6 Priority extra 6) importando de repositórios maiores: O arquivo "conf/updates" pode conter entradas como estas: Name: debian Method: VerifyRelease: F1D53D8C4F368D5D 6 Name: non-us Method: Suite: */non-us Architectures: i386 sparc mips source Components: main>main non-free>non-free contrib>contrib UDebComponents: none VerifyRelease: B629A24C38C6029A Name: security Method: Suite: */updates UDebComponents: none VerifyRelease: F1D53D8C4F368D5D Aqueles que devem ser utilzados são determinados pela linha "Update:" dentro da descrição em conf/distributions. Quando Suite:, Architecture:, Components: ou DebComponents: não são dados ou são vazios, estes campos da distribuição a ser adicionada serão utilizados. (Coloque um componente que não existe, como "none", lá se você quer somente os outros de Components ou de UDebComponents). A suíte do destino pode ser usada como "*" na "Suite:" aqui.!verifyrelease: informa qual chave GPG deve ser utilizada para checar o Release.gpg. Adicione um "!IgnoreRelease: yes" para ignorar qualquer arquivo de Release. Para importar componentes dentro de outros componentes, utilize a sintaxe fonte>destino "Method:" descreve um método apt, para que os programas de /usr/lib/apt/methods sejam utilizados... Para atualizar tudo possível, faça: reprepro -b. update

8 7 Para atualizar somente uma distribuição, faça: reprepro -b. update woody Não há suporte para atualizar uma distribuição somente de um upstreams específico ainda. Você terá que editar o conf/distributions para isso. O valor do "!VerifyRelease:" pode ser obtido usando: gpg --with-colons --list-keys <whatever> 7) assinatura automática do Release: Para não ser necessário digitar a frase do gpg, retire-a com o comando: gpg --edit-key <chave> passwd softwares Tenha certeza de ter incluído todos os fontes quando permitir aos outros acessar aos que estão disponíveis somente sobre GPL para você. Bom, você deve sempre fornecer os fontes, mas em alguns casos isso pode lhe trazer problemas. Usando reprepro com apache2 (sarge, etch, sid) Este exemplo assume que o repositório reprepro está no caminho /srv/reprepro/ e que o apache2 foi corretamente instalado e configurado. O primeiro passo é criar um diretório virtual chamado debian. Assumindo que seu servidor está sobre o domínio o repositório serpa colocado em Crie um arquivo de configuração do apache2 no diretório conf de seu repositório, usando o comando seguinte: cat > /srv/reprepro/conf/apache.conf << EOF Alias /debian /srv/reprepro/ <Directory /srv/reprepro> Options +Indexes AllowOverride None order allow,deny allow from all </Directory> EOF Para habilitar este diretório virtual, um link simbólico deve ser criado. Isso pode ser feito usando o seguinte comando:

9 8 ln -s /srv/reprepro/conf/apache.conf /etc/apache2/conf.d/reprepro.conf e no debian: ln -s /srv/reprepro/conf/apache.conf /etc/apache2/sites-available/repositorio ative o site no debian com o comando: a2ensite repositorio O segundo passo é definir as permissões de forma que os usuários da web possam navegar pelo repositório, mas não possam ver a configuração específica do mesmo. Isto pode ser feito utilizando os seguintes comandos: chown -R root:root /srv/reprepro/ chmod 755 /srv/reprepro/ chown -R root:www-data /srv/reprepro/dists/ /srv/reprepro/pool/ chmod 750 /srv/reprepro/* Recarregue o apache2: /etc/init.d/apache2 reload Cheque se os repositórios estão visíveis aos usuarios web, direcionando seu browser para: Se existem problemas com seu repositório e a configuração do apache2, você deve ver dois diretórios: dists/ e pool/. O último passo é adicionar seu repositório ao sources.list. Por exemplo, assim: echo "deb <codename> main non-free contrib" \ >> /etc/apt/sources.list De: ---- alioth.debian.org: [ rev=head;content-type=text%2fplain;cvsroot=mirrorer] e: V. Stanley Jaddoe <debian@terabytemusic.cjb.net> tradução e adaptação: Jeiks

10 9 Utilizando o Incoming De acordo com as últimas alterações que realizamos, o novo repositório conta com o sistema de upload de pacotes via incomming. Atualmente, procedemos do seguinte modo: Obtenha o código-fonte do pacote a ser modificado: apt-get source agape Incremente a versão: dch -i "Aumentando a versão para poder corrigir o bug: bla bla bla..." Dicas: Para adicionar várias entradas de changelog durante o seu trabalho, use: dch -a "Opa, achei outro problema, então já modifiquei aqui: Para adicionar uma entrada de ''local build'', ou seja, quando recompilamos um pacote que não é nosso: dch -l prolinux "Rebuild for ProLinux2" Neste caso, sucessivas chamadas incrementam automaticamente para prolinux1, prolinux2, etc... Modifique o código-fonte Compile e teste Quando os pacotes estiverem prontos, copie os arquivos.dsc,.tar.gz ou.diff.gz,.deb e.changes para o incoming: rm *.build <diretório do codigo fonte> cp * /home/repositorio/debian/incoming Quando tudo estiver correto, basta dar um update no lenny: reprepro checkupdate lenny reprepro update lenny Observação: Verifique com o checkupdate antes, para ter certeza que as atualizações estão sendo obtidas do unstable. Veja a documentação do campo Update do arquivo conf/distributions e a documentação do arquivo conf/updates na página de manual do reprepro para mais detalhes.