Guia Prático: Como Implementar uma Wiki em Ambiente Corporativo

Em ambientes corporativos, onde vários projetos são elaborados, algumas informações são muito importantes e muito específicas aos diretamente envolvidos, como configurações de ambiente e opções dos parâmetros. Neste contexto, a utilização de uma Wiki para armazenar estas informações é uma solução extremamente prática, devido a sua facilidade de uso. Este artigo irá apresentar os passos para a implantação de uma wiki em um ambiente corporativo, desde a escolha de um software Open Source até a configuração de extensões.

Escolha da Wiki

Atualmente, no mercado , existem várias Wikis Open Source no mercado, com várias features diferentes para cada domínio. Dessa forma, foi elaborada uma pequisa para obter os melhores projetos mantidos pela comunidade atualmente. A partir dos softwares encontrados, um será escolhido para  organizar os projetos internos da 4linux na Caixa Econômica Federal.

Dessa forma, foi feita uma pesquisa na comunidade OSS brasileira e em alguns sites especializados em projetos deste mesmo segmento. As Wikis encontradas para a seleção foram as seguintes:

• Media Wiki
• MoinMoin
• xWiki
• Dokuwiki

Para todas essas opções, foram avaliados pontos pontos importantes para o uso dentro do ambiente corporativo. A seguir estão os pontos utilizados:

1. Alta Manutenibilidade do Software
2. Alta Usabilidade
3. Comunidade Ativa
4. Agradável ao Usuário
5. Portabilidade para Imagens
6. Portabilidade para Documentos e Arquivos
7. Extensível com Sistema de Modularização

Assim, todos estes pontos foram avaliados e a alternativa que mais se enquadrou nestes padrões foi a xWiki, com bom suporte e plataforma operante com sistema de plugins.

Instalação da xWiki

Para a execução da Instalação do fork da xWiki no ambiente corporativo, foram utilizadas algumas ferramentas que auxiliam neste processo. Elas foram: docker e mysql.  Assim, primeiramente será apresentada a instalação  do docker, logo em seguida serão apresentados os procedimentos para iniciar o container.

 Instalando Docker

Primeiro passo e desabilitar toda e qualquer instalação do docker na máquina:

$ sudo apt-get remove docker docker-engine docker.io

Logo em seguida deve-se instalar bibliotecas de apoio à virtualização.

$ sudo apt-get update

$ sudo apt-get install \
    linux-image-extra-$(uname -r) \
    linux-image-extra-virtual

Para a utilização dos repositórios devem ser instaladas algumas libs que não são nativas no sistema operacional. Elas são as seguintes:

$ sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

Adicione a chave GPG oficial do Docker:

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Agora com a chave adicionada, o repositório pode ser linkado ao sistema.

$ sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"

Por fim, a lista de repositórios já pode ser alterada e o pacote do Docker Community Edition poderá ser instalado.

$ sudo apt-get update

$ sudo apt-get install docker-ce

Agora o docker já está instalado.

Instalação Usando Docker Run

Vamos começar com a criação de uma rede dedicada para a wiki.

$ docker network create -d bridge xwiki-nw

Para armazenamento dos dados, iremos utilizar o mysql, dessa maneira, vamos iniciar um container para prover este serviço.

$ docker run --net=xwiki-nw --name mysql-xwiki -v /my/own/mysql:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=xwiki -e MYSQL_USER=xwiki -e MYSQL_PASSWORD=xwiki -e MYSQL_DATABASE=xwiki -d mysql:5.7 --character-set-server=utf8 --collation-server=utf8_bin --explicit-defaults-for-timestamp=1

Por fim, será criado um container do projeto para servir na porta 8080.

$ docker run --net=xwiki-nw --name xwiki -p 8080:8080 -v /my/own/xwiki:/usr/local/xwiki -e DB_USER=xwiki -e DB_PASSWORD=xwiki -e DB_DATABASE=xwiki -e DB_HOST=mysql-xwiki xwiki:mysql-tomcat

Configuração da Wiki

O software da wiki por padrão não possui muitas funcionalidades interessantes para a nossa utilização em ambiente corporativo. Sendo assim, algumas extensões devem ser  acopladas. A primeira delas é o painel administrativo.

Para a sua instalação, o pacote deve ser baixado no repositório oficial utilizando este link: Administration Application. Logo após ele deve ser  importado no sistema.

Quanto as demais extensões, elas foram instaladas através do painel administrativo e as seguintes foram instaladas:

[wc_row]

[wc_column size=”one-half” position=”first”]

• Watchlist Application 8.4.5
• Wiki Application 8.4.5
• Ratings Application 7.4
• Editor Tools – Highlighting – UI – Code 3.4
• Markdown Syntax 1.0 8.4.3
• Wiki Macro Application 8.4.5
• XWiki Platform – Wiki – UI – Common 8.4.5
• XWiki Platform – Notifications – UI 8.4.5
• XWiki Platform – Panels – UI 8.4.5
• Share Page Application 8.4.5
• ASM Tree 5.0.3
• CKEditor Plugins for XWiki 1.15
• Application Index Application 8.4.5
• Help Application 8.4.5
• User Directory Application 8.4.5
• Extension Manager Application 8.4.5
• Skin Application 8.4.5
• Dashboard Application 8.4.5
• XWiki Flavor 8.4.5
• XWiki Platform – Livetable – UI 8.4.5
• Markdown Syntax 1.1 8.4.3

[/wc_column]

[wc_column size=”one-half” position=”last”]

• Tour Application 1.1
• Logging Application 8.4.5
• pegdown 1.4.1
• CodeMirror 5.8
• ASM Core 5.0.4
• XWiki Platform – Scheduler – UI 8.4.5
• Font Awesome Icon Theme 8.4.5
• Icon Theme Application 8.4.5
• XClass Application 8.4.5
• CKEditor Integration 1.15
• XWiki Platform – Invitation – UI 8.4.5
• Bootstrap Tour 0.11.0
• XWiki Enterprise – UI – Common 8.4.5
• Document Tree Macro 8.4.5
• XWiki Enterprise – UI – Tour 8.4.5
• Solr Search Application 8.4.5
• XWiki Platform – LinkChecker – UI 8.4.5
• ASM Analysis 5.0.3
• Bootswatch Themes for Flamingo 8.4.5

[/wc_column]

[/wc_row]

Considerações Finais

Dessa forma, foi possível perceber a simplicidade em implantar a xWiki, atestando os requisitos propostos para a escolha da aplicação. Assim foi executada a instalação e a configuração das extensões com sucesso.