---
title: Manual de Atualização de Versão
slug: citbot/manual-de-atualizacao-de-versao
docTags: 
createdAt: 2024-08-28T13:21:26.059Z
---

Este manual fornece instruções detalhadas para a atualização de versão do sistema, abrangendo todas as etapas necessárias para garantir uma transição suave.

Para realizar a atualização, siga os passos abaixo:

## Identificação do Sistema:

Primeiro, identifique onde o sistema está instalado. Isso é crucial para acessar os componentes corretos e realizar as alterações necessárias.

## Identificação das Tags de Imagens Docker:

Identifique as tags de imagens Docker relacionadas ao sistema, incluindo as que serão atualizadas. As versões das imagens podem ser verificadas no site oficial da documentação (https\://citbot-api.centralit.com.br/docs). Consulte a seção correspondente para visualizar as versões disponíveis e compare com as atualmente em uso.

## Backup da Base de Dados:

Antes de realizar qualquer atualização, é fundamental realizar um backup completo da base de dados. Isso garante que todos os dados possam ser restaurados em caso de qualquer problema durante o processo de atualização.

## Atualização das Imagens:

Altere as imagens Docker para as últimas versões disponíveis. As imagens que devem ser atualizadas são:

- API: ghcr.io/centralit-governanca-corporativa/citbot/api\:X.X.X
- Frontend: ghcr.io/centralit-governanca-corporativa/citbot/front- prod\:X.X.X
- Schedule-API: ghcr.io/centralit-governanca-corporativa/citbot/api\:X.X.X

O processo de atualização deve começar pela Schedule-API, para verificar se as migrations foram executadas com sucesso. Essa etapa é crucial para assegurar que o esquema do banco de dados esteja atualizado antes de prosseguir com as outras partes do sistema.

## Verificação das Migrations:

Este manual fornece instruções detalhadas para a atualização de versão do sistema, abrangendo todas as etapas necessárias para garantir uma transição suave.

Para realizar a atualização, siga os passos abaixo:

## Identificação do Sistema:

Primeiro, identifique onde o sistema está instalado. Isso é crucial para acessar os componentes corretos e realizar as alterações necessárias.

## Identificação das Tags de Imagens Docker:

Identifique as tags de imagens Docker relacionadas ao sistema, incluindo as que serão atualizadas. As versões das imagens podem ser verificadas no site oficial da documentação (https\://citbot-api.centralit.com.br/docs). Consulte a versão correspondente, conforme imagem abaixo e compare com as atualmente em uso.


![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/tmOSeSYpZdBmLV_sgQkPt_image.png)

## Backup da Base de Dados:

Antes de realizar qualquer atualização, é fundamental realizar um backup completo da base de dados. Isso garante que todos os dados possam ser restaurados em caso de qualquer problema durante o processo de atualização.

## Atualização das Imagens:

Altere as imagens Docker para as últimas versões disponíveis. As imagens que devem ser atualizadas são:

- Schedule-API:
- ghcr.io/centralit-governanca-corporativa/citbot/api\:X.X.X
- API: ghcr.io/centralit-governanca-corporativa/citbot/api\:X.X.X
- Frontend: ghcr.io/centralit-governanca-corporativa/citbot/front- prod\:X.X.X

O processo de atualização deve começar pela Schedule-API, para verificar se as migrations foram executadas com sucesso. Essa etapa é crucial para assegurar que o esquema do banco de dados esteja atualizado antes de prosseguir com as outras partes do sistema.

## Verificação das Migrations:

Após atualizar a imagem da Schedule-API, verifique a execução das migrations. As migrations devem ser confirmadas como bem-sucedidas para garantir a integridade dos dados e a compatibilidade com as novas versões da aplicação.

## Testes:

Após todas as etapas anteriores, execute uma bateria de testes para garantir que o sistema esteja funcionando corretamente com as novas atualizações. Verifique todas as funcionalidades principais e qualquer nova funcionalidade introduzida.

# Procedimento de Rollback

Se houver necessidade de reverter a atualização, siga os passos abaixo:

## Restauração da Base de Dados:

Utilize o backup realizado antes da atualização para restaurar a base de dados para o estado anterior.

## Retorno das Tags de Imagens:

Retorne as tags das imagens Docker para a versão anterior, conforme necessário. Isso restaurará o sistema para o estado anterior à atualização.

Flags de Configuração

As feature flags são utilizadas para controlar funcionalidades específicas da aplicação CITBot. Abaixo estão listadas as feature flags disponíveis, juntamente com suas respectivas descrições:

**TIMEOUT\_ENABLE:**

Controla o timeout para encerrar conversas de chatbot.

**LUA\_PIPELINE\_ENABLED:**

Ativa ou desativa o uso da pipeline desenvolvida em Lua.

**MASKING\_ENABLED:**

Habilita ou desabilita a proteção de informações sensíveis.

**FILEMANAGER\_ENABLED:**

Ativa ou desativa a funcionalidade de gerenciador de arquivos.

**COQUINHO\_ENABLE:**

Controla a funcionalidade de conversão de texto para fala (TTS).

**SENTIMENT\_ANALYSIS:**

Habilita ou desabilita a funcionalidade de análise de sentimento.

**WHISPER\_ENABLED:**

Ativa ou desativa a funcionalidade de reconhecimento de fala (STT).

**ENABLE\_SCHEDULES:**

Habilita ou desabilita a execução de schedules na aplicação, especialmente para o deployment de Schedule-API.

**RUN\_MIGRATIONS:**

Controla a execução de migrations de banco de dados, especialmente para o deployment de Schedule-API.

Este manual deve ser seguido rigorosamente para garantir que a atualização ocorra sem problemas e que, em caso de necessidade, o rollback possa ser realizado de forma eficiente.

Após atualizar a imagem da Schedule-API, verifique a execução das migrations. As migrations devem ser confirmadas como bem-sucedidas para garantir a integridade dos dados e a compatibilidade com as novas versões da aplicação.