Atualização de versão
# Como atualizar o Interactive Intelligence (on-premise)
Oct 15, 2026 · @Danilo
## Visão geral e pré-requisitos
A atualização baixa as imagens mais recentes do II no registro da Selbetti e recria os containers, preservando dados e configurações. O II fica indisponível por alguns minutos durante a recriação, então programe uma janela de manutenção.
Antes de começar, confirme:
- Acesso ao servidor com permissão para executar comandos Docker (usuário no grupo `docker` ou com `sudo`).
- Docker Compose v2 instalado (comando `docker compose`, sem hífen). Verifique com `docker compose version`.
- Usuário e senha do registro `selbii.azurecr.io`, fornecidos pela Selbetti. Se não os tiver, solicite pelo [portal de suporte](https://md2net.tomticket.com/helpdesk).
- Espaço livre em disco para as novas imagens e para o backup do banco de dados.
- Terminal aberto no diretório de instalação do II, onde ficam o `docker-compose.yml` e o `.env`. Todos os comandos deste guia partem desse diretório.
Os serviços do II usam *profiles* do Docker Compose (`backend`, `frontend` e `db`). Sem eles, o Compose ignora os serviços. Defina os profiles uma vez na sessão do terminal, antes de qualquer outro comando:
```bash
export COMPOSE_PROFILES=backend,frontend,db
```
Se a sua instalação usa apenas parte dos serviços (por exemplo, banco de dados externo), mantenha somente os profiles em uso.
## 1. Antes de começar: backup
Faça os três passos abaixo antes de toda atualização. Eles permitem voltar à versão anterior caso algo dê errado.
1. **Backup do banco de dados.** Substitua `<usuario>` pelo valor da variável `POSTGRES_USER` do arquivo `.env`:
```bash
docker compose exec -T db pg_dump -U <usuario> -d qm3_api -Fc > backup_ii_$(date +%Y%m%d_%H%M).dump
```
Confira se o arquivo foi gerado e não está vazio com `ls -lh backup_ii_*.dump`.
2. **Backup dos arquivos de configuração:**
```bash
tar czf config_ii_$(date +%Y%m%d_%H%M).tar.gz docker-compose.yml .env postgresql.conf keystore.p12 autenticacao-speech-to-text-google.json database-init
```
Esse pacote contém senhas e certificados. Guarde-o em local seguro, com acesso restrito.
3. **Marcação das imagens atuais para rollback.** O comando cria uma cópia local (tag `-anterior`) de cada imagem em uso:
```bash
for img in backend frontend db-pg15; do
docker tag selbii.azurecr.io/md2ii-app:${img}-latest selbii.azurecr.io/md2ii-app:${img}-anterior
done
```
## 2. Atualizar o II
1. **Autentique-se no registro da Selbetti** e informe o usuário e a senha quando solicitado:
```bash
docker login selbii.azurecr.io
```
2. **Baixe as novas imagens:**
```bash
docker compose pull
```
O comando deve listar o download de `back-intelligence`, `front-intelligence` e `db`.
3. **Recrie os containers com as novas imagens:**
```bash
docker compose up -d
```
O Compose recria apenas os containers cuja imagem mudou. Os dados do banco, em `./postgres`, são preservados.
4. **Encerre a sessão no registro** (recomendado):
```bash
docker logout selbii.azurecr.io
```
Na primeira subida após a atualização, o back-end aplica automaticamente as migrações do banco de dados e pode levar alguns minutos a mais para ficar disponível. Não interrompa os containers nesse intervalo.
Os scripts da pasta `database-init` rodam somente na criação inicial do banco. Não é necessário alterá-los nem executá-los durante uma atualização.
## 3. Validar a atualização
1. **Verifique o estado dos containers:**
```bash
docker compose ps
```
Os três serviços devem aparecer como `running` (ou `Up`). Um serviço em `Restarting` indica falha na inicialização.
2. **Confira os logs do back-end** em busca de erros na inicialização:
```bash
docker compose logs --tail 200 back-intelligence
```
Para acompanhar em tempo real, use `docker compose logs -f back-intelligence` e encerre com `Ctrl+C`.
3. **Teste pelo navegador:** acesse o II no endereço habitual (por padrão, porta `4200` do servidor), confirme a nova versão exibida na tela de login, faça login, abra um chat e envie uma pergunta. A versão também aparece no topo da página após o login.
Se algum desses passos falhar e o problema não for resolvido em poucos minutos, faça o rollback (seção 4) e abra um chamado.
## 4. Voltar à versão anterior (rollback)
O rollback usa as imagens marcadas com `-anterior` no passo 3 do backup. Não execute `docker compose pull` durante o rollback, pois ele sobrescreveria as imagens restauradas.
1. **Restaure as imagens anteriores e recrie os containers:**
```bash
for img in backend frontend db-pg15; do
docker tag selbii.azurecr.io/md2ii-app:${img}-anterior selbii.azurecr.io/md2ii-app:${img}-latest
done
docker compose up -d
```
2. **Valide** seguindo a seção 3.
3. **Restaure o banco somente se necessário**, quando a versão anterior não funcionar com o banco atual (as migrações aplicadas automaticamente pela nova versão podem ser incompatíveis com a anterior). Recomendamos abrir um chamado antes deste passo:
```bash
docker compose stop back-intelligence front-intelligence
docker compose exec -T db pg_restore -U <usuario> -d qm3_api --clean --if-exists < backup_ii_AAAAMMDD_HHMM.dump
docker compose start back-intelligence front-intelligence
```
Substitua o nome do arquivo pelo backup gerado antes da atualização. Dados registrados após a atualização serão perdidos.
## 5. Limpeza, problemas comuns e suporte
Mantenha as imagens `-anterior` por alguns dias após a atualização. Quando a nova versão estiver estável, libere espaço em disco:
```bash
for img in backend frontend db-pg15; do
docker rmi selbii.azurecr.io/md2ii-app:${img}-anterior
done
docker image prune -f
```
| Sintoma | Causa provável | O que fazer |
| --- | --- | --- |
| `docker compose pull` não baixa nada ou retorna `no service selected` | Profiles não definidos na sessão | Execute `export COMPOSE_PROFILES=backend,frontend,db` e repita o comando |
| `unauthorized` ou `authentication required` no download | Sessão não autenticada ou credencial expirada | Execute `docker login selbii.azurecr.io`; se persistir, solicite nova credencial ao suporte |
| `docker-compose: command not found` ou erro de sintaxe no Compose | Docker Compose v1 instalado | Instale o plugin Docker Compose v2 e use `docker compose` |
| Container em `Restarting` após a atualização | Falha na inicialização do serviço | Verifique `docker compose logs <serviço>`; se não resolver, faça o rollback |
Para abrir um chamado, acesse o [portal de suporte do II](https://md2net.tomticket.com/helpdesk) e anexe os logs gerados com:
```bash
docker compose logs --tail 1000 > logs_ii_$(date +%Y%m%d_%H%M).txt
```