Suporte

Manual de Instalação Agility

Pré-requisitos para instalação

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).

Ferramentas

  • 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

Passos para instalação do Agility:

  • Clonar o repositório do hyper-kanban-api
git clone http://gitlab.centralit.io/centralit/hyper-platform/hyper-kanban-api.git
  • Entrar na pasta onde o projeto foi clonado e fazer checkout da branch devel
git checkout devel
  • Executar Step 1. Migrations
  • Executar Step 2. Deploy

Passo 1. Migrations

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.

Arquivo migrations-config.json

O arquivo deve seguir a estrutra abaixo:

Document image


Onde os atributos de cada tenant que segue:

Document image


Exemplo

Exemplo de arquivo com dois tenants (run2biz e tenant1) para o ambiente desen aplicação hyper-kanban-api (esta aplicação).

Document image


Execução do script migrations.sh

Modo de uso

./migration.sh <nomeTenant> ...

Exemplo

./migration.sh run2biz tenant1

Passo 2. Deploy

Via gitlab CI

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

Document image


Manual via script kubectl

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

Document image


Atualizando direto no Rancher

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.

Document image