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

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

2013-01-09T20:00:35Z

Linha 1

<<TableOfContents>>

Linha 2

Linha 3

== Liberação de versão (release) utilizando o build automatizado v2 ==

Linha 4

Linha 5

Este procedimento está em fase de elaboração e por enquanto contempla a geração de release da versão 2.0 do framework, incluindo o core, as extensões, parent poms e arquétipos. Futuramente este procedimento deverá contemplar a release da documentação de referência, a aplicação de exemplo, o wizard, os componentes e, talvez, até o processo.

Linha 6

Linha 7

Todo o processo pode ser executado dentro da IDE ou diretamente da linha de comando, desde que ambos possuam o Maven (>=2.2) instalado e o Subversion (>=1.6) também. Quem estiver utilizando o Demoiselle Infra vai se dar bem, pois já terá o ambiente com todos os pré-requisitos instalados.

Linha 8

Linha 9

=== Pré-requisitos ===

Linha 10

Linha 11

* IDE que tenha integração com o Maven e Subversion, recomendamos o Eclipse do Demoiselle Infra

Linha 12

* Maven >= 2.2

Linha 13

* Subversion >= 1.6.x

Linha 14

* Java Development Kit >= 1.6, recomendamos o OpenJDK

Linha 15

Linha 16

=== Mão na massa ===

Linha 17

Linha 18

Antes de mais nada, certifique-se que seu arquivo **~/.m2/settings.xml** do Maven possui a configuração de conexão com o SourceForge:

Linha 19

Linha 20

}

Linha 21

Linha 22

Agora vamos considerar que você está utilizando o Demoiselle Infra. Se este não for o seu caso, entenda o processo pois você poderá reproduzí-lo utilizando a ferramenta que bem entender, inclusive a linha de comando!

Linha 23

Linha 24

Se você já possui o código-fonte do Demoiselle no Eclipse, ótimo! Para garantir que está tudo atualizado, execute um "Team / Update do HEAD". Se você não possui o fonte ainda, baixe via "File / Import / Check out Maven Projects from SCM" e utilize a seguinte URL do SVN: https://demoiselle.svn.sf.net/svnroot/demoiselle/framework/branches/demoiselle-2.0.

Linha 25

Linha 26

No arquivo "pom.xml" do projeto "demoiselle", verifique a versão que será liberada em "<parent><version>VERSÃO-SNAPSHOT</version></parent>". Caso a versão não seja esta, você terá que atualizar todas as referências em todos os sub-projetos, é um processo custoso. Se a versão já está correta, verifique se a propriedade "project.nextVersion" condiz com o planejamento da próxima versão. Garanta que tudo estará "comitado" antes de prosseguir.

Linha 27

Linha 28

Tudo pronto para liberar a versão. Mas para garantir que não dará erro nos testes, execute "Run As / Maven install" e depois "Run As / Maven test" no projeto "demoiselle". Se tudo ocorrer bem, vamos liberar a versão!

Linha 29

Linha 30

O **primeiro passo** é gerar a TAG no Subversion, para isso acesse "Run As / Run Configurations" no projeto "demoiselle". Nos campo "Goals" use "clean release:prepare". Adicione os parâmetros "username" e "password" com o seu usuário e senha do SourceForge. Execute! A qualquer momento você pode executar o "Goal" "release:rollback" para desfazer o processo, porém a TAG no Subversion deverá ser excluída manualmente.

Linha 31

Linha 32

O **segundo passo** é disponibilizar os artefatos Maven no repositório e os arquivos empacotados para download no SourceForge. Acesse "Run As / Run Configurations" no projeto "demoiselle". Nos campo "Goals" use "release:perform". Adicione os parâmetros "username" e "password" com o seu usuário e senha do SourceForge. Execute e espere, pois vai demorar. Feito isso, a liberação estará concluída!

Linha 33

Linha 34

=== O que falta neste documento ===

Linha 35

Linha 36

Ainda não está descrito aqui a interação que deve ser feito com o Mantis.

Linha 1

~~New~~

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

2013-01-09T20:00:35Z

