Geração de release #

Este tutorial explica o processo de geração de releases.

Os passos são:

1. Gerar a TAG da versão no SVN
2. Empacotar o projeto e disponibilizar no repositório
3. Gerar/publicar o site da versão

Ferramentas #

• Maven 2.0.x
• Subversion 1.4.x

Plugins da IDE devem estar de acordo com as versões das ferramentas: Ex.: Sublicpse updatesite: http://subclipse.tigris.org/update_1.4.x

Passos #

• Verificar no Mantis quais projetos precisam gerar release.
• Ir para a aba “Planejamento (Roadmap)”
• Identificar os projetos concluídos em 100%
• Fazer o checkout do projeto para a sua máquina local.

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

Obs.: Não utilizar o mesmo projeto no Eclipse, pois pode ocorrer divergência de versões do SVN.

SF_PROJECT: {component, wizard, sample}
PROJECT   : Nome do projeto ou subprojeto (ex: demoiselle-mail, demoiselle-jsf-ui, ...)

• Atualizar e comitar o arquivo “release notes”(release-notes.apt) do projeto que vai ser gerada a versão utilizando o seguinte padrão:

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

• Abrir um terminal shell e digitar o seguinte comando:

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

• Abrir outro terminal e entrar no diretório do projeto que foi baixado pelo SVN.
• Configurar o arquivo settings.xml, localizado no diretório /CONF da instalação do Maven (ex: /.m2/settings.xml).

<settings xmlns="http://maven.apache.org/POM/4.0.0|http://maven.apache.org/POM/4.0.0" 
                     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                     http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <servers>
        <server>
            <id>demoiselle.sourceforge.net</id>
            <username>${usuario},${projeto}</username>
            <password>${senha}</password>
        </server>
    </servers>
    ...
</settings>

• Executar o prepare. Digitar o comando:

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

• Executar o perform. Digitar o comando:

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

• Caso dê erro no momento de executar o perform, talvez seja necessário executar o seguinte comando antes de executar o perform.

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

• Ainda neste terminal, entrar na pasta target/checkout do projeto para gerar o assembly através do comando (exceto para arquétipos):

mvn assembly:assembly

• Atualizar os casos no Mantis para o status FECHADO.
• Atualizar a versão do projeto no Mantis como liberada e criar a versão seguinte.
• Fazer o upload do assembly. Primeiro o src e depois o bin, no File Manager do Projeto no Source Forge.

Obs.:  Às vezes ocorre um erro de chave. Caso isso ocorra, executar o seguinte comando antes de fazer o prepare:
ssh-keygen -q -f ~/.ssh/id_rsa -t rsa