Skip to content

Arquivos com versões utilizadas em cada release do Portal Padrão

Notifications You must be signed in to change notification settings

plonegovbr/portalpadrao.release

Repository files navigation

portalpadrao.release

Esse repositório contém os arquivos com as versões utilizadas em cada release do Portal Padrão e uma explicação técnica do funcionamento do lançamento de um novo release.

Passos para criação de um novo release

A definição do que deve entrar em cada release é definido pela SECOM, com o desenvolvimento das funcionalidades/correções podendo ser feitas com os parceiros ou interessados na comunidade plonegovbr.

Versões e pinagens de novos releases em andamento (ou seja, que não tenham ainda o seu lançamento oficial) são feitas no arquivo https://github.com/plonegovbr/portal.buildout/blob/master/buildout.d/versions.cfg, presente em outro repositório, o https://github.com/plonegovbr/portal.buildout/. No momento, também temos a branch 1.x em https://github.com/plonegovbr/portal.buildout/blob/1.x/buildout.d/versions.cfg.

Ações para um novo release

Como escolher corretamente o arquivo de versões de um release

A versão escolhida em portalpadrao.release deve ser a mesma que a brasil.gov.portal sendo aceitas variações mínimas como bugfixes de um release (exemplo, o brasil.gov.portal é 1.1.5.1 mas o último release é o 1.1.5.2).

Pode ser que um release tenha sido lançado e, mesmo testado, ocorra uma situação muito específica que impeça o release de funcionar corretamente (uma dependência errada, uma diretiva de configuração de buildout incorreta, etc). Nesse tipo de situação, é feita a correção e gerado um bugfix do release. Não são feitos bugfixes de releases para adicionar novas funcionalidades pois o escopo já havia sido fechado no momento que ele foi lançado.

Como um release do IDG não envolve apenas o pacote brasil.gov.portal pois existem várias dependências (brasil.gov.* e vários pacotes da comunidade), não faz sentido mudar a versão de brasil.gov.portal se a modificação que por ventura tenha sido feita para o bugfix daquele release tiver ocorrido em outro pacote: por isso pode ocorrer a situação de um brasi.gov.portal ser a versão 1.1.5.1 mas aqui no portalpadrao.release ser 1.1.5.2.

Por que versions.cfg e versions-sem-extends.cfg? Qual devo usar?

A partir do release 1.4 o versions.cfg passou a ser gerado automaticamente a cada mudança e ele inclui todas as versões homologadas necessárias para instalar e atualizar o IDG.

O uso do versions-sem-extends.cfg não é considerado mais uma boa prática e será removido na versão 1.5 do IDG.

Como devo efetuar a atualização entre releases?

Ler a documentação específica de cada release em https://github.com/plonegovbr/portalpadrao.release/releases/tag/x.x.x ou https://github.com/plonegovbr/portal.buildout/releases/tag/x.x.x (sendo x.x.x a versão desejada) e continue com o manual oficial de Atualização de release.

Observações finais

No passado, para releases temporários, se usava o -pending, mas isso traz a desvantagem de quebrar todo pacote que referencia o pending quando você tenta voltar o histórico e rodar o buildout e por isso não será mais utilizado.