Manual de Instalação Agility
Instalação do FrontManager
Configuração dos tenants e aplicações
Dados de acesso a infraestrutura da centralit (credenciais do git, credenciais do nexus)
kubectl configurado para o ambiente onde será feito o deploy (isso inclui as variáveis de ambiente do projeto, com seus devidos dados de acesso).
- Banco de dados (PostgreSQL 13+ / SQLServer 2019+ / Oracle 12c+)
- KeyCloak (já deve estar instalado pois o FrontManager depende dele)
- MinIO (já deve estar instalado pois o FrontManager depende dele)
- Kafka (já deve estar instalado pois o FrontManager depende dele)
Passos para instalação do Agility:
- Clonar o repositório do hyper-kanban-api
- Entrar na pasta onde o projeto foi clonado e fazer checkout da branch devel
- Executar Step 1. Migrations
- Executar Step 2. Deploy
O script migrations.sh processa as migrações para múltiplos bancos de acordo com as configurações presentes num arquivo de migrações em formato json que por padrão é migrations-config.json na mesma pasta do script.
O arquivo deve seguir a estrutra abaixo:
Onde os atributos de cada tenant que segue:
Exemplo de arquivo com dois tenants (run2biz e tenant1) para o ambiente desen aplicação hyper-kanban-api (esta aplicação).
Modo de uso
Exemplo
Para alguns ambientes, já existe a automação no gitlab, onde simplesmente fazendo o merge para a branch ele já aciona o deploy do produto (apps.centralit, labcentral). São os casos das branches com prefixo deploy/
Exemplo gitlab CI na branch deploy/apps.centralit.com.br
Para fazer manual, devem ser criados os arquivos template do ambiente em questão:
- configmap.template.yml
- deployment.template.yml
- ingress.template.yml
- service.template.yml
No caso, o único arquivo a ser atualizado seria o configmap.template.yml (variáveis de ambiente), o restante deles segue o mesmo padrão e conteúdo. Os arquivos devem ser criados na pasta k8s, em uma nova pasta com o nome do ambiente. Após isso, o script k8s-apply.sh deve ser executado passando qual o ambiente será atualizado com o deploy. Ex: k8s-apply.sh dev-eveo
Nos casos onde o ambiente kubernetes já existe e é necessário apenas atualizar o pacote, basta trocar o caminho do pacote pelo disponibilizado no registry.
