Skip to main content

Accelero - Lançamento de versão

Pra lançar uma nova versão do Accelero é necessário cumprir algumas burocracias.

Abaixo, um checklist de coisas que precisam ser checadas/feitas.

AÇÃODESCRIÇÃO
Atualizar scripts criação DBDEPRECATED
Isso só está aqui por questões de "ter histórico".
Esse problema foi resolvido com DBMigrations.
Ignore daqui pra baixo
---

Se houve a inclusão de algum arquivo de migration SQL, é necessário:
1. versionar o arquivo no repositório GIT (dbmigration/\\\\<VERSAO\\\>.sql)
2. atualizar o "script master" no diacetyl (script devenv/scripts/acceleroUpdateMasterQueries) após atualizar os bancos de dados accelero e telegram locais.

IMPORTANTE
Nunca usar os bancos accelero e telegram em ambiente de desenvolvimento... esses são os "masters". Sempre usar um accelero-dev e telegram-dev.
Upload de manual de operação - OzoneSe houve alteração de algo desde a última versão que precise atualizar o manual, fazer o procedimento, versionar o manual e fazer upload do PDF para o Ozone.

Não esquecer de, após atualizar o .DOCX, dar um "Selecionar tudo" e colar o conteúdo no "accelero_manual.txt" para permitir melhor controle de alterações no GIT.
Re-gerar preload scriptsAccelero usa sistema de preload em produção (https://www.php.net/manual/en/opcache.preloading.php).

Para gerar o arquivo de preload, usar o devtools.

IMPORTANTE
Antes de executar a função, navegue por todas as telas do Accelero. Habilite todos os módulos, salve cadastros, navegue pra todos os lados... isso vai garantir que as classes mais comuns entrem automaticamente no preload.
Create bundles (JS com tradução, CSS, etc...)Se houve alterações em JS/CSS, usar o devtools pra regerar os bundles.

Boas práticas dizem que isso deve fazer parte do commit na hora de fazer a alteração em si, e não deveria ser executado na hora de lançar versão. Mas...
Atualização changelog - gitCriar arquivo changelog/\\\\<VERSAO\\\> com lista de todas as alterações realizadas desde a última versão.
Atualização changelog - siteAtualizar página no site da Iongrade com o changelog. Só é necessário fazer isso em "versões não-hotfix" (e o changelog dos hotfixes deve ser incorporado no changelog da "próxima versão").
Atualização arquivo database_schema_versionDEPRECATED
Isso só está aqui por questões de "ter histórico".
Esse problema foi resolvido com DBMigrations.
Ignore daqui pra baixo
---

Se houve alteração na estrutura do banco de dados, garantir que:
1. o arquivo de migration está atualizando a versão do schema (deveria ser a última linha de TODOS os arquivos de migration);
2. o arquivo database_schema_version tem a versão do schema válido para aquela versão específica (deve-se casar o conteúdo desse arquivo com o UPDATE feito no último migration).
Atualizar arquivo version - gitAtualizar o arquivo version com a versão que está sendo lançada.
Atualizar versão - Ozone"Avisar" o Ozone que existe uma nova versão latest. Fazer isso apenas depois de testar a versão em ambiente de homologação.

Usar script devenv/scripts/gui.sh (opção Mark Accelero version as latest in Ozone)
Criar tag de versão - gitCriar tags de versão nos projetos Accelero e AcceleroDocker (1.2.3-HF8, por exemplo).

Não esquecer que no projeto AcceleroDocker devem ser criados tags para as versões:
- SaaS (branch master - tag idêntico à versão)
- onpremises (branch onpremises-x64 - tag deve ser \\\\<VERSAO\\\>-x64, por exemplo 1.2.3-HF8-x64).
Push para BitBucketFazer push dos projetos Accelero e AcceleroDocker para o repositório central.

Não esquecer de enviar tags!
Gerar bundle on-premisesGerar um bundle para instalação de Accelero on-premises.

Usar script devenv/scripts/gui.sh (opção Generate version - Accelero).
Notificar suporte por e-mailEnviar e-mail para suporte@iongrade.com.br dizendo que houve o lançamento de uma nova versão.

O assunto do e-mail deve ser:
[ACCELERO] Lançamento de versão - xxxxx

O corpo do e-mail deve ter o changelog da versão (cópia do arquivo de changelog).
Atualizar acceleroWarnings (Ozone) com novos warningsSe há alguma "pegadinha" para a atualização pra essa versão (necessário atualizar gateways, por exemplo), deve-se criar arquivos de "warning" no Ozone. Esses warnings serão mostrados em tela para quem estiver fazendo o upgrade.

Pra isso:
- acessar o servidor diacetyl;
- navegar até /root/docker/ozone/app/acceleroWarnings;
- criar um arquivo \\\\<VERSAO\\\>.txt;
- o conteúdo do arquivo deve ser "o que se quer mostrar como aviso em tela".