Sistemas de Controle de Versão

Transcrição

1 Sistemas de Controle de Versão Juliano F. Ravasi Setembro /

2 Conteúdo Parte 1: Controle de Versões Parte 2: Trabalhando com Subversion Parte 3: Trabalhando com Mercurial 2

3 Controle de Versões 3

4 Motivação O que é controle de versões? Gerenciamento de múltiplas revisões Documentos, projetos, software, etc. Histórico de alterações sofridas Permitir consultar revisões anteriores Permitir comparações entre revisões Permitir trabalho cooperativo 4

5 Motivação O que é controle de versões? Vários nomes: Revision control system (RCS) Version control system (VCS) Software Configuration Management (SCM) Source Code Management Source Control Controle de versão não é exclusivo para gerenciamento de software. 5

6 Motivação Por que controle de versões? Software é algo caro de ser produzido Consome muito tempo Exige cooperação, organização, disciplina É importante armazenar tudo que é feito 6

7 Motivação Onde é utilizado? Sistemas de arquivos Suítes de escritório Ambientes colaborativos Gerenciamento de software Importante para qualquer desenvolvedor ou empresa de desenvolvimento de software. 7

8 Motivação Onde é utilizado? 8

9 Motivação Onde é utilizado? 9

10 Recursos Registro de revisões Toda alteração realizada é registrada Rápido acesso a revisões anteriores Quem, quando, o que e por quê? Nada é perdido para sempre Descartar código ruim sem remorso Determinar introdução de defeitos Manutenção de código legado 10

11 Recursos Auditoria Comparação entre versões do projeto, mostrando diferenças linha-a-linha Apontar desenvolvedores responsáveis por cada trecho de código do projeto Automação de testes de estabilidade 11

12 Recursos Ramificações Múltiplas linhas de desenvolvimento dentro do mesmo projeto Permite divergência e reconvergência do desenvolvimento 12

13 Recursos Trabalho cooperativo Vários desenvolvedores trabalhando sobre o mesmo projeto Mescla das alterações dos diversos desenvolvedores ou ramificações 13

14 Recursos Segurança Autenticação criptográfica de histórico Controle de acesso sobre o repositório Cópias de segurança (backup) 14

15 Modelos Centralizado (cliente-servidor) Distribuído Um repositório central de revisões Desenvolvedores obtém cópias de trabalho do repositório central Cada desenvolvedor tem seu repositório Desenvolvedores copiam repositórios e alterações de outros desenvolvedores 15

16 Modelos Centralizado (cliente-servidor) Vantagens: Desvantagens: Controle de acesso Cópia de segurança Controle de qualidade Dependência do repositório central Ponto único de falha 16

17 Modelos Distribuído Vantagens: Desvantagens: Permite submissões particulares, offline Melhor suporte a ramificação e mescla Independência da rede, mais rápido Estimula o isolamento de desenvolvedores Questões de privacidade e segurança 17

18 Modelos Centralizado vs. distribuído Assunto quente nos últimos anos Há sobreposição entre os modelos Ferramentas distribuídas podem ser usadas no modelo centralizado, quando necessário Ainda não existe a ferramenta perfeita Opiniões inflamadas, guerra de egos Cada modelo de desenvolvimento exige um modelo de controle de versões 18

19 Conceitos Repositório Núcleo do controle de versões Possui uma linha do tempo embutida Coletânea de revisões do projeto 19

20 Conceitos Repositório Revisão Estado em um determinado instante Imutável após criada 20

21 Conceitos Cópia de trabalho Cópia do repositório em certa revisão Geralmente a mais recente Checkout (obtenção de uma cópia) 21

22 Conceitos Cópia de trabalho Onde ocorre o desenvolvimento O sistema reconhece as alterações feitas Algumas operações devem ser explícitas Adição, remoção, moção e cópia de arquivos 22

23 Conceitos Cópia de trabalho Submissão (commit) Alterações são registradas em uma nova revisão do repositório 23

24 Conceitos Ramificações (branches) Linhas alternativas de desenvolvimento Explícitas Implícitas 24

