Atualização OTOBO Docker – Atualize sua versão com segurança

Um upgrade regular da sua instalação OTOBO garante que você possa aproveitar novos recursos, patches de segurança e correções de bugs imediatamente. Este guia explica como atualizar uma instância OTOBO baseada em Docker para a versão desejada em apenas algumas etapas.

Pré-requisitos

• Uma instalação OTOBO existente com Docker & Docker Compose
• Acesso SSH ao host
• 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

Etapa 1: Atualizar a configuração Docker Compose

1. Navegue até o diretório do seu projeto OTOBO Docker:

   cd /opt/otobo-docker

2. Busque novas tags 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 .env, por exemplo:

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

Etapa 2: Obter novas imagens Docker

docker-compose pull

Etapa 3: Parar e atualizar contêineres

1. Pare os contêineres antigos (os volumes serão mantidos):

   docker-compose down

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

   docker-compose run --rm web copy_otobo_next

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

   docker-compose up -d

Etapa 4: Realizar 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

Etapa 5: Conclusão e Verificação

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

Versões OTOBO disponíveis

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

• 11.0.10: Oferece melhorias internas e tags Docker atualizadas 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 pesquisa de tickets.
• 11.0.8: Algoritmos de hashing de senha reforçados e autenticação de dois fatores aprimorada.
• 11.0.7: Várias correções de bugs, incluindo correções na exibição de caixas de seleção e links de artigos.
• 11.0.6: Importantes atualizações de segurança contra injeção de JavaScript e transição para CKEditor 5.
• 11.0.5: Otimizações de layout para CKEditor 5 e tradução aprimorada de serviços.
• 11.0.4: Sistema de tradução expandido e scripts Docker Quickstart otimizados.
• 11.0.3: Corrige erros de banco de dados na 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: Novos recursos de campo dinâmico e um skin de alto contraste para melhor acessibilidade.
• 11.0.0‑beta3: Transição para HTML::Scrubber para um comportamento Safety() mais seguro.
• 11.0.0‑beta2: Campos de referência dinâmicos refinados 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: Exibição de calendário aprimorada e tratamento mais estável do Elasticsearch.
• 10.1.6: Corrige injeção de SQL em TicketSearch e otimiza notificações de agendamento.
• 10.1.5: Previne 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: Previne chamadas do lado do servidor na interface de administração e corrige falhas de XSS.
• 10.1.2: Correções de bugs no módulo DynamicFieldDatabase para uma pesquisa consistente.
• 10.1.1: Dashboard de cliente expandido e autocura aprimorada do Elasticsearch.

Observação: Para saltos de versão principal (por exemplo, 10.1 → 11.0), sempre execute primeiro o upgrade secundário (10.1) e depois o upgrade principal (11.0).