Capítulo 11. Empacotar com git

Índice

11.1. Repositório Salsa
11.2. Configuração da conta Salsa
11.3. Serviço CI de Salsa
11.4. Nomes de ramos:
11.5. Repositório Git de patch não-aplicada
11.6. Repositório Git de patch aplicada
11.7. Note sobre gbp
11.8. Nota sobre dgit
11.9. Patch por abordagem gbp-pq
11.10. Gerir a lista de patch com gbp-pq
11.11. gbp import-dscs --debsnap
11.12. Nota sobre fluxo de trabalho dgit-maint-debrebase
11.13. Empacotamento Debian Quasi-native

Até ao Capítulo 10, Empacotamento avançado, concentrava-nos emoperações de empacotamento sem usar Git ou qualquer outro VCS. Estas operações de empacotamento tradicionais eram baseadas no tarball lançado pelo autor como mencionado em Secção 10.1, “Perspetiva histórica”.

Atualmente, o comando git(1) é a plataforma de-facto par a ferramenta VCS e é a parte essencial para ambos desenvolvimento do autor e atividades de empacotamento Debian. (Veja Debian wiki Empacotamento git Debian formatos de ramo de maintainer e fluxos de trabalho para fluxos de trabalho VCS existentes.)

[Nota]Nota

Como o pacote fonte Debian não-nativo usa diff -u como sua tecnologia backend para a modificação do maintainer, não pode representar modificações que envolvam links simbólicos, permissões de ficheiros, nem dados binários (Março 2022 discussão em debian-devel@l.d.o). Por favor evite fazer tais modificações de maintainer mesmo sabendo que estas podem ser gravadas no repositório Git.

Como os fluxos de trabalho VCS são um tópico complicado e existem muitos estilos práticos, aqui vou apenas tocar nalguns pontos chave com informação mínima.

Salsa é o serviço de repositório Git remoto com as ferramentas associadas. Oferece a plataforma de colaboração para atividades de empacotamento Debian usando uma instância de aplicação GitLab. Veja:

Existem 2 estilos nomes de ramo para o repositório Git usado para o empacotamento. Veja Secção 11.4, “Nomes de ramos:”.

Existem 2 estilos de utilização principais para o repositório Git para o empacotamento. Veja:

Existem 2 ferramentas notáveis de empacotamento Debian para o repositório Git para o empacotamento.

É altamente desejável hospedar o pacote de código fonte Debian em Salsa. Mais de 90% de todos os pacotes de código fonte Debian estão hospedados Salsa. [21]

O repositório VCS exacto que hospeda um pacote de código fonte Debian pode ser identificado por um campo de metadados Vcs-* que pode ser visualizado com o comando apt-cache showsrc <nome-pacote>.

Após assinar uma conta no Salsa, certifique-se que as seguintes páginas têm o mesmo endereço de e-mail e as chaves GPG que você configurou para usar com Debian, assim como a sua chave SSH:

Salsa corre o serviço Salsa CI como uma instância de GitLab CI para Secção 10.4, “Integração contínua”.

Para cada instância de git push, testa quais testes de mímica podem correr no pacote Debian oficial ao definir o ficheiro de configuração do Salsa CI Secção 6.13, “Ficheiro debian/salsa-ci.yml como:

---
include:
  - https://salsa.debian.org/salsa-ci-team/pipeline/raw/master/recipes/debian.yml

# Customizations here

O repositório Git para o empacotamento Debian deve ter pelo menos 2 ramos:

Neste tutorial, são usados nomes de ramo no estilo antigo nos exemplos para simplicidade.

[Nota]Nota

Este upstream-branch pode precisar de ser criado usando tarball lançado pelo autor independente repositório Git do autor pois tende a conter ficheiros gerados automaticamente.

O conteúdo do repositório Git do autor pode co-existir no repositório Git local para o empacotamento Debian ao adicionar uma cópia dele. Ex.:

$ git remote add upstreamvcs <url-upstream-git-repo>
$ git fetch upstreamvcs master:upstream-master

Isto permite selecção fácil a partir do repositório Git do autor para correção de bugs.

O repositório Git de patch não-aplicada pode ser resumido a:

[Nota]Nota

Os ficheiros debian/source/local-options e debian/source/local-patch-header destinam-se a ser guardados pelo comando git. Estes não são incluídos no pacote fonte Debian.

