Orientações técnicas/Geração de release v1

Orientações técnicas/Geração de release v1 1.1 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Linha 1

<<TableOfContents>>

Linha 2

Linha 3

== Liberação de versão (release) ==

Linha 4

Linha 5

Este tutorial explica o processo de liberação de versão (release), subdividido em duas etapas:

Linha 6

Linha 7

* **Preparação**:

Linha 8

** Identificar os projetos que estão prontos para serem liberados;

Linha 9

** Atualizar as notas de versão do projeto e consolidá-las no Subversion.

Linha 10

Linha 11

* **Execução**:

Linha 12

** Baixar o projeto consolidado diretamente do Subversion;

Linha 13

** Gerar a baseline (tag) no Subversion;

Linha 14

** Gerar e publicar os produtos da baseline: Repositório Maven, Site do Projeto e Pacote para download no SourceForge.

Linha 15

Linha 16

=== Ferramentas ===

Linha 17

Linha 18

As seguintes ferramentas são necessárias:

Linha 19

Linha 20

* IDE de sua preferência;

Linha 21

* Maven >= 2.0.x;

Linha 22

* Subversion >= 1.4.x.

Linha 23

Linha 24

=== Convenções ===

Linha 25

Linha 26

* ${SF_PROJECT}: Nome do projeto no SourceForge (e.g. demoiselle, demoiselle-comp, demoiselle-wzd, demoiselle-samp);

Linha 27

* ${PROJECT} : Nome do subprojeto (ex: demoiselle-mail, demoiselle-jsf-ui, ...);

Linha 28

* ${VERSION} : Versão do subprojeto;

Linha 29

* ${USERNAME} : Nome do usuário do SourceForge;

Linha 30

* ${PASSWORD} : Senha da conta do SourceForge.

Linha 31

Linha 32

=== Preparação ===

Linha 33

Linha 34

Recomenda-se que a etapa de preparação seja feita com auxílio de uma IDE.

Linha 35

Linha 36

* Baixar o projeto:

Linha 37

** Utilizando a IDE, baixe o projeto do repositório Subversion:

Linha 38

}

Linha 39

Linha 40

* Identificar no Mantis os projetos prontos para liberação:

Linha 41

** Acesse a aba [[http://sourceforge.net/apps/mantisbt/demoiselle/roadmap page.php|“Planejamento (Roadmap)”]];

Linha 42

** Identifique os projetos que estão 100% concluídos.

Linha 43

Linha 44

* Atualizar o release-notes do projeto com base no [[http://sourceforge.net/apps/mantisbt/demoiselle/roadmap page.php|“Roadmap”]]:

Linha 45

** Acesse o arquivo **release-notes.apt** e certique-se que está coerente com o Roadmap do projeto. Caso não esteja, atualize-o com as informações do Roadmap seguindo o seguinte padrão:

Linha 46

}

Linha 47

** Faça o mesmo com o release-notes.apt do site em inglês;

Linha 48

** Efetue o commit para consolidar as modificações do projeto no Subversion.

Linha 49

Linha 50

* Configurar o arquivo **settings.xml** do Maven:

Linha 51

** Abra o arquivo settings.xml do repositório Maven local (e.g. ~/.m2/settings.xml);

Linha 52

** Caso não exista, defina uma seção <server> para o projeto:

Linha 53

Linha 54

}

Linha 55

Linha 56

**OBS:** Para garantir a confidencialidade de suas informações e segurança do projeto, siga este o passo-a-passo (http://maven.apache.org/guides/mini/guide-encryption.html) para criptografar a sua senha no arquivo settings.xml.

Linha 57

Linha 58

=== Execução ===

Linha 59

Linha 60

Para evitar incompatibilidade entre as versões dos plug-ins da IDE e as versões das ferramentas de linha de comando, esta seção do passo-a-passo deve ser executada exclusivamente via **linha de comando**.

Linha 61

Linha 62

* Criar um diretório vazio para hospedar o projeto.

Linha 63

Linha 64

}

Linha 65

Linha 66

* Fazer o checkout do projeto para a pasta local **release**.

Linha 67

Linha 68

}

Linha 69

Linha 70

**OBS:** Não reutilize o mesmo diretório local que você escolheu na etapa de **Preparação** utilizando a IDE, pois pode gerar incompatibilidade das versões do Subversion (IDE x linha de comando).

Linha 71

Linha 72

* Acessar a pasta **release**.

Linha 73

Linha 74

}

Linha 75

Linha 76