25 Conceitos Ramificações (branches) Explícitas Manutenção de versões legadas Implementação de novos recursos Experiências no código do projeto 25

26 Conceitos Ramificações (branches) Implícitas Cópia de trabalho Múltiplos desenvolvedores 26

27 Conceitos Mescla (merge) Reintegração de ramificações Em grande parte é automatizado Conflitos podem ocorrer O desenvolvedor pode precisar interagir 27

28 Conceitos Rótulos (tags) Nomes atribuídos a revisões 28

29 Gerenciamento de software Fluxos de trabalho Solitário Centralizado Distribuído Repositório local Repositório remoto Parceiro Equipe Hierárquico 29

30 Gerenciamento de software Fluxos de trabalho Solitário 30

31 Gerenciamento de software Fluxos de trabalho Centralizado, repositório local 31

32 Gerenciamento de software Fluxos de trabalho Centralizado, repositório remoto 32

33 Gerenciamento de software Fluxos de trabalho Distribuído, parceiro 33

34 Gerenciamento de software Fluxos de trabalho Distribuído, equipe 34

35 Gerenciamento de software Fluxos de trabalho Distribuído, hierárquico 35

36 Gerenciamento de software Sistemas de controle de versões SourceAnyware Vault Git darcs MOG ArX Surround FtpVC PlasticSCM CVS Store Stellation ClearCase Vesta AllFusion SourceSafe DCVS Aegis PureCM GNU arch Mercurial RCS Team Foundation Server FirePublish Team Coherence SourceHaven Perforce CodeVille Fossil codebeamer MKS QVCS TeamWare Code Co-op AccuRev Evolution DesignSync SVK Serena FileHamster Aldon AVS CVSNT Subversion OpenCVS LibreSource AlienBrain StarTeam BitKeeper Synergy Monotone Bazaar 36

37 Gerenciamento de software Sistemas de controle de versões Centralizado Aegis CVSNT CVS Aberto Distribuído OpenCVS CodeVille Stellation Subversion ArX arch Fossil Vesta darcs Git Bazaar DCVS LibreSource Mercurial Monotone SVK AccuRev Aldon AlienBrain AllFusion Proprietário AVS ClearCase codebeamer DesignSync Evolution FileHamster FirePublish Perforce FtpVC MKS PureCM QVCS SourceAnyware SourceSafe Code Co-op MOG Serena SourceHaven StarTeam BitKeeper TeamWare Store Surround Synergy Team Coherence Vault PlasticSCM Team Foundation Server 37

38 Gerenciamento de software Sistemas de controle de versões Visão geral dos VCSs abertos: Centralizados: Git Mercurial Bazaar Mais: Distribuídos: CVS Subversion

39 Sistemas de controle de versão CVS Criado para substituir o RCS (1980s) Obsoleto, desenvolvimento estagnado Modelo centralizado Possui grande base de usuários Possui defeitos e limitações de projeto Escrito em C, monolítico 39

40 Sistemas de controle de versão Subversion Sucessor do CVS Projetado para contornar os seus defeitos Desenvolvido por CollabNet Inc. Modelo centralizado Robusto e maduro Ênfase em qualidade, larga escala Sem restrições a tipos de arquivos Escrito em C, modular 40

41 Sistemas de controle de versão Subversion Projeto em camadas Repositório Acesso ao repositório Bindings: C, Python, Perl, Java, Ruby Cliente Local, WebDAV, svnserve Cópia de trabalho Biblioteca de cliente BorlandDB, fsfs svn, TortoiseSVN, Subclipse, KDESvn, Trac,... 41

42 Sistemas de controle de versão Git Criado para gerenciar o kernel do Linux Após controvérsia sobre o BitKeeper Inspirado no Monotone Inicialmente por Linus Torvalds Modelo distribuído Ênfase em desenvolvimento não-linear Autenticação criptográfica do histórico Gerencia conteúdo, ao invés de arquivos Escrito em C, monolítico 42

