git git Utilização básica no controle de versão de pacotes João Eriberto Mota Filho Utilização básica no controle de versão de pacotes

Transcrição

1 Utilização básica no controle de versão de pacotes Mini DebConf Curitiba 2016 João Eriberto Mota Filho C u r i t i b a, P R, 0 6 d e meriberto a r ç o d e Mar

2 Sumário O que é o? Utilização básica do Servidores remotos buildpackage (gbp) Collab maint no Debian Campos VCS no debian/control Conclusão

4 O que é o? O é um VCS (Version Control System). Os VCS servem para controlar alterações em códigos fonte. Com os VCS é possível: Trabalhar em grupo. Reverter alterações. Buscar a cronologia de ações em debugs do código. Fazer um desenvolvimento paralelo (branch) para depois juntar ao código principal (merge). Diversas outras possibilidades. Trabalhos em VCS, geralmente, podem ser baixados publicamente.

5 O que é o? Há vários VCS (Version Control System) disponíveis. Os mais conhecidos são: CVS SVN Mercurial Bazaar Há vários outros. Veja uma relação aqui:

6 O que é o? O foi criado em 2005, por Linuz Torvalds, para controlar o desenvolvimento do Kernel Linux. Vantagens e características mais relevantes: VCS para desenvolvimento distribuído. Não necessita de servidor central, podendo ser ativado em um diretório; no entanto, pode usar um servidor central. Rápido, flexível e robusto. Usa o conceito de repositório. Compatível com HTTP(S), FTP, rsync e SSH (para fim de tráfego a partir de um servidor). Suportado por diversos repositórios públicos famosos, como GitHub, Bitbucket e outros, além do Debian. Possui frontends diversos, inclusive gráficos.

8 Utilização básica do Setup para a primeira utilização: $ config global user.name "Eriberto Mota" $ config global user. eriberto@eriberto.pro.br $ config global core.editor mcedit (os dados ficarão armazenados em ~/.config) Criação de um repositório local para o projeto teste: $ mkdir teste $ cd teste $ init Caso o projeto seja compartilhado, usar: $ init shared

9 Utilização básica do Adicionar um código novo existente no diretório atual: $ add. Adicionar o arquivo x: $ add x Ver o status atual: $ status Comitar o código atual: $ commit <arquivo> (ou commit a, dependendo do caso) Comitar o código atual, já provendo um comentário: $ commit m comentário (ou commit am comentário )

10 Utilização básica do Para ver a branch atual e as disponíveis (a main é a default): $ branch Criar branch e migrar para a mesma: $ checkout b modulo1 Voltar para a branch master (ou outra): $ checkout master Ver um diff das ações antes de comitar: $ diff Ver um log de todas as ações em uma branch: $ log

11 Utilização básica do Cada commit tem um hash que o identifica. Exemplo: $ log commit deb902f3a6abfcd8a3ac197b681f57e01bb3a4e0 Author: Joao Eriberto Mota Filho <eriberto@debian.org> Date: Thu Mar 3 20:45: O início do hash (seis ou oito bytes) pode ser usado como referência em comandos: $ diff 4d7eee deb902 Super log: $ log oneline graph decorate all

12 Utilização básica do Tags podem ser adicionadas para marcar um ponto ou versão: $ tag am Tagging version Para ver as tags existentes: $ tag Atribuir uma tag a um commit específico: $ tag am Tagging version d7eee Diff entre duas tags: $ tag Log entre tags: $ log

13 Utilização básica do Diff entre dois commits: $ diff dcce1f 8904ea Log entre dois commits: $ log dcce1f..8904ea Também é possível reverter (descartar) um commit específico: $ revert 9c13aa Isso é o básico. Há diversas outras possibilidades...

15 Servidores remotos O também pode operar em servidores remotos. Basicamente, para baixar um repositório, usamos clone: $ clone ou... $ clone Para enviar um código e as tags para um repositório: $ push all; push tags Configurar um repositório remoto de destino: $ remote $ remote rm origin $ remote add

16 Servidores remotos Em se tratando de serviços remotos, como o GitHub e outros, é uma boa ideia deixar próprio serviço criar o repositório e, depois, cloná lo.

18 buildpackage (gbp) O buildpackage (ou gbp) é um mecanismo que integra o sistema de construção de pacotes do Debian com o VCS. O gbp possui vários comandos específicos, a saber: gbp: mantém pacotes Debian no Git gbp buildpackage: constrói um pacote a partir de um repositório gbp import dsc: importa um pacote a partir de um arquivo.dsc gbp import dscs: importa múltiplos.dsc gbp import orig: importa o código fonte de um upstream gbp dch: cria changelogs baseados em mensagens de commits gbp clone: baixa um repositório remoto (continua...)