* Abrir uma conexão com o shell do SourceForge em um **novo terminal**:

Linha 77

** Abra um novo terminal e execute o seguinte comando:

Linha 78

Linha 79

}

Linha 80

Linha 81

* Gerar e publicar a baseline (tag) e seus produtos:

Linha 82

** Volte para o primeiro terminal e execute o seguinte comando para gerar a baseline (tag) no Subversion:

Linha 83

}

Linha 84

** Execute o seguinte comando para gerar e publicar os produtos da baseline (e.g. Repositório Maven, Site do Projeto e Pacote para download no SourceForge):

Linha 85

Linha 86

}

Linha 87

Linha 88

* Rotular os arquivos para download no SourceForge:

Linha 89

** Acesse o gerenciador de arquivos do projeto no SourceForge;

Linha 90

** Acesse o arquivo /${PROJECT}/${VERSION}/${PROJECT}**-bin.zip**:

Linha 91

*** Coloque a descrição: **Binaries and required libraries**;

Linha 92

*** Marque todas as plataformas;

Linha 93

** Acesse o arquivo /${PROJECT}/${VERSION}/${PROJECT}**-src.zip**:

Linha 94

*** Coloque a descrição: **Source code files**;

Linha 95

Linha 96

* Atualizar os casos no Mantis para o status FECHADO.

Linha 97

Linha 98

* Atualizar a versão do projeto no Mantis como liberada e criar a versão seguinte.

Linha 99

Linha 1

~~New~~

Orientações técnicas/Geração de release v1 1.2 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Linha 3

== Liberação de versão (release) ==

== Liberação de versão (release) com o novo build ==

Orientações técnicas/Geração de release v1 1.3 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Orientações técnicas/Geração de release v1 1.4 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Orientações técnicas/Geração de release v1 1.5 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Linha 26

* ${SF_PROJECT}: Nome do projeto no SourceForge (e.g. ~~demoiselle, demoiselle-~~comp~~, dem~~oise~~lle-~~wzd, ~~demoi~~selle-samp);

* ${SF_PROJECT}: Nome do projeto no SourceForge (e.g. component, wizard, sample, framework);

Orientações técnicas/Geração de release v1 1.6 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Orientações técnicas/Geração de release v1 1.7 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:10 GMT

Linha 100

* Atualizar a versão do projeto no Mantis como liberada e criar a versão seguinte.

=== Arquétipos ===

No caso dos arquétipos, é preciso atualizar o seguinte arquivo XML correspondente ao catálogo:

}

Orientações técnicas/Geração de release v1 1.8 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:11 GMT

Linha 88

}

Devido a problemas de conexão ao SourceForge, a geração de release via Maven muitas vezes é interrompida no meio do processo e somos obrigados a executar o comando novamente. Para automatizar esse processo, abra o shell do SF em um terminal (timeout de 4 horas) e execute a instrução abaixo:

}

Orientações técnicas/Geração de release v1 1.9 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:11 GMT

Linha 26

* ${SF_PROJECT}: Nome do projeto no SourceForge (e.g. component, wizard, sample, framework);

* SF_PROJECT: Nome do projeto no SourceForge (e.g. component, wizard, sample, framework)

Linha 27

* ${PROJECT} : Nome do subprojeto (ex: demoiselle-mail, demoiselle-jsf-ui, ~~...~~);

* PROJECT: Nome do subprojeto (ex: demoiselle-mail, demoiselle-jsf-ui, escola, auction5)

Linha 28

* ${VERSION} : Versão do subprojeto;

* VERSION: Versão do subprojeto (ex: 1.0.6)

Linha 29

* ${USERNAME} : Nome do usuário do SourceForge;

* USERNAME: Nome do usuário do SourceForge

Linha 30

* ${PASSWORD} : Senha da conta do SourceForge.

* PASSWORD: Senha da conta do SourceForge

Orientações técnicas/Geração de release v1 2.0 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:11 GMT

Linha 56

Linha 57

Linha 58