43 Sistemas de controle de versão Mercurial Criado simultaneamente ao Git Inspirado no Monotone Desenvolvido por Matt Mackall Modelo distribuído Autenticação criptográfica do histórico Ênfase em uso por grandes projetos Escrito em Python, modular 43

44 Sistemas de controle de versão Bazaar Desenvolvido por Canonical Inc. Modelo distribuído Ênfase em facilidade, flexibilidade Suporte a múltiplos fluxos de trabalho Desempenho ruim Escrito em Python, modular 44

45 Gerenciamento de software O que armazenar? Arquivos produzidos pelo desenvolvedor: código fonte scripts de automação documentação escrita figuras, imagens e ícones possivelmente apenas os originais, usando ferramentas automáticas para converter entre formatos e tamanhos makefiles a menos que sejam criados por um processo automático (por ex:./configure) 45

46 Gerenciamento de software O que não armazenar? Arquivos gerados automaticamente: código-objeto programas compilados documentação automática Arquivos com configurações locais: credenciais de acesso a banco-de-dados Arquivos criados acidentalmente: core dumps arquivos temporários 46

47 Trabalhando com Subversion 47

48 Trabalhando com Subversion Características gerais Repositório vs. cópia de trabalho Ramificações, rótulos Implícito, parte da árvore do repositório Criados através de cópias leves Características únicas: Armazenados em lugares distintos Propriedades Diretórios WebDAV 48

49 Trabalhando com Subversion Características gerais Recomendação Usar versão 1.5 ou superior. Informações Projeto: Manual: Clientes: Windows: Eclipse: KDE: 49

50 Trabalhando com Subversion Repositório Sistema de arquivos Baseado em ligações Revisões numéricas, seriais Revisão zero: repositório em branco Sugestões de organização: Cópias leves, copy-on-write Banco-de-dados transacional Um repositório por projeto (incluindo subprojetos) 50

51 Trabalhando com Subversion Repositório Criação do repositório svnadmin create diretório Cria um novo repositório Subversion em branco (revisão zero) em diretório. Convenções de hierarquia / trunk/ branches/ tags/ tronco ramificações rótulos 51

52 Trabalhando com Subversion Repositório Convenções de hierarquia 52

53 Trabalhando com Subversion Repositório Criação da hierarquia inicial Método 1: svn checkout file:///home/user/svn/repo cd repo svn mkdir trunk branches tags svn commit -m "Directory hierarchy." Método 2 (bash): r=file:///home/user/svn/repo svn mkdir $r/{trunk,branches,tags} -m "..." 53

54 Trabalhando com Subversion Ciclo de trabalho 1. Obtenção (checkout) svn checkout ❶ svn checkout 54

55 Trabalhando com Subversion Ciclo de trabalho 2. Desenvolvimento ❷ (edição) 55

56 Trabalhando com Subversion Ciclo de trabalho 3. Comparação, reversão svn status svn diff svn revert ❸ svn diff svn revert 56

57 Trabalhando com Subversion Ciclo de trabalho 4. Submissão svn commit ❹ svn commit 57

58 Trabalhando com Subversion Ciclo de trabalho 5. Atualização svn update ❺ svn update 58

59 Trabalhando com Subversion Comandos Ferramentas principais: svn svnadmin Manutenção do repositório. Outras ferramentas: Cliente padrão, cópia de trabalho. svndumpfilter svnlook svnserve svnsync 59

60 Trabalhando com Subversion Comandos Acesso ao repositório Local WebDAV sobre HTTP svn://svn.example.com/svn/repo/... svnserve sobre SSH svnserve file:///home/user/svn/repo/... svn+ssh://svn.example.com/svn/repo/... 60

61 Trabalhando com Subversion Comandos Acesso ao repositório Composição da URL svn://svn.example.com/svn/project/subproject/trunk/ Endereço do servidor Subversion Endereço do repositório Caminho armazenado no repositório 61

62 Trabalhando com Subversion Comandos Importação svn import [diretório] URL Obtenção svn checkout URL [diretório] Obtém uma cópia de trabalho. svn export URL [diretório] Obtém uma cópia limpa do projeto. svn update [diretório] Importa um projeto existente em um repositório. Atualiza a cópia de trabalho com o repositório. 62

