## Antes de tudo certifique-se de estar usando o S3 para armazenar os seus arquivos. Não é obrigatório ter o S3 para usar o Kanban mas adiciona uma camada a mais de resiliência aos dados.
Dito isso, vamos lá:
1. Em primeiro lugar, pause a stack do seu Chatwoot atual.
2. Após pausar a stack, navegue até a página “Volumesˮ do Portainer (se estiver usando EasyPanel não é
necessário excluir os volumes) e exclua todos os volumes (exceto chatwoot_data ou chatwoot_storage,
dependendo da instalação) - dicas no final do tutorial.
Uma vez a stack pausada e os volumes removidos, agora é a hora de fazer as alterações que vão
colocar o Kanban para funcionar.
**Não excluir o volume chatwoot_storage (ou chatwoot_data) se não estiver usando o S3. Isso causa perda de arquivos das conversas.**
3. No trecho “enviromentˮ da stack do seu Chatwoot, adicione uma nova variável chamada “**STACKLAB_TOKENˮ** e insira o token que você recebeu via Whatsapp e E-mail na hora da compra do Kanban.
4. Após adicionar o token, altere as imagens dos dois serviços, app e Sidekiq, para usar a imagem do kanban: `stacklabdigital/kanban:latest`
5. Clique em “*Prune Servicesˮ* e logo após em “*Redeployˮ*.
Espere o serviço **chatwoot_app** estar com o status “*runningˮ* e quando estiver, siga os próximos passos para migrar o banco de dados para a nova versão.
6. No **Portainer**, na linha onde aparece o serviço **chatwoot_app**, clique em “*Consoleˮ*.
7. Na tela de conexão ao *console* selecione “*shˮ* e mantenha o usuário como “*rootˮ* mesmo.
8. Rode o comando para migrar o banco de dados e aplicar as alterações necessárias para o
funcionamento do **Kanban para Chatwoot**: `bundle exec rails db:migrate` - **veja alguns comandos para gerenciar o banco de dados no fim do post.**
Pronto, seu **Kanban para Chatwoot** está instalado! O processo de atualização é exatamente o mesmo.
## Dicas Bônus
**Porque é importante usar o S3 no Chatwoot?**
Quando armazenamos os nossos arquivos direto no armazenamento local do Chatwoot ficamos refém do servidor em que as imagens e arquivos estão hospedados ficar indisponível, sofrer gargalos que afetam a integridade dos demais serviços, corromper informações e uma série de outros fatores. O armazenamento S3 é um protocolo especializado para guardar arquivos com segurança e performance além de permitir que seu Chatwoot tenha um serviço robusto que servirá as imagens para sua aplicação.
Saiba mais sobre o protocolo S3:
## Alguns dos bugs mais comuns de ocorrer no processo de instalação e atualização:
* *“Mudei a imagem dos dois serviços mas não aparece a opção de Kanban no Chatwoot.ˮ*
Isso geralmente ocorre quando antes de fazer o *redeploy,* os volumes não são apagados. Limpe os volumes e faça o redeploy pra que as modificações sejam aplicadas.
* *“Atualizei o Kanban para Chatwoot e apareceu “rejectedˮ no containerˮ*
Esse erro é causado 90% das vezes pelo nome errado da imagem. Certifique-se se estar usando a versão mais atualizada com o nome correto da imagem: **stacklabdigital/kanban:latest**
## Docker Hub com tags atualizadas:
## Comandos uteis para gerenciar o banco de dados do Chatwoot
* ***bundle exec rails db:migrate***
Aplica as migrations pendentes no seu banco de dados atual após uma atualização.
* ***bundle exec rails db:rollback***
Desfaz a última migration (1 step). Útil em caso de erros.
* ***bundle exec rails db:rollback STEP=3***
Desfaz as últimas 3 migrations.
* ***bundle exec rails db:migrate:status***
Mostra o status das migrations (aplicadas ou não).
* ***bundle exec rails db:seed***
Executa o arquivo db/seeds.rb.
* ***bundle exec rails db:reset***
Dropa, cria, migra e roda seeds no banco (**cuidado: apaga os dados!**).