19 buildpackage (gbp) Comandos gbp (continuação): gbp config: verifica valores usados nas configurações gbp pull: atualiza um repositório remoto gbp pq: gerencia patches que estejam em um repositório gbp create remote repo: cria repositórios remotos Um exemplo prático de utilização é a criação e a manutenção de um repositório para armazenar as versões de upstream e as revisões de um pacote. É útil manter as versões de upstream para o caso da homepage do mesmo ser extinta.

20 buildpackage (gbp) O Debian trabalha com três branches básicas: upstream: mantém o código fonte do upstream, versão a versão. pristine tar: branch utilizada no momento da clonagem para gerar o tarball do upstream. debian ou master: mantém os dados de empacotamento, juntamente com o código fonte do upstream (para uma possível interação com o mesmo, como em pacotes nativos). O nome debian ou master dependerá de quem empacota ou das normas do time. O mais comum é debian. O comando gbp import dsc (ou gbp import dsc) entende todas as branches citadas e as cria, automaticamente, a partir de um arquivo.dsc.

21 buildpackage (gbp) Exemplo de uso do gbp import dsc para criar um repositório: # apt get install buildpackage $ gbp import dsc pristine tar debian branch=debian../pacote_0.1 1.dsc O comando anterior poderia ser simplificado caso fosse utilizado um arquivo básico de configuração. Exemplo: [DEFAULT] pristine tar = True debian branch = debian

22 buildpackage (gbp) O citado arquivo de configuração poderá ser: debian/etc/ buildpackage/gbp.conf: global pata o sistema. ~/.gbp.conf: apenas para o usuário. <branch>/gbp.conf: apenas para uma branch específica; pode ser colocado dentro do diretório debian/, por exemplo../gbp.conf: válido para todo o repositório. Após a atuação do gbp, a branch master poderá ser removida, desde que não seja a branch atual de operação. Exemplo: $ checkout debian $ branch d master

23 buildpackage (gbp) Ao importar um.dsc que contenha uma nova versão do upstream, dentro de um repositório recém clonado, é importante, antes, fazer checkout da branch upstream, retornando para a branch debian (ou master). Exemplo: $ clone $ cd teste $ checkout upstream $ checkout debian $ gbp import dsc../teste_0.5 6.dsc Ao se construir um repositório para um pacote adotado, é interessante, caso não exista, recriar toda a vida básica de tal pacote. Para tanto, busque os.dsc das revisões anteriores em

24 buildpackage (gbp) Um manual completo a respeito do gbp, denominado Building Debian Packages with buildpackage, poderá ser encontrado nos seguintes lugares: buildpackage/manual html/gbp.html ou /usr/share/doc/ buildpackage/manual html/gbp.html

26 Collab maint no Debian O collab maint é um repositório de manutenção colaborativa existente no Debian (shared). O collab maint pode receber pacotes que não pertençam a times, permitindo a manutenção evolutiva do pacote, mesmo que haja uma mudança de mantenedor. Todo DD tem acesso automático ao collab maint. Para não DDs: Criar uma conta no servidor Alioth. Solicitar a um DD que seja advogado e que envie um pedindo a sua entrada. DM só precisa solicitar a inclusão.

27 Collab maint no Debian As instruções detalhadas encontram se nesses endereços: devel announce/2012/01/msg00006.html A conexão com o collab maint se dá por SSH. A seguir, um exemplo de clonagem: $ clone ssh://eriberto@anonscm.debian.org//collab maint/axel. O collab maint também tem uma interface web que permite a navegação nos diretórios e branches.

28 Collab maint no Debian

30 Campos VCS no debian/control Independentemente de usar o collab maint ou um externo, há dois campos no arquivo debian/control que são relevantes: Vcs Git: contém o URI necessário para clonar o repositório que controla o pacote. Vcs-Git Vcs Browser: contém a URL que mostrará o repositório na web. Vários ambientes, como o PTS e o DDPO exibem links para os dois recursos citados. Exemplo dos campos no debian/control: Vcs Git: ://anonscm.debian.org/collab maint/axel. Vcs Browser: maint/axel.

31 Campos VCS no debian/control Vcs-Git

32 Sumário O que é o? Utilização básica do Servidores remotos buildpackage (gbp) Collab maint no Debian Conclusão

33 Conclusão O controle de versão é uma das formas de se manter o histórico de pacotes e revisões no Debian. Atualmente, o é um dos VCS mais simples e eficientes. No Debian existe o collab maint, que canaliza todo o esforço de controle de versão para um ponto único. Esta palestra está disponível em: Siga me no