Skip to content

OTOBO Sistema de Tickets com Docker

Introdução ao OTOBO com Docker

O uso do Docker com OTOBO oferece um método flexível e eficiente para operar o sistema de tickets em um ambiente isolado. Este guia aborda os passos básicos para a instalação e gerenciamento do OTOBO com Docker.

Principais Diferenças entre OTOBO e Znuny

Existem diferenças importantes em relação ao Docker entre OTOBO e Znuny: Diferenças entre Znuny e OTOBO

Instalação com Docker

A instalação do helpdesk OTOBO pode ser feita diretamente ou através do Docker. O Docker permite uma configuração rápida e garante alta consistência e isolamento do ambiente através da containerização.

Contêineres Docker no OTOBO

Em um ambiente Docker, o OTOBO geralmente é executado distribuído por vários contêineres:

  1. otobo_web_1: O servidor web.
  2. otobo_redis_1: Cache para melhoria de performance.
  3. otobo_db_1: O banco de dados (MariaDB).
  4. otobo_daemon_1: Serviços de background para o OTOBO.
  5. otobo_elastic_1: Elasticsearch para busca de texto completo.
  6. otobo_nginx_1 (opcional): Nginx como proxy reverso para conexões HTTPS.

O que são Contêineres Docker?

Contêineres Docker funcionam como máquinas virtuais, mas são mais leves e compartilham o sistema operacional do host. Eles são isolados uns dos outros e conectados a volumes Docker, onde seus dados são armazenados.

Comandos Docker Essenciais para OTOBO

  • Iniciar serviço Docker: systemctl enable docker
  • Parar serviço Docker: systemctl stop docker
  • Exibir todos os contêineres em execução: docker ps
  • Iniciar um contêiner individual: docker start <container-name>
  • Parar um contêiner individual: docker stop <container-name>

Executando Comandos Docker do OTOBO

Para executar comandos específicos do OTOBO dentro de um contêiner Docker, acesse o contêiner otobo_web_1 com um terminal interativo:

bash
docker exec -it otobo_web_1 bash

Dentro deste contêiner, você pode então executar comandos do OTOBO para realizar várias tarefas administrativas e de manutenção.

Executando Funções dentro do Contêiner Docker

O uso do OTOBO dentro de um contêiner Docker abre a possibilidade de executar uma variedade de comandos diretamente, que simplificam o gerenciamento e a manutenção do OTOBO. Aqui está uma visão geral de alguns dos comandos disponíveis:

Comandos do Console OTOBO

O núcleo da interface de linha de comando (CLI) do OTOBO é otobo.Console.pl, uma ferramenta poderosa que pode ser usada para realizar tarefas administrativas diretamente da linha de comando. Alguns dos usos mais comuns incluem:

  • Help: Exibe ajuda para comandos existentes.
  • List: Lista comandos disponíveis.
  • Search: Procura por comandos.

Comandos de Admin do OTOBO

Comandos específicos de admin permitem controlar diretamente vários aspectos do OTOBO, como:

  • Admin::Config::Update: Atualiza o valor de uma configuração.
  • Admin::Package::Install: Instala um pacote OTOBO.
  • Admin::User::Add: Adiciona um agente.

Ferramentas de Desenvolvimento OTOBO

Para desenvolvedores, há uma série de comandos para auxiliar no desenvolvimento e testes:

  • Dev::Code::Generate::ConsoleCommand: Gera um esqueleto para um comando de console.
  • Dev::Tools::CacheBenchmark: Executa um benchmark nos backends de cache disponíveis.

Comandos de Manutenção para OTOBO

Para a manutenção e cuidado do OTOBO, os seguintes comandos podem ser usados:

  • Maint::Cache::Delete: Exclui arquivos de cache criados pelo OTOBO.
  • Maint::Config::Rebuild: Reconstrói a configuração do sistema do OTOBO.
Ferramentas de Desenvolvimento e Manutenção

Além das tarefas administrativas, o OTOBO também suporta comandos específicos para desenvolvedores e para manutenção do sistema:

  • Dev::Package::Build: Cria um arquivo de pacote OTOBO (opm) a partir de uma fonte de pacote OTOBO (sopm).
  • Maint::Log::Clear: Limpa o log do OTOBO.

Esses comandos auxiliam os desenvolvedores na criação e gerenciamento de seus módulos OTOBO e ajudam os administradores de sistema na manutenção do sistema.

Migração e Atualizações

Para migração de OTRS para OTOBO ou atualização de versões do OTOBO, comandos especiais são úteis:

  • Dev::Tools::Migrate::OTRSToOTOBO: Cria arquivos de origem OTOBO limpos a partir do código-fonte OTRS ou de um pacote OTRS OPM.
  • Admin::Package::UpgradeAll: Atualiza todos os pacotes OTOBO para as versões mais recentes dos repositórios online.

Esses comandos facilitam a transição para o OTOBO e garantem que seu sistema esteja sempre atualizado.

O uso desses comandos dentro do contêiner Docker do OTOBO oferece a administradores e desenvolvedores uma maneira flexível e poderosa de gerenciar, personalizar e estender sua instalação do OTOBO.

Comandos Docker Adicionais

Abaixo estão outros comandos Docker úteis que podem ser úteis para gerenciar o sistema de tickets OTOBO:

  • Exibir logs do contêiner: Para ver os logs de um contêiner específico, use docker logs <container-name>. Isso pode ser especialmente útil para diagnosticar problemas.

  • Exibir lista de contêineres: Para ver todos os contêineres (em execução e parados), use docker ps -a.

  • Exibir imagens Docker: Com docker images, você pode ver todas as imagens Docker disponíveis em seu sistema.

  • Criar volume Docker: Volumes são o mecanismo preferido para a persistência de dados gerados e utilizados por contêineres Docker. Crie um volume com docker volume create <volume-name>.

  • Exibir redes Docker: Com docker network ls, você obtém uma lista de todas as redes Docker em seu sistema.