63 Trabalhando com Subversion Comandos Edição svn add alvo svn delete alvo Cria uma cópia de um arquivo ou diretório. svn move orig dest Cria um diretório no controle de versão. svn copy orig dest Remove um arq./dir. do controle de versão. svn mkdir diretório Adiciona um arq./dir. ao controle de versão. Move ou renomeia um arquivo ou diretório. 63

64 Trabalhando com Subversion Comandos Consulta e comparação svn status [alvo] svn diff [alvo] Mostra alterações realizadas em arquivos. Reversão svn revert [alvo] Mostra arquivos alterados, adicionados, etc. Reverte alterações realizadas em arquivos. 64

65 Trabalhando com Subversion Comandos Submissão svn update svn commit [alvo] Atualiza a cópia de trabalho antes de submeter, opcional. Podem ocorrer conflitos ao mesclar as alterações do repositório com as suas. Submete o estado atual da cópia de trabalho para o repositório, criando uma nova revisão. Nesse processo, é necessário fornecer uma breve descrição das alterações realizadas. 65

66 Trabalhando com Subversion Comandos Resolução de conflitos svn resolve --accept arg [alvo] svn resolved alvo Informa que o conflito foi manualmente resolvido, e destrava a cópia de trabalho. svn status svn commit [alvo] Resolução simples, informa qual versão do alvo deverá ser preservada. Após resolver os conflitos, tentar submeter novamente. 66

67 Trabalhando com Subversion Comandos Informação e auditoria svn info [alvo] svn log [alvo] Mostra registro de alterações de um arquivo, diretório ou do projeto. svn blame arquivo Mostra informações diversas sobre a cópia de trabalho ou o alvo fornecido. Acusa os desenvolvedores que alteraram por último cada linha de um arquivo. 67

68 Trabalhando com Subversion Consulta de histórico (svn log) r3 juliano :41: (Fri, 18 Jul 2008) 8 lines Changed paths: M /trunk A /trunk/calculatorform.cpp A /trunk/calculatorform.h A /trunk/calculatorform.ui M /trunk/calculator.cpp M /trunk/calculator.pro User interface design. Designed the user interface of the calculator, using Qt Designer. No functions have been implemented yet. The calculator is non-functional. Added some patterns for generated files to svn:ignore. 68

69 Trabalhando com Subversion Atualização (svn update) Para visitar revisões passadas Para retornar à última revisão svn update Legenda svn update -r revisão svn update -r {data} A: D: U: C: G: E: adicionado apagado atualizado conflito mesclado já existente (Added) (Deleted) (Updated) (Conflicted) (merged) (Existed) 69

70 Trabalhando com Subversion Comparação (svn diff) Alterações na cópia de trabalho svn diff [alvo] Comparar revisões arbitrárias svn diff -r x:y [alvo] svn diff -c x [alvo] Alterações entre revisões x e y. Alterações entre revisões x -1 e x. 70

71 Trabalhando com Subversion Comparação (svn diff) 71

72 Trabalhando com Subversion Consulta de estado (svn status) Legenda adicionado (Added) em conflito (Conflicted) apagado (Deleted) ignorado (Ignored) modificado (Modified) substituído (Replaced) item externo (external) item desconhecido, não controlado item controlado, porém ausente Mais detalhes A: C: D: I: M: R: X:?:!: svn help status 72

73 Trabalhando com Subversion Ramificações Comandos svn copy repo/trunk repo/branches/branch svn switch repo/trunk svn switch repo/branch/branch Cria uma nova ramificação. Alterna entre ramificações. 73

74 Trabalhando com Subversion Mescla e reversão Mescla entre ramificações svn merge URL svn merge --reintegrate URL Reintegra alterações de uma ramificação ao tronco. svn merge -c rev URL Mescla alterações de uma ramificação diferente na ramificação atual da cópia de trabalho. Mescla apenas revisão rev. 74

75 Trabalhando com Subversion Mescla e reversão Reversão svn merge -c -rev URL Desfaz as alterações da revisão rev. Pode ser usado na própria ramificação. É uma mescla ao contrário. 75

