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

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

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:

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

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.

Anterior Como utilizar o Celery para paralelização de atividades em Python
Próxima Proteja seu e-mail contra spam e vírus com ferramentas open source

About author

Você pode gostar também

Infraestrutura TI

Maximize o poder do seu servidor com Hot-Plug no Linux

Dentro do Linux é possível realizar o hot-plug de CPU, mas o que é “hot-plug“? Hot-plug é um mecanismo de “troca de hardware à quente”, ou seja, enquanto o servidor ainda

Infraestrutura TI

Guia Prático: Aprenda a Manipular Dados no MongoDB

Dando continuidade na série de MongoDB, após construir um Cluster de MongoDB usando o passo a passo do desse artigo, vamos agora manipular os dados dentro desse banco, ou como

DevOps

Aprenda a criar módulos com Terraform na prática

Este seria o último capítulo da nossa série de postagens sobre Terraform, mas se podemos também falar sobre versionamento de infraestrutura, acho que vale a pena no aprofundarmos em mais