Linha 24

Se você já possui o código-fonte do Demoiselle no Eclipse, ótimo! Para garantir que está tudo atualizado, execute um **Team / Update do HEAD**. Se você não possui o fonte ainda, baixe via **File / Import / Check out Maven Projects from SCM** e utilize a seguinte URL do SVN: https://demoiselle.svn.sf.net/svnroot/demoiselle/framework/branches/demoiselle-2.0.

Linha 26

No arquivo "pom.xml" do projeto "demoiselle", verifique a versão que será liberada em &~~#034;&~~lt;parent><version>VERSÃO-SNAPSHOT</version></parent>". Caso a versão não seja esta, você terá que atualizar todas as referências em todos os sub-projetos, é um processo custoso. Se a versão já está correta, verifique se a propriedade "project.nextVersion" condiz com o planejamento da próxima versão. Garanta que tudo estará "comitado" antes de prosseguir.

No arquivo **pom.xml** do projeto **demoiselle**, verifique a versão que será liberada em **<parent><version>VERSÃO-SNAPSHOT</version></parent>**. Caso a versão não seja esta, você terá que atualizar todas as referências em todos os sub-projetos, é um processo custoso. Se a versão já está correta, verifique se a propriedade **project.nextVersion** condiz com o planejamento da próxima versão. Garanta que tudo estará comitado antes de prosseguir.

Linha 28

Tudo pronto para liberar a versão. Mas para garantir que não dará erro nos testes, execute **Run As / Maven install** e depois **Run As / Maven test** no projeto **demoiselle**. Se tudo ocorrer bem, vamos liberar a versão!

Linha 30

O **primeiro passo** é gerar a TAG no Subversion, para isso acesse "Run As / Run Configurations" no projeto "demoiselle". Nos campo "Goals" use "clean release:prepare". Adicione os parâmetros "username" e "password" com o seu usuário e senha do SourceForge. Execute! A qualquer momento você pode executar o ~~"Goal" "~~release:rollback" para desfazer o processo, porém a TAG no Subversion deverá ser excluída manualmente.

O **primeiro passo** é gerar a TAG no Subversion, para isso acesse **Run As / Run Configurations** no projeto **demoiselle**. Nos campo **Goals** use **clean release:prepare**. Adicione os parâmetros **username** e **password** com o seu usuário e senha do SourceForge. Execute! A qualquer momento você pode executar o **release:rollback** para desfazer o processo, porém a TAG no Subversion deverá ser excluída manualmente.

Linha 32

O **segundo passo** é disponibilizar os artefatos Maven no repositório e os arquivos empacotados para download no SourceForge. Acesse **Run As / Run Configurations** no projeto **demoiselle**. Nos campo **Goals** use **release:perform**. Adicione os parâmetros **username** e **password** com o seu usuário e senha do SourceForge. Execute e espere, pois vai demorar. Feito isso, a liberação estará concluída!

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

2013-01-09T20:00:35Z

Linha 36

Ainda não está descrito aqui a interação que deve ser feito com o Mantis.

Ainda não está descrito aqui a interação que deve ser feita com o Mantis.

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

2013-01-09T20:00:35Z

Linha 28

Tudo pronto para liberar a versão. Ma~~s pa~~ra garantir que não dará ~~erro~~ nos testes, execute **Run As / Maven install** e depois **Run As / Maven test** no projeto **demoiselle**. Se ~~tud~~o ocorrer bem, vamos liberar a versão!

Tudo pronto para liberar a versão. Para garantir que não haverá falha nos testes, execute **Run As / Maven install** e depois **Run As / Maven test** no projeto **demoiselle**. Se ocorreu problema, corrija e comite. Quando tudo estiver Ok, vamos liberar a versão!

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

2013-01-09T20:00:35Z

Linha 36

Ainda não está descrito aqui a interação que deve ser feita com o Mantis.

Ainda não está descrita aqui a interação que deve ser feita com o Mantis.

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

2013-01-09T20:00:35Z

Linha 28

