Em geral, a necessidade de "subir" um novo Accelero vem como resultado de uma venda realizada pelo departamento comercial. É enviado um e-mail para alguém do time de devops solicitando um novo deploy.
INFORMAÇÕES NECESSÁRIAS
Pra começar, você vai precisar das seguintes informações:
- facility da instalação (até 10 caracteres, regexp [A-Z0-9]);
- razão social e CNPJ de quem é o licenciado (dados que vão no contrato);
- nome do cliente final (apenas o nome/identificação);
- o que exatamente foi vendido (licença, módulos);
- formulário enviado pelo cliente com a política de upgrade;
- número do pedido de venda Patron.
Se não tiver essas informações, devolva o processo.
ESCOLHA DO SERVIDOR
Você deve escolher um servidor pra abrigar esse novo deploy. Essa escolha é uma arte, mas de modo geral as regras são:
- clientes "muito grandes" devem ficar sozinhos em um servidor, ou pelo menos "com poucos vizinhos";
- "muito grande" é abstrato, mas podemos entender como "cliente com muitos controladores ou um fluxo de pessoas muito alto".
- um servidor não deve abrigar mais que 3 deploys, e talvez mais um "demo" (porque na prática não tem uso);
Se não houver "vaga" em um servidor já existente, deve-se criar um novo servidor (vide artigo específico).
OZONE - CADASTRO DE DEPLOY + LICENÇA INICIAL
Entre no Ozone e vá na parte de Deploys.
Informe pro Ozone os dados do deploy que está sendo criado. Após criar/salvar, não se esqueça de conferir na tela que foi aberta os dados sobre "política de upgrade".
Em seguida, acesse o menu Gerenciar licenças e gere a licença inicial do cliente. Inclua no campo INFORMAÇÕES ADICIONAIS DA LICENÇA (USO INTERNO) qualquer informação que possa ser útil para rastrear a operação no futuro (número do Pedido de Venda, por exemplo).
Os dados da licença devem "bater" com o pedido de venda do Patron (para verificar o que foi vendido, entre no Patron e navegue até o respectivo Pedido de venda). Cuidado com licenças de "facial", pois em geral deve-se mexer em dois lugares ao mesmo tempo (liberação do módulo + acerto de "quantidade de devices").
SCRIPT PARA PREPARAR NOVO DEPLOY
Conecte via SSH no servidor aonde o deploy será feito e execute o seguinte script:
/root/docker/scripts/deployNewAccelero.sh
Siga as instruções em tela. A porta MQTT é gerada aleatoriamente, e a não ser que você seja muito azarado, não precisa mexer.
Ao final, o deploy será preparado no diretório /root/docker/endereco.accelerobr.com.br e as entradas DNS serão criadas.
Se estiver confiante, coloque o deploy no ar executando:
/root/docker/endereco.accelerobr.com.br/scripts/up.sh
Espere o processo terminar e confira se o Accelero está no ar acessando o sistema pelo browser e conferindo se todos os containers estão em execução sem reiniciar ( docker ps).
PATRON
Entre no Patron e busque o Pedido de venda que foi informado.
Selecione todos os itens que têm a ver com a licença que foi gerada + o item "Ativação de software", se houver, e clique em Mais ações > Entregar itens. Na tela a seguir, clique em Finalizar etapa.
Do ponto de vista do ERP, o processo está concluído.
E-MAIL DE BOAS VINDAS
Deve ser enviado um e-mail pro cliente com os dados iniciais de acesso ao novo deploy.
Pra isso, acesse o Ozone e vá na parte de Deploys, selecione o deploy desejado, edite, e complete o campo E-mail responsáveis (separar por ponto-e-vírgula) (esse campo indica quem deve receber essa mensagem de boas-vindas). Salve o cadastro.
Em seguida, vá na aba Enviar e-mails e selecione o template desejado (além do "Boas-vindas", podem existir outros dependendo do que foi vendido para o cliente).
RESUMO - CHECKLIST
| GRUPO | ITEM | OK / NOK |
|---|---|---|
| INFO | Tem o FACILITY da instalação | |
| INFO | Tem razão social + CNPJ do licenciado | |
| INFO | Tem nome do cliente final | |
| INFO | Tem relação completa de módulos/o-que-precisa-ser-entregue | |
| INFO | Tem formulário de upgrade | |
| INFO | Tem número de pedido Patron | |
| ACTION | Selecionou o servidor? | |
| ACTION | Fazer SSH para o servidor e executar script deployNewAccelero.sh | |
| ACTION | Colocar o deploy no ar com up.sh | |
| ACTION | Conferir se deploy está no ar (HTTP) | |
| ACTION | Conferir se containers não estão reiniciando | |
| BUROCRACIA | Cadastrar o deploy no Ozone | |
| BUROCRACIA | Dar baixa no pedido Patron | |
| BUROCRACIA | Enviar e-mail de boas-vindas |