Procedimento de Release: mudanças entre as edições
Ir para navegação
Ir para pesquisar
| Linha 1: | Linha 1: | ||
Para efetuar a release de uma nova distribuição do BIS siga os passos abaixo: | 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 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.}} | {{stop|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. | Esses passos devem ser realizados nos projetos que serão incluídos neste release, e empacotados no EAR. | ||
| Linha 15: | Linha 15: | ||
# Fazer o checkout pela tag gerada para que não ocorra o empacotamento de classes diferentes das marcadas na versão. | # 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. | 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. | ||
| Linha 27: | Linha 27: | ||
#: '''install''' - Força a geração dos pacotes e "instala" o pacote da versão criada no repositório local do Maven. | #: '''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: | 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: | ||
| Linha 33: | Linha 33: | ||
# 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 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. | # alterar o arquivo web.xml do war e definir o Vaadin como modo de produção = true. | ||
== Release do BISPDV == | |||
Gerado automaticamente pela phase de '''package''' do maven. Não é criado como um jar executável exatamente por faltar uma referência correta para as bibliotecas dentro do MANIFEST. | |||
* O jar do BISPDV é criado dentro da pasta target; | |||
* Todos os JARs necessários para a execução do BISPDV são copiados para a pasta 'target/lib-jars'. | |||
Edição das 20h21min 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
|
|
Preparando os projetos para o release
Esses passos devem ser realizados nos projetos que serão incluídos neste release, e empacotados no EAR.
- 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);
- Configurar a mesma versão nos arquivos do MAVEN (pom.xml). Colocar na propriedade ${bis.version} a versão no formato v7.2.0;
- 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.
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:
- Clique com o botão direito sobre o projeto desejado;
- 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:
- 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.
Release do BISPDV
Gerado automaticamente pela phase de package do maven. Não é criado como um jar executável exatamente por faltar uma referência correta para as bibliotecas dentro do MANIFEST.
- O jar do BISPDV é criado dentro da pasta target;
- Todos os JARs necessários para a execução do BISPDV são copiados para a pasta 'target/lib-jars'.