76 Trabalhando com Subversion Rótulos Caso especial de ramificação São usados apenas como referência Devem ser somente-leitura após criados. Comando svn copy repo/trunk repo/tags/tag Cria um novo rótulo. 76

77 Trabalhando com Subversion Propriedades Comandos svn proplist [alvo] svn propget prop alvo Altera uma propriedade (no editor externo). svn propdel prop alvo Configura o conteúdo de uma propriedade. svn propedit prop alvo Recupera conteúdo de uma propriedade. svn propset prop cont alvo Lista propriedades. Apaga uma propriedade. 77

78 Trabalhando com Subversion Propriedades Propriedades padrão Diretórios e arquivos Revisões svn:eol-style svn:executable svn:externals svn:ignore svn:keywords svn:mime-type svn:needs-lock svn:author svn:date svn:log 78

79 Trabalhando com Mercurial 79

80 Trabalhando com Mercurial Características gerais Distribuído Ramificações, rótulos Cópia de trabalho contém o repositório: São armazenados juntos Explícitos, possuem tratamento especial Cada cópia de trabalho é uma ramificação 80

81 Trabalhando com Mercurial Características gerais Informações Projeto: Manual: Clientes: Windows: Eclipse: 81

82 Trabalhando com Mercurial Repositório Sistema de arquivos Armazenamento eficiente, seguro e rápido Revisões: Sugestões de organização: Numéricas, seriais Hash SHA-1 do changeset Um repositório por subprojeto Projeto: vários subprojetos agrupados 82

83 Trabalhando com Mercurial Ciclo de trabalho 1. Início do projeto (init) hg init ➊ hg init 83

84 Trabalhando com Mercurial Ciclo de trabalho 2. Desenvolvimento, submissão local hg status, diff, revert, commit ➋ hg hg hg hg status diff revert commit 84

85 Trabalhando com Mercurial Ciclo de trabalho 3. Ramificação hg clone ➌ hg clone 85

86 Trabalhando com Mercurial Ciclo de trabalho 4. Mais desenvolvimento ➍ hg hg hg hg status diff revert commit ➍ hg hg hg hg status diff revert commit 86

87 Trabalhando com Mercurial Ciclo de trabalho 5. Mescla hg pull, push ➎ hg pull hg push 87

88 Trabalhando com Mercurial Ciclo de trabalho hg pull hg pull hg pull hg pull 88

89 Trabalhando com Mercurial Ciclo de trabalho hg pull hg pull hg pull hg pull hg push 89

90 Trabalhando com Mercurial Ciclo de trabalho hg import hg import hg import hg import hg export lista de s 90

91 Trabalhando com Mercurial Ciclo de trabalho Mercurial Subversion (distribuído) (centralizado) 1 * Remoto push pull Local 1 update commit update commit 1 * 91

92 Trabalhando com Mercurial Grafo de revisões tip 3: 3a63 2: ecf3 0: 9117 Bob Alice 1: 273c 92

93 Trabalhando com Mercurial Grafo de revisões tip tip 3: 3a63 3: 3a63 2: ecf3 2: ecf3 0: : 273c hg clone Bob Alice 1: 273c 0:

94 Trabalhando com Mercurial tip tip 5: 5f24 5: : ce3b 4: 207f 3: 3a63 3: 3a63 2: ecf3 2: ecf3 1: 273c 1: 273c 0: 9117 Bob Alice Grafo de revisões 0:

95 Trabalhando com Mercurial Grafo de revisões tip 7: 5f24 6: ce3b tip 5: 5f24 5: : ce3b 4: 207f 2: ecf3 3: 3a63 hg pull Bob Alice 3: 3a63 2: ecf3 95

96 Trabalhando com Mercurial Grafo de revisões merge hg merge tip 7: 5f24 tip 6: ce3b 5: 5f24 5: : ce3b 4: 207f 2: ecf3 3: 3a63 Bob Alice 3: 3a63 2: ecf3 96

