Imagine que você trabalha com uma equipe de TI de pelo menos cinco pessoas. E por se tratar de um ambiente que está constantemente evoluindo, que é o ambiente de TI, todos tem que absorver rápido o conhecimento base da empresa. Por exemplo: quantas sub-redes, quantos Firewalls, Gateways, endereços dos Servidores de Arquivos, Regras de seguranças tem na empresa. Então, precisamos de algo para gerenciar o conhecimento, e para isso existem vários softwares. Existe o Microsoft TeamsAtlassian ConfluenceZoho Desk, e o BookStack. Esse é um nicho de mercado sério.

A maioria dos sistemas acima custam no mínimo $10 por agente. Já o BookStack é Free and Open Source. É muito difícil juntar um grupo de entusiastas para se dedicarem a um projeto e desenvolver algo realmente bom. Sim, BookStack é bom e tem todas as funcionalidades básicas para ser implantado em um ambiente empresarial, pois permite não somente o gerenciamento do conhecimento mas também a criação de qualquer tipo de diagrama, principalmente diagramas de redes de computadores, que foi o que mais me impressionou nesta ferramenta.

Então sem mais delongas, vamos para a instalação. Para este Lab vou utilizar uma máquina simples da DigitalOcean com Ubuntu Server 18.04 LTS.

Preparando o ambiente

A instalação do BookStack é muito fácil, porém a preparação básica do servidor não está disponível do site deles. Somente os requerimentos. E baseado nesses requerimentos, segue abaixo a instalação básica de pacotes para poder hospedar o BookStack.

Atualizando o Ubuntu Server

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

Instalando o Apache

sudo apt install apache2 apache2-utils -y

Instalando o PHP com as extensões necessárias

sudo apt install php php-common php-gd php-curl php-mbstring php-json php-mysql php-xml php-zip php-tidy -y

Instalando o Sistema de Gerenciamento de Banco de Dados

sudo apt install mysql-server -y

Instalando o gerenciador de pacotes PHP

sudo apt install composer -y

Instalando pacotes adicionais necessários

sudo apt install wget git unzip -y

Instalando o BookStack

Agora que temos os pacotes básicos instalados, vamos fazer a instalação do BookStack.

Download o script de instalação do BookStack

wget https://raw.githubusercontent.com/BookStackApp/devops/master/scripts/installation-ubuntu-18.04.sh

Permita que o mesmo seja executado 

chmod +x installation-ubuntu-18.04.sh

Execute o script de instalação

sudo ./installation-ubuntu-18.04.sh

Acessando o BookStack

Ao final da execução do script installation-ubuntu-18.04.sh será exibida todas as informações necessárias para que possamos acessar o sistema. Mas caso você não tenha visto, segue as informações abaixo:

  • Endereço: Digite o IP do servidor no seu navegador
  • Usuário padrão[email protected]
  • Senha: password

Segurança 

A primeira coisa que você deve fazer após finalizar a instalação é trocar a senha de administração, e para isso uma vez logado, clique em Settings no lado direito superior, depois em Users.

Para melhor a segurança é importante implementar HTTPs, habilitar e configurar o firewall, restringir a criação de contas por domínio e usar o método de confirmação de contas por e-mail ou sincronizar com o Active Directory por exemplo. Também é possível usar redes sociais como forma de autenticação.

Então é isso. Qualquer dúvida deixem nos comentários. Ficarei feliz de explorar mais as possibilidade dessa ferramenta juntos com vocês. Até o próximo tutorial. 😉

Categorized in: