Publicado em

Como Instalar OpenProject no Synology

Scroll down to see more content
Site Oficial: https://www.openproject.org/

Aqui temos um passo-a-passo para instalar e executar o OpenProject no seu NAS da Synology. Caso queira, pode pular diretamente para as etapas, senão, continue lendo para mais detalhes.

Introdução

O OpenProject é um excelente gerenciador de projetos. Os recursos disponíveis na plataforma o torna em uma solução única para poder gerenciar e monitor projetos, junto com custos e orçamentos. Sua versão gratuita (Community Edition) é um pouco limitada do que a versão “Enterprise” logicamente, mas, não deixa de ser poderosa e suficiente para muitas empresas.

O importante, como em cada aplicativo, é aprender a tirar o maior aproveitamento possível das ferramentas disponíveis, e de certa forma, se adaptar a realidade das capacidades dela. Das opções disponíveis, o OpenProject é com certeza o melhor PMS (Project Management Software) de código aberto disponível para qualquer um instalar em seu sistema.

Instalação

Passo 1 – Criando as pastas

Crie uma pasta dentro da pasta compartilhada “Docker” e nomeie-a de “openproject”, em seguida crie mais duas pastas dentro da do openproject com os nomes de “assets” e “pgdata”:

Passo 2 – Baixando a imagem

Abra o Docker e clique em “Registro”. Procure por “openproject”, selecione a imagem “openproject/community” e clique para baixá-la. Talvez tenha que selecionar uma versão específica, no caso da data desse post, existe uma versão acima do 12 (12.0.2), mas para não ter erro com o script de instalação, achei melhor optar pela versão 12 mesmo.

Passo 3 – Organizando os parâmetros

A instalação exige que alguns parâmetros sejam definidos. Obtendo o script original temos o seguinte:

docker run -d -p 8080:80 --name openproject \
  -e SERVER_HOSTNAME=openproject.example.com \ # The public facing host name
  -e SECRET_KEY_BASE=secret \ # The secret key base used for cookies
  -v /var/lib/openproject/pgdata:/var/openproject/pgdata \
  -v /var/lib/openproject/assets:/var/openproject/assets \
  openproject/community:12

Vamos organizar o script acima e ajustar alguns parâmetros e modificando com os seus dados (dados em azul tem que corresponder ao seu sistema):

docker run -d --name openproject \
-p 4000:80 \
-e SERVER_HOSTNAME=openproject.my.synology.me \
-e SECRET_KEY_BASE= WieD54oEWKfdVK6i6iiQEEiQ8KxCjhmk \
-v /volume1/docker/openproject/pgdata:/var/openproject/pgdata \
-v /volume1/docker/openproject/assets:/var/openproject/assets \
openproject/community:12

O “SECRET_KEY” nada mais é que 32 caracteres aleatórios, composto de letras e números.

Passo 4 – Criando e executando a tarefa de instalação

Com a imagem já baixada no Passo 2, podemos agora abrir o “Painel de Controle” e entrar em “Programador de Tarefas”:

Em seguida selecione para “Criar > Tarefa agendada > Script definido pelo usuário”, siga os passos das imagens abaixo e insira o script de instalação (com seus valores reais).

Em seguida insira o código abaixo, lembrando que os itens em azul são apenas demonstrativos e devem ser substituídos pelos valores reais do seu sistema.

docker run -d --name openproject \
-p 4000:80 \
-e SERVER_HOSTNAME=openproject.my.synology.me \
-e SECRET_KEY_BASE= WieD54oEWKfdVK6i6iiQEEiQ8KxCjhmk \
-v /volume1/docker/openproject/pgdata:/var/openproject/pgdata \
-v /volume1/docker/openproject/assets:/var/openproject/assets \
openproject/community:12

O aviso abaixo irá aparecer antes de concluir a criação da tarefa. Apenas clique em “Ok” que estará tudo pronto.

Com a tarefa criada, podemos agora executá-la. Não esqueça que para que ela seja realmente processada ela tem que ser agendada para uma data futura, senão, não será executada visto que o tempo de sua ativação já passou.

A partir desse ponto a instalação em si está concluída. Abra o seu navegador e navegue para o endereço do seu contêiner http://ip-do-seu-synology:porta-local/ (do exemplo – http://192.161.1.1:4000/) e encontrará a seguinte página:

Agora terá que entrar com o usuário de administrador e em seguida começar a usar o aplicativo. Importante saber que as credenciais do administrador inicial é:

  • Usuário: admin
  • Senha: admin

Após entrar com as credenciais acima, o programa irá solicitar que altere a senha. Sugiro nesse momento, além de alterar a senha, criar um usuário para você, com seu nome e dados, etc. e não sobrescrever os dados do admin. Apenas por questões de organização e gerenciamento do sistema. A partir daqui você já pode usar normalmente o programa internamente, mas caso queira ter acesso ao OpenProject pela internet, pode seguir adiante com o tutorial.

Configurando acesso externo

Passo 5 – Pré-requisitos

Para os passos seguintes, de modo a não divergir muito do foco aqui deste post, vou assumir que:

  • Já tenha feito/configurado o DDNS do seu Synology.
  • Já tenha feito/configurado o roteamento de portas para o seu Synology.

Configurar o DDNS é simples e direto e também obrigatório para seguir os passos adiante. Já o roteamento de portas pode ser feito depois (não terá o acesso externo, mas ao menos já terá feito 70% do necessário e depois só precisará rotear as portas).

Passo 6 – Configurando o Proxy-Reverso

Abra o “Painel de Controle” e clique em “Portal de login”:

Selecione a aba “Avançado” e em seguida clique em “Proxy reverso”:

Depois clique em “Criar”:

Para a etapa seguinte vou assumir alguns valores para facilitar a compreensão do passo:

  • DDNS = my.synology.me
  • IP do Synology = 192.161.1.1
  • Porta do OpenProject = 4000

Com os parâmetros acima como exemplo, podemos preencher os campos do proxy reverso assim:

Note que coloquei “openprjoject” antes do DDNS. Esse vai ser o endereço ao qual você usará para acessar o cofre. A “Porta” da seção “Origem” com valor 443 deve ser mantido, pois será pelo roteamento dessa porta que você terá acesso ao OpenProject pela internet. Fique atento a todos os campos acima. Volto a dizer que os valores são meramente demonstrativos (exceto a porta 443) para que facilite o input com os valores reais do seu sistema. As outras abas não são necessárias alterar, mas pode fazê-lo ao seu critério. Agora clique em “Salvar” e vamos adiante.

Passo 7 – Obtendo o certificado para HTTPS

Agora no “Painel de Controle”, clique em “Segurança” e siga para a aba “Certificado”. Nela clique em “Adicionar”:

Depois selecione “Adicionar um novo certificado” e clique em “Avançar”:

Selecione “Obter um certificado do Let’s Encrypt” e clique em “Avançar”:

Insira agora o “nome do host” que você escolheu (Passo 6) e coloque-o no “nome de domínio” e clique em “Concluído”:

Continuando na aba “Certificados”, você poderá verificar que terá pelo menos dois certificados presentes:

  • Certificado do DDNS do seu sistema.
  • Certificado recém criado para o OpenProject (como exemplo: openproject.my.synology.me)

Agora clique em “Configurações”. Aparecerá uma janela com serviços aos quais usam o DDNS. Vá para o serviço com o endereço do OpenProject e selecione o certificado correspondente e clique em “OK”:

Pronto, seu OpenProject já está instalado e configurado para ser acessado externamente.

Observações

Segue algumas observações que acho interessante compartilhar sobre esse processo:

  1. O procedimento de instalação do OpenProject pode ser todo através do GUI do pacote de Docker no Synology, ele não tem nenhuma restrição ou limitação quanto a isso, mas o procedimento através do script é mais rápido. Se tiver demanda para o passo-a-passo pelo GUI, entre em contato que farei um só nesse formato.
  2. No site do OpenProject você pode verificar quais os recursos completos que o programa oferece. Infelizmente a parte de “Boards” que seriam uma alternativa pro Trello está apenas disponível na versão “Enterprise”.
  3. Existem mais parâmetros que possa usar, como “PASSENGER_FRIENDLY_ERROR_PAGES” que ajuda no debug caso ocorra algum problema na instalação.
  4. Qualquer ajuda para a manutenção desse site é muito bem vinda: Contribuições.