97 Trabalhando com Mercurial Grafo de revisões tip 8: b4d0 7: 5f24 tip 6: ce3b 5: 5f24 5: : ce3b 4: 207f 2: ecf3 3: 3a63 Bob Alice 3: 3a63 2: ecf3 97

98 Trabalhando com Mercurial Grafo de revisões tip tip 8: b4d0 8: b4d0 7: : 5f24 6: 207f 6: ce3b 5: 5f24 5: : ce3b 4: 207f 2: ecf3 3: 3a63 Bob Alice 3: 3a63 hg pull (alice) hg push (bob) 2: ecf3 98

99 Trabalhando com Mercurial Comandos Comandos comuns hg hg hg hg hg hg hg hg hg hg hg hg add annotate commit copy diff help log remove rename revert status update (svn (svn (svn (svn (svn (svn (svn (svn (svn (svn (svn (svn add) blame) commit) copy) diff) help) log) delete) move) revert) status) update) 99

100 Trabalhando com Mercurial Comandos Acesso a repositórios Local HTTP, Mercurial SSH, Mercurial /home/user/hg/project/ file:///home/user/hg/project/ ssh://hg.example.com/hg/project/ 100

101 Trabalhando com Mercurial Criação e clonagem Criação do projeto hg init [diretório] Clonagem hg clone origem [diretório] Transforma o diretório atual (ou o diretório informado) em um repositório Mercurial Cria uma cópia do repositório de origem É, implicitamente, uma ramificação Hg lembra seu repositório de origem 101

102 Trabalhando com Mercurial Trabalho distribuído Trazer (puxar) submissões hg pull [URL] hg incoming [URL] Recupera as diferenças entre o repositório indicado e o seu, e aplica as alterações. Se URL for omitido, seu repositório de origem (fornecido ao hg clone ) é considerado. Atualiza apenas o repositório, use hg update para atualizar a cópia de trabalho. Mostra o que há no repositório indicado que não há no seu, e pode ser trazido com hg pull. 102

103 Trabalhando com Mercurial Trabalho distribuído Levar (empurrar) submissões hg push [URL] hg outgoing [URL] Determina as diferenças entre o seu repositório e o indicado, e as aplica remotamente. Se URL for omitido, seu repositório de origem (fornecido ao hg clone ) é considerado. Não cria ramificações remotas, seu repositório precisa estar compatível (via hg pull ). Mostra o que há no seu repositório que não há no indicado, e pode ser levado com hg push. 103

104 Trabalhando com Mercurial Trabalho distribuído Mescla hg heads [rev] hg merge [rev] Mostra as revisões-cabeça do grafo de revisões (todas as ramificações). Mescla as alterações de uma determinada cabeça à cópia de trabalho. Caso rev seja omitido, e só houver uma outra cabeça possível de ser mesclada (não ambígua), tal cabeça será selecionada. 104

105 Trabalhando com Mercurial Consulta de estado Comandos hg status hg identify [-i] [-n] [-b] [-t] Mostra qual a revisão atual da cópia de trabalho. hg parents [-r rev] [alvo] Mostra arquivos alterados, adicionados, etc. Mostra as revisões ascendentes da revisão atual (ou a revisão fornecida). 105

106 Trabalhando com Mercurial Consulta ao histórico Histórico hg log [-v] Visualização hg view Descrição textual do histórico. Visualiza o histórico interativamente. Grafo de revisões. 106

107 Trabalhando com Mercurial Ramificações Clonagem Locais, anônimas Criadas implicitamente Submissão sobre revisão intermediária Locais, explícitas Criadas implicitamente Basta clonar a cópia de trabalho Eficiente: utiliza hardlinks quando possível Criadas através de hg branch Armazenadas no próprio repositório 107

108 Trabalhando com Mercurial Rótulos Referenciam determinados changesets Fazem parte do controle de versões Comandos hg tag [-l] [-r rev] nome hg tag [-l] --remove nome Cria um novo rótulo nome para a revisão rev. Parâmetro -l : rótulo local. Apaga um rótulo. 108

109 Obrigado! Juliano F. Ravasi Esta apresentação: 109