O repositório Git de patch aplicada pode ser resumido a:

  • A árvore fonte corresponde aos conteúdos extraídos pelo dpkg-source -x do pacote fonte Debian.

    • A árvore fonte é compilável e o mesmo que os maintainers NMU veem.
    • A fonte é guardada no repositório Git com as alterações de maintainer incluindo o directório debian/.
    • Modificações do maintainer ao código do autor são também gravados em ficheiros debian/patches/* para o formato fonte Debian 3.0 (quilt).

Use um dos estilos de fluxo de trabalho:

O comando gbp é fornecido pelo pacote git-buildpackage.

  • Este comando é desenhado para gerir os conteúdos de Secção 11.5, “Repositório Git de patch não-aplicada”” de modo eficiente.
  • Use gbp import-orig para importar o novo tar de autor para o repositório git.

    • A opção --pristine-tar para o comando git import-orig permite armazenar o tarball do autor no mesmo repositório git.
    • A opção --uscan como último argumento do comando gbp import-orig permite descarregar e cometer o novo tarball do autor para o repositório git.
  • Use gbp import-dsc para importar o pacote fonte Debian anterior para o repositório git.
  • Use gbp dch para gerar o changelog Debian a partir das mensagens cometidas ao git.
  • Use gbp buildpackage para compilar o pacote binário Debian a partir do repositório git.

    • O pacote sbuild pode ser usado como seu backend de compilação chroot limpo seja por configuração ou adicionando --git-builder='sbuild -A -s --source-only-changes -v -d unstable'
  • Use gbp pull para actualizar os ramos debian, upstream e pristine-tar em segurança a partir do repositório remoto.
  • Use gbp pq para gerir patches de quilt sem usar o comando dquilt.
  • Use gbp clone URL_REPOSITÓRIO para clonar e configurar ramos de acompanhamento para debian, upstream e pristine-tar.

A gestão de histórico do pacote com o pacote git-buildpackage está a tornar-se na prática standard para muitos maintainers Debian. Veja mais em:

O comando dgit é fornecido pelo pacote dgit.

The new dgit package offers commands interact with the Debian repository as if it was a git repository. It does not replace gbp-buildpackage and both can be used at the same time. Using plain gbp-buildpackage is recommended for developers who want to run git push/pull on Salsa and use things such as Salsa CI or Merge Requests on Salsa.

For more details see the extensive guides:

  • dgit-maint-gbp(7) — para pacote de formato fonte Debian 3.0 (quilt) com o seu repositório Git Debian o qual é mantido utilizável também para pessoas que usam gbp-buildpackage(1) usando Secção 11.5, “Repositório Git de patch não-aplicada”.
  • dgit-maint-merge(7) — para pacote de formato fonte Debian 3.0 (quilt) com as suas alterações a fluir para ambos os lados entre o repositório Git do autor e o repositório Git de Debian os quais estão fortemente acoplados usando Secção 11.6, “Repositório Git de patch aplicada”.
  • dgit-maint-debrebase(7) — para pacote de formato fonte Debian 3.0 (quilt) com as suas alterações a fluir maioritariamente num sentido do repositório Git do autor para o repositório Git de Debian usando Secção 11.6, “Repositório Git de patch aplicada”.
  • dgit-maint-native(7) — para o pacote de formato fonte Debian 3.0 (nativo) no repositório Git Debian. (Nenhuma alteração de maintainer)

O comando dgit(1) pode empurrar o histórico de alterações fácil-de-seguir para o sítio https://browse.dgit.debian.org/ e pode enviar um pacote Debian para o repositório Debian apropriadamente sem usar o dput(1).

O conceito em redor do dgit está para lá deste documento tutorial. Por favor comece a ler informação relevante:

Para Secção 11.5, “Repositório Git de patch não-aplicada””, você pode gerar ficheiros debian/patches/* usando o comando gbp-pq(1) a partir de commits git feitos para o ramo patch-queue.

Unlike dquilt which offers similar functionality as seen Secção 5.11, “Patch por abordagem dquilt and Secção 9.5, “Gerir a lista de patch com dquilt, gbp-pq doesn’t use .pc/* files to track patch state, but instead gbp-pq utilizes temporary branches in git.

Você pode adicionar, retirar, e refrescar ficheiros debian/patches/* com o gbp-pq para gerir a lista das patch.

Se o pacote for gerido em Secção 11.5, “Repositório Git de patch não-aplicada”” usando o pacote git-buildpackage, você pode revisar a fonte do autor para corrigir bug como maintainer e lançar uma nova revisão Debian usando gbp pq.

  • Adiciona uma nova patch que grava a modificação à fonte do autor no ficheiro buggy_file como:

     $ git checkout master
     $ gbp pq import
    gbp:info: ... imported on 'patch-queue/master
     $ vim buggy_file
      ...
     $ git add buggy_file
     $ git commit
     $ gbp pq export
    gbp:info: On 'patch-queue/master', switching to 'master'
    gbp:info: Generating patches from git (master..patch-queue/master)
     $ git add debian/patches/*
     $ dch -i
     $ git commit -a -m "Closes: #<bug_number>"
     $ git tag debian/<version>-<rev>
  • Drop (== desactiva) um caminho existente

    • Comenta linha pertinente em debian/patches/series
    • Apagar o próprio caminho (opcional)
  • Refresca ficheiros debian/patches/* para fazer o dpkg-source -b funcionar como esperado após atualizar um pacote Debian para o novo lançamento do autor.

     $ git checkout master
     $ gbp pq --force import # ensure patch-queue/master branch
    gbp:info: ... imported on 'patch-queue/master
     $ git checkout master
     $ gbp import-orig --pristine-tar --uscan
      ...
    gbp:info: Successfully imported version ?.?.? of ../packagename_?.?.?.orig.tar.gz
     $ gbp pq rebase
     ... resolve conflicts and commit to patch-queue/master branch
     $ gbp pq export
    gbp:info: On 'patch-queue/master', switching to 'master'
    gbp:info: Generating patches from git (master..patch-queue/master)
     $ git add debian/patches
     $ git commit -m "Update patches"
     $ dch -v <newversion>-1
     $ git commit -a -m "release <newversion>-1"
     $ git tag debian/<newversion>-1

Para pacotes fonte Debian chamados <pacote-fonte> guardados no arquivo snapshot.debian.org, pode ser gerado um repositório git inicial gerido em Secção 11.5, “Repositório Git de patch não-aplicada” com todo o histórico de versão Debian como se segue.

$ gbp import-dscs --debsnap --pristine-tar <source-package>

Aqui estão algumas dicas sobre dgit-maint-debrebase(7). [22]

  • Use dgit setup-new-tree para preparar o repositório de trabalho git local.
  • O primeiro commit de modificação de maintainer deve conter ficheiros apenas no directório debian/ excluindo ficheiros no directório debian/patches.
  • Os ficheiros debian/patches/* são gerados a partir do histórico de commit de modificação de maintainer usando o comando dgit quilt-fixup invocado automaticamente do dgit build e dgit push.
  • Use git-debrebase nova-versão <nova-versão-tag> para re-basear o histórico de commit de modificações do maintainer com debian/changelog actualizado automaticamente.
  • Use git-debrebase conclude para fazer uma nova pseudo fusão (== git merge -s ours) para gravar o pacote Debian com clean ff-history.

Veja dgit-maint-debrebase(7), dgit(1) e git-debrebase(1) para mais.

O esquema de empacotamento quase-nativo empacota uma fonte sem o real tarball de autor usando o formato de pacote não-nativo.

[Dica]Dica

Algumas pessoas promovem este esquema de empacotamento quase-nativo mesmo para programas escritos apenas para Debian pois ajuda a facilitar a comunicação com as distribuições baseadas como a Ubuntu para correções de bugs e etc.

Este esquema de empacotamento quase-nativo envolve 2 passos de preparação:

O resto é o mesmo como o fluxo de trabalho de empacotamento não-nativo como escrito em Secção 6.1, “Fluxo de trabalho de empacotamento”.

Apesar de isto poder ser feito de muitas maneiras (Secção 16.4, “Instantâneo do tarball do autor (-d, -t)”), você pode usar o repositório Git e git deborig como:

 $ cd /path/to/<dirname>
 $ dch -r
  ... set its <version>-<revision>, e.g., 1.0-1
 $ git tag -s debian/1.0-1
 $ git rm -rf debian
 $ git tag -s upstream/1.0
 $ git commit -m upstream/1.0
 $ git reset --hard HEAD^
 $ git deborig
 $ sbuild


[21] O uso de git.debian.org ou alioth.debian.org está agora descontinuado.

[22] Pode estar incorreto, aqui.