Caso você tenha configurado acesso ao SourceForge via **Chaves SSH** (vide guia em https://sourceforge.net/apps/trac/sourceforge/wiki/SSH%20keys) a tag <password> contendo a senha pode ser omitida no arquivo **settings.xml**.

Orientações técnicas/Geração de release v1 2.1 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:11 GMT

Orientações técnicas/Geração de release v1 2.2 (Edição mínima)

Test Test — Wed, 09 Jan 2013 20:00:11 GMT

Linha 47

** Faça o mesmo com o release-notes.apt do site em inglês;

** Faça o mesmo com o release-notes.apt do site em inglês (se existente);

Orientações técnicas/Geração de release v1 2.3

Test Test — Fri, 05 Apr 2013 22:12:40 GMT

Linha 10

** Identificar os projetos que estão prontos para serem liberados;

** Atualizar as notas de versão do projeto e consolidá-las no Subversion.

** Identificar os projetos que estão prontos para serem liberados;

** Atualizar as notas de versão do projeto e consolidá-las no Subversion.

Linha 25

=== Convenções ===

Linha 38

* Baixar o projeto:

** Utilizando a IDE, baixe o projeto do repositório Subversion:

}

* Baixar o projeto:

** Utilizando a IDE, baixe o projeto do repositório Subversion:

Linha 37

{{{

https://demoiselle.svn.sourceforge.net/svnroot/demoiselle/${SF_PROJECT}/trunk/${PROJECT}

}}}

Linha 43

Linha 46

}

** Faça o mesmo com o release-notes.apt do site em inglês (se existente);

** Efetue o commit para consolidar as modificações do projeto no Subversion.

Linha 47

{{{

* ../1.1.0

* http://sourceforge.net/apps/mantisbt/demoiselle/view.php?id=148: [Feature] Refatorar mecanismo de injeção.

}}}

** Faça o mesmo com o release-notes.apt do site em inglês (se existente);** Efetue o commit para consolidar as modificações do projeto no Subversion.

Linha 58

{{{

Linha 59

<settings xmlns="http://maven.apache.org/POM/4.0.0"

Linha 60

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

Linha 61

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

Linha 62

http://maven.apache.org/xsd/settings-1.0.0.xsd">

Linha 63

Linha 64

Linha 65

<id>demoiselle.sourceforge.net</id>

Linha 66

<username>${USERNAME},${SF_PROJECT}</username>

Linha 67

<password>${PASSWORD}</password>

Linha 68

Linha 69

Linha 70

</server>

Linha 71

...

Linha 72

</servers>

Linha 73

...

Linha 74

</settings>

Linha 75

}}}

Linha 54

}

Linha 56

Linha 77

**OBS:** Para garantir a confidencialidade de suas informações e segurança do projeto, siga este o passo-a-passo ([[http://maven.apache.org/guides/mini/guide-encryption.html)|http://maven.apache.org/guides/mini/guide-encryption.html)]] para criptografar a sua senha no arquivo 'settings.xml'.

Linha 58

Linha 80

Caso você tenha configurado acesso ao SourceForge via **Chaves SSH** (vide guia em [[https://sourceforge.net/apps/trac/sourceforge/wiki/SSH%20keys)|https://sourceforge.net/apps/trac/sourceforge/wiki/SSH%20keys)]] a tag <password> contendo a senha pode ser omitida no arquivo **settings.xml**.

Linha 88

{{{

Linha 89

mkdir temp

Linha 90

cd temp

Linha 91

}}}

Linha 66

}

Linha 95

{{{

Linha 96

svn checkout https://demoiselle.svn.sourceforge.net/svnroot/demoiselle/${SF_PROJECT}/trunk/${PROJECT} release

Linha 97

}}}

Linha 70

}

Linha 99

Linha 104

{{{

Linha 105

cd release

Linha 106

}}}

Linha 76

}

Linha 108

Linha 112

{{{

Linha 113

ssh -t <username,demoiselle>@shell.sourceforge.net create

Linha 114

}}}

Linha 81

}

Linha 116

Linha 85

}

** Execute o seguinte comando para gerar e publicar os produtos da baseline (e.g. Repositório Maven, Site do Projeto e Pacote para download no SourceForge):

Linha 120

{{{

Linha 121

mvn release:prepare -Dusername=${USERNAME} -Dpassword=${PASSWORD}

Linha 122

}}}

Linha 88

}

Linha 124

** Execute o seguinte comando para gerar e publicar os produtos da baseline (e.g. Repositório Maven, Site do Projeto e Pacote para download no SourceForge):**

{{{

mvn release:perform -Dusername=${USERNAME} -Dpassword=${PASSWORD}

}}}

Linha 132

{{{

Linha 133

while ! mvn -e release:perform; do date; echo "Rodando de novo..."; sleep 60; done

Linha 134

}}}

Linha 92

}

Linha 101

Linha 103

Linha 109

}

Linha 150

{{{

http://demoiselle.sourceforge.net/repository/archetype-catalog.xml

}}}