Procedimento de Release: mudanças entre as edições

De BIS Wiki
Ir para navegação Ir para pesquisar
Edição posterior →
Criou página com 'Para efetuar a release de uma nova distribuição do BIS siga os passos abaixo: == Release da Aplicação J2EE - BISEAR == {{stop|EAR|Não tratar o projeto BISEAR como os de...'
 
Linha 9: Linha 9:
Esses passos devem ser realizados nos projetos que serão incluídos neste release, e empacotados no EAR.
Esses passos devem ser realizados nos projetos que serão incluídos neste release, e empacotados no EAR.


# Ter a certeza de que as informações de versão do módulo, do banco de dados, e a versão das dependências estão corretas nas classes de "Description".
# Confirmar que as informações de versão dos módulos estão corretamente definidas na classe de definições (por exemplo: BISKernelPluginDefinitions e BISModulesPluginDefinitions);
# Fazer checkout do código que será feito o release a passar uma tag no formato "v<major>.<minor>.<revision>" garantindo que: O diretório onde a tag será criada está no formato "<repositório>/tags/vX.Y.Z";
# Configurar a mesma versão nos arquivos do MAVEN (pom.xml). Colocar na propriedade ${bis.version} a versão no formato '''v7.2.0''';
# Fazer o checkout para empacotamento pela tag gerada para que não ocorram erros. Ou ao fim da operação de definir a tagline marcar a opção migrar para a tag criada.
# Atualizar o arquivo de release (projeto BISEAR), informando a versão dos módulos que serão inclusos nessa versão do EAR e fazer checkin do arquivo.
# Fazer checkout do código que será feito o release a passar uma tag no formato "v<major>.<minor>.<revision>" (Para mais detalhes sobre o número de versão leia [[Definindo Número de Versão]]) garantindo que o diretório onde a tag será criada está no formato "<repositório>/tags/vX.Y.Z" (formato do SVN);
# Fazer o checkout pela tag gerada para que não ocorra o empacotamento de classes diferentes das marcadas na versão.


=== Fazer release do EAR ===
=== Compilar e "Instalar" os Pacotes no Repositório Maven ===


# Fazer checkout de todos os projetos que serão empacotados no EAR pela tag da versão que será empacotada.
Ao utilizar o projeto BISDistro você pode executar os comandos para todos os projetos de uma única vez. Também é possível executar o comando apenas em um projeto, no entanto é necessário que os pacotes dos projetos dependentes já estejam instalados no repositório local do Maven.
# Atualizar o arquivo de release, informando a versão dos módulos que serão inclusos nessa versão do EAR e fazer checkin do arquivo.
 
# Passar a tag informando a versão do empacotamento. Para o número de versão leia [[Definindo Número de Versão]].
Para executar o Maven siga os passos:
# Exportar o EAR usando a IDE. (até que seja feito scripts de build melhores =\).
 
# Editar o EAR exportado, e:
# Clique com o botão direito sobre o projeto desejado;
## alterar dentro do pacote lib/bispersistence.jar o persistence.xml para que os SQL não sejam impressos;
# Clicar em 'Run As...' no projeto, e escolher 'Maven build...', em goals informe os comandos que deseja:
## alterar o arquivo web.xml do war e definir o Vaadin como modo de produção = true.
#: '''clean''' - Força a limpeza das classes compiladas, e consequentemente o projeto todo é recompilado;
#: '''package''' - Força gerar o pacote da aplicação. Que é colocado na pasta 'target' dentro de cada projeto;
#: '''install''' - Força a geração dos pacotes e "instala" o pacote da versão criada no repositório local do Maven.
 
=== Release do EAR ===
 
O EAR é criado durante a phase de '''package''' do maven. Mas para a distribuição em produção, as seguintes alterações devem ser realiadas:
 
# alterar o arquivo persistence.xml dentro do pacote lib/bispersistence.jar para que os SQL não sejam impressos. Mais instruções no arquivo;
# alterar o arquivo web.xml do war e definir o Vaadin como modo de produção = true.

Edição das 17h49min de 23 de dezembro de 2016

Para efetuar a release de uma nova distribuição do BIS siga os passos abaixo:

Release da Aplicação J2EE - BISEAR

EAR
Não tratar o projeto BISEAR como os demais projetos de desenvolvimento. O procedimento do BISEAR são explicados no final e só devem ser feitos depois que os demais projetos envolvidos já estejam preparados para o release.

Preparando os projetos para o release

Esses passos devem ser realizados nos projetos que serão incluídos neste release, e empacotados no EAR.

  1. Confirmar que as informações de versão dos módulos estão corretamente definidas na classe de definições (por exemplo: BISKernelPluginDefinitions e BISModulesPluginDefinitions);
  2. Configurar a mesma versão nos arquivos do MAVEN (pom.xml). Colocar na propriedade ${bis.version} a versão no formato v7.2.0;
  3. Atualizar o arquivo de release (projeto BISEAR), informando a versão dos módulos que serão inclusos nessa versão do EAR e fazer checkin do arquivo.
  4. Fazer checkout do código que será feito o release a passar uma tag no formato "v<major>.<minor>.<revision>" (Para mais detalhes sobre o número de versão leia Definindo Número de Versão) garantindo que o diretório onde a tag será criada está no formato "<repositório>/tags/vX.Y.Z" (formato do SVN);
  5. Fazer o checkout pela tag gerada para que não ocorra o empacotamento de classes diferentes das marcadas na versão.

Compilar e "Instalar" os Pacotes no Repositório Maven

Ao utilizar o projeto BISDistro você pode executar os comandos para todos os projetos de uma única vez. Também é possível executar o comando apenas em um projeto, no entanto é necessário que os pacotes dos projetos dependentes já estejam instalados no repositório local do Maven.

Para executar o Maven siga os passos:

  1. Clique com o botão direito sobre o projeto desejado;
  2. Clicar em 'Run As...' no projeto, e escolher 'Maven build...', em goals informe os comandos que deseja:
    clean - Força a limpeza das classes compiladas, e consequentemente o projeto todo é recompilado;
    package - Força gerar o pacote da aplicação. Que é colocado na pasta 'target' dentro de cada projeto;
    install - Força a geração dos pacotes e "instala" o pacote da versão criada no repositório local do Maven.

Release do EAR

O EAR é criado durante a phase de package do maven. Mas para a distribuição em produção, as seguintes alterações devem ser realiadas:

  1. alterar o arquivo persistence.xml dentro do pacote lib/bispersistence.jar para que os SQL não sejam impressos. Mais instruções no arquivo;
  2. alterar o arquivo web.xml do war e definir o Vaadin como modo de produção = true.
Disponível em “http://wiki.biserp.com.br/index.php?title=Procedimento_de_Release&oldid=696”