Tudo pronto para liberar a versão. Para garantir que não haverá falha nos testes, execute **Run As / Maven install** no projeto **demoiselle**. Se ocorreu problema, corrija e comite. Quando tudo estiver Ok, vamos liberar a versão!

Linha 30

O **primeiro passo** é gerar a TAG no Subversion, para isso acesse **Run As / Run Configurations** no projeto **demoiselle**. Nos campo **Goals** use **clean release:prepare**. Adicione os parâmetros **username** e **password** com o seu usuário e senha do SourceForge clicando no botão **Add...**. Execute! A qualquer momento você pode executar o **release:rollback** para desfazer o processo, porém a TAG no Subversion deverá ser excluída manualmente.

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

2013-01-09T20:00:36Z

Linha 32

O **segundo passo** é disponibilizar os artefatos Maven no repositório e os arquivos empacotados para download no SourceForge. Acesse **Run As / Run Configurations** no projeto **demoiselle**. Nos campo **Goals** use **release:perform**. ~~Adici~~one os parâme~~tro~~s **userna~~me** e **passwor~~d** c~~om o seu usuár~~io e senh~~a do So~~urceForge. Execute e espere, pois vai demorar. Feito isso, a liberação estará concluída!

O **segundo passo** é disponibilizar os artefatos Maven no repositório e os arquivos empacotados para download no SourceForge. Acesse **Run As / Run Configurations** no projeto **demoiselle**. Nos campo **Goals** use **release:perform**. Não é preciso adicionar nenhum parâmetro. Execute e espere, pois vai demorar. Feito isso, a liberação estará concluída!

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

2013-01-09T20:00:36Z

Linha 37

Ainda não está descrita aqui a interação que deve ser feita com o Mantis.

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

2013-01-09T20:00:36Z

Linha 7

Todo o processo pode ser executado dentro da IDE ou diretamente da linha de comando, desde que ambos possuam o Maven (>=2.2) instalado e o Subversion (>=1.6) também. Quem estiver utilizando o [[http://demoiselle.sourceforge.net/infra|Demoiselle Infra]] vai se dar bem, pois já terá o ambiente com todos os pré-requisitos instalados.

Linha 11

* IDE que tenha integração com o Maven e Subversion, recomendamos o [[http://www.eclipse.org/|Eclipse]] (versão do [[http://demoiselle.sourceforge.net/infra|Demoiselle Infra]])

Linha 12

* [[http://maven.apache.org/|Maven]] >= 2.2

Linha 13

* Subversion >= 1.6.x [[http://subclipse.tigris.org/|Subclipse]]

Linha 14

* Java Development Kit >= 1.6, recomendamos o [[http://openjdk.java.net/install/|OpenJDK]]

Linha 11

* IDE que tenha integração com o Maven e Subversion, recomendamos o Eclipse do Demoiselle Infra

Linha 12

* Maven >= 2.2

Linha 13

* Subversion >= 1.6.x

Linha 14

* Java Development Kit >= 1.6, recomendamos o OpenJDK

Linha 18

Antes de mais nada, certifique-se que seu arquivo **~~~/.m2/~~settings.xml** do Maven possui a configuração de conexão com o SourceForge:

Antes de mais nada, certifique-se que seu arquivo **settings.xml** do Maven possui a configuração de conexão com o SourceForge:

Linha 22

Agora vamos considerar que você está utilizando o [[http://demoiselle.sourceforge.net/infra|Demoiselle Infra]]. Se este não for o seu caso, entenda o processo pois você poderá reproduzi-lo utilizando a ferramenta que bem entender, inclusive a linha de comando!

Linha 30

O **primeiro passo** é gerar a TAG no Subversion, para isso ~~ace~~sse **Run As / Run Con~~figur~~a~~tio~~ns** no projeto **demoiselle**. Nos campo **Goals** use **clean release:prepare**. Adicione os parâmetros **username** e **password** com o seu usuário e senha do SourceForge clicando no botão **Add...**. Execute! A qualquer momento você pode executar o **release:rollback** para desfazer o processo, porém a TAG no Subversion deverá ser excluída manualmente.

O **primeiro passo** é gerar a TAG no Subversion, para isso, selecionando o projeto **demoiselle**, acesse: **Run As / Maven Build...**. Nos campo **Goals** use **clean release:prepare**. Adicione os parâmetros **username** e **password** com o seu usuário e senha do SourceForge clicando no botão **Add...**. Execute! A qualquer momento você pode executar o **release:rollback** para desfazer o processo, porém a TAG no Subversion deverá ser excluída manualmente.

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

2013-01-09T20:00:36Z

Linha 36

Ainda não está descrita aqui a interação que deve ser feita com o Mantis.

- Ainda não está descrita aqui a interação que deve ser feita com o Mantis.

Linha 37

- Criar os mesmos procedimento usando linha de comando, como na versão anterior, para evitar problemas com SVN (intalado na máquina) e Subeclipse. Isso já ocorria.

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

2013-01-09T20:00:36Z

Linha 13

* ~~Subversion >= 1.6.x~~ [[http://sub~~clips~~e.tigris.org/|Sub~~clips~~e]]

* [[http://subversion.tigris.org/|Subversion]] >= 1.6.x

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

2013-01-09T20:00:36Z

Linha 32

O **segundo passo** é disponibilizar os artefatos Maven no repositório e os arquivos empacotados para download no SourceForge. Acesse **Run As / Run Confi~~gurati~~ons** no projeto **demoiselle**. Nos campo **Goals** use **release:perform**. Não é preciso adicionar nenhum parâmetro. Execute e espere, pois vai demorar. Feito isso, a liberação estará concluída!

O **segundo passo** é disponibilizar os artefatos Maven no repositório e os arquivos empacotados para download no SourceForge. Selecione o projeto **Demoiselle** e Acesse **Run As / Maven Build...**. Nos campo **Goals** use **release:perform**. Não é preciso adicionar nenhum parâmetro. Execute e espere, pois vai demorar. Feito isso, a liberação estará concluída!

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

2013-01-09T20:00:36Z

Linha 37

- Ainda não está descrita aqui a interação que deve ser feita com o Mantis.

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

2013-01-09T20:00:37Z

Linha 18

Antes de mais nada, certifique-se que seu arquivo **settings.xml** do Maven possui a configuração de conexão com o SourceForge:

Antes de mais nada, certifique-se que seu arquivo **.m2/settings.xml** do Maven possui a configuração de conexão com o SourceForge:

Linha 21

}

- Algumas tarefas fazem conexão com o SourceForge usando conexões seguras (ssl), assim o ambiente precisa conter as chaves/certificados das urls.

- Para garantir que as chaves estão armazenadas no sistema, faça conexões via ssh (no terminal de linha de comando) para as urls abaixo:

}

- É importante estes procedimentos, pois as chaves também podem ter vencido.

- Caso haja algum erro de autenticação, com outra URL (as vezes o sourceforge atualiza), basta usar o mesmo comando para a URL referenciada.

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

2013-01-09T20:00:37Z

Linha 37

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

2013-01-09T20:00:37Z

Linha 22

Algumas tarefas fazem conexão com o SourceForge usando conexões seguras (SSL), assim o ambiente precisa conter as chaves/certificados das URLs. Para garantir que as chaves estão armazenadas no sistema, faça conexões via SSH via terminal:

Linha 22

~~- Algumas tarefas fazem conexão com o SourceForge usando conexões seguras (ssl), assim o ambiente precisa conter as chaves/certificados das urls.~~

Linha 24

~~- Para garantir que as chaves estão armazenadas no sistema, faça conexões via ssh (no terminal de linha de comando) para as urls abaixo:~~

Linha 26

Depois pode desconectar do SSH, pois nosso objetivo já foi atingido: implantar as chaves.

Linha 28

}

Linha 29

Linha 30

~~- É importante estes procedimentos, pois as chaves também podem ter vencido.~~

Linha 31

Linha 32

~~- Caso haja algum erro de autenticação, com outra URL (as vezes o sourceforge atualiza), basta usar o mesmo comando para a URL referenciada.~~

Linha 33