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ÇÃO | DESCRIÇÃO |
|---|---|
| Atualizar scripts criação DB | DEPRECATED 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 - Ozone | Se 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 scripts | Accelero 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 - git | Criar arquivo changelog/\\\\<VERSAO\\\> com lista de todas as alterações realizadas desde a última versão. |
| Atualização changelog - site | Atualizar 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_version | DEPRECATED 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 - git | Atualizar 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 - git | Criar 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 BitBucket | Fazer push dos projetos Accelero e AcceleroDocker para o repositório central.Não esquecer de enviar tags! |
| Gerar bundle on-premises | Gerar um bundle para instalação de Accelero on-premises. Usar script devenv/scripts/gui.sh (opção Generate version - Accelero). |
| Notificar suporte por e-mail | Enviar 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 warnings | Se 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". |