Atualização OTOBO Docker – Atualizar versão com segurança

Atualizar regularmente a sua instalação OTOBO garante que você possa aproveitar imediatamente novos recursos, correções de segurança e correções de erros. Este guia explica como atualizar uma instância OTOBO baseada em Docker para a versão desejada em poucos passos.

Pré-requisitos

• Uma instalação OTOBO existente com Docker e Docker Compose
• Acesso SSH ao servidor
• Backup dos seus dados importantes (volumes Docker para /opt/otobo, banco de dados, índice Elasticsearch)
• Versão de destino desejada, por exemplo, 11.0.10 ou 10.1.8

Passo 1: Atualizar a configuração do Docker Compose

1. Acesse o diretório do seu projeto OTOBO Docker:

   cd /opt/otobo-docker

2. Obtenha as novas tags do Git e mude para a versão desejada:

   git fetch --tags
   git checkout rel-11_0_10    # Exemplo para a versão 11.0.10

3. Se necessário, ajuste seu arquivo .env, por exemplo:

   OTOBO_IMAGE=rotheross/otobo:11.0.10
   OTOBO_IMAGE_ELASTICSEARCH=elasticsearch:8.8.2
   OTOBO_IMAGE_NGINX=nginx:1.23-alpine

Passo 2: Baixar as novas imagens Docker

docker-compose pull

Passo 3: Parar e atualizar os contêineres

1. Pare os contêineres antigos (os volumes permanecem intactos):

   docker-compose down

2. Migrar o volume de código para a nova versão:

   docker-compose run --rm web copy_otobo_next

3. Iniciar os contêineres com o novo software:

   docker-compose up -d

Passo 4: Executar a atualização interna do OTOBO

1. Execute as tarefas de atualização:

   docker-compose exec web entrypoint.sh do_update_tasks

2. Opcional: Script de migração do banco de dados para versões principais (por exemplo, 10.1 → 11.0):

   docker exec -it otobo_web_1 perl scripts/DBUpdate-to-11.0.pl

3. Verifique o log de atualização:

   docker-compose exec web cat /opt/otobo/var/log/update.log

Passo 5: Conclusão e verificação

• Verifique o status: docker-compose ps mostra se todos os contêineres estão em execução
• Teste o login: Certifique-se de que agentes e clientes conseguem fazer login
• Teste rápido: Crie um ticket, envie e-mails e verifique as funções principais

Versões OTOBO disponíveis

Versões principais e secundárias (seleção):

• 11.0.10: Oferece melhorias internas e atualizações de tags Docker para implantações estáveis.
• 11.0.9: Corrige uma vulnerabilidade de segurança crítica (CVE-2025-43926) e otimiza o módulo de busca de tickets.
• 11.0.8: Algoritmos de hash de senha reforçados e autenticação de dois fatores aprimorada.
• 11.0.7: Diversas correções de bugs, incluindo exibição de caixas de seleção e links de artigos.
• 11.0.6: Atualizações de segurança importantes contra injeção de JavaScript e migração para CKEditor 5.
• 11.0.5: Otimizações de layout para CKEditor 5 e melhor tradução de serviços.
• 11.0.4: Sistema de tradução expandido e scripts Docker Quickstart otimizados.
• 11.0.3: Corrige erros no banco de dados durante a mesclagem de tickets e problemas com campos dinâmicos.
• 11.0.2: Carregamento automático de repositórios ITSM e melhor detecção de atualizações para pacotes principais.
• 11.0.1: Novas funções para campos dinâmicos e um tema de alto contraste para melhor acessibilidade.
• 11.0.0-beta3: Migração para HTML::Scrubber para comportamento mais seguro da função Safety().
• 11.0.0-beta2: Aperfeiçoamento de campos de referência dinâmica e integração de novos pacotes principais.
• 10.1.8: Correção de segurança para XSS em AdminCustomerUser e validação robusta de cabeçalhos HTTP.
• 10.1.7: Melhor exibição de calendário e tratamento mais estável do Elasticsearch.
• 10.1.6: Corrige uma injeção SQL em TicketSearch e otimiza notificações de compromissos.
• 10.1.5: Impede injeção de código em ACLs e atualiza bibliotecas JavaScript importantes.
• 10.1.4: Corrige falhas na sincronização LDAP e melhora atualizações em massa.
• 10.1.3: Impede chamadas do lado do servidor na interface de administração e corrige falhas XSS.
• 10.1.2: Correções de erros no módulo DynamicFieldDatabase para busca consistente.
• 10.1.1: Dashboard de cliente expandido e autorecuperação aprimorada do Elasticsearch.

Observação: Para saltos entre versões principais (por exemplo, 10.1 → 11.0), sempre realize primeiro uma atualização secundária (10.1) e depois a principal (11.0).