Como instalar o Plane na Saplo: alternativa à Jira sem custos por utilizador

O Jira no plano Standard custa hoje cerca de 7,91 dólares por utilizador por mês, o que equivale a aproximadamente 7 €. Para uma equipa de cinco programadores, são cerca de 34 € por mês, e para dez, 68 €. A fatura cresce com cada nova conta: um estagiário, um tester ou um cliente que queira ver o progresso do sprint. A Linear tem um modelo de preços semelhante. Neste guia, mostramos como instalar o Plane, uma alternativa de código aberto à Jira e à Linear, no seu próprio Box na Saplo. Sem taxas por posto, com os dados num servidor na Alemanha e com um único pagamento anual.

Encontrarás as instruções completas na página do Plane no catálogo de aplicações da Saplo. A seguir, encontras tudo o que vale a pena saber antes de clicares e também depois.

O que é o Plane

O Plane é uma ferramenta para gerir o trabalho de equipas de programação. Tem aquilo pelo qual as equipas pagam no Jira:

• tarefas (work items) com prioridade, atribuição, etiquetas, estimação e prazo,
• ciclos, ou seja, sprints com data de início e fim e gráfico de consumo,
• módulos e épicos, com os quais agrupas partes maiores do trabalho,
• backlog com tarefas que ainda não foram atribuídas a nenhum ciclo,
• vistas de lista, quadro Kanban, calendário, tabela e cronologia, guardadas com filtros,
• páginas, ou seja, um wiki simples junto ao projeto para notas, especificações e decisões,
• colaboração em tempo real, porque as alterações de outras pessoas são visíveis de imediato, sem atualizar.

O projeto é desenvolvido de forma aberta no GitHub e a edição Community é publicada sob a licença AGPL-3.0 e não tem limite de utilizadores. No Saplo, utilizamos a imagem oficial makeplane/plane-aio-community, ou seja, a versão All-In-One: a interface, a API, o worker de tarefas em segundo plano e o servidor de colaboração em tempo real estão tutti num único contentor.

Uma distinção importante: no Catálogo de aplicações da Saplo também está o Vikunja. O Vikunja é uma lista geral de tarefas, kanban e gantt para qualquer equipa. O Plane foi criado para trabalhar com uma equipa de desenvolvimento ágil: sprints, backlog, épicos e estimativas. Se geres uma floricultura e queres uma lista de tarefas para a semana, escolhe o Vikunja. Se geres sprints, escolhe o Plane.

Plane ou Jira: uma comparação honesta

	Jira Cloud (Standard)	Plane Community no Saplo
Custo	cerca de 7 € por utilizador/mês	preço fixo do Box, por ano
Limite de utilizadores	pagas por cada conta	sem limite
Onde ficam os dados	nuvem da Atlassian	o teu Box, servidor na Alemanha
Sprints, backlog, épicas	sim	sim
Vistas: kanban, lista, calendário, linha temporal	sim	sim
Wiki no projeto	à parte no Confluence, pago	páginas integradas
Marketplace de extensões	enorme	modesto
Workflows e automações avançados	muitoizzo sviluppati	mais simples
Atualizações e cópias de segurança	feitas pela Atlassian	por ti, com a ajuda das cópias do Box
Suporte	do fabricante	comunidade e documentação

Quando ficar com a Jira:

• quando a equipa tem até 10 pessoas e o plano gratuito Jira Free lhe basta (com as respetivas limitações, incluindo a ausência de permissões avançadas e um limite pequeno de espaço para ficheiros),
• quando a empresa vive no ecossistema Atlassian: Confluence, Bitbucket, Jira Service Management e uma dezena de extensões pagas,
• quando precisam de esquemas de workflow muito complexos, auditoria de conformidade e um contrato de SLA com o fabricante,
• quando ninguém na equipa quer ser responsável pela sua própria instância, mesmo uma tão simples como no Saplo.

Quando o Plane faz mais sentido:

• a equipa cresce e todos os meses pagas por cada nova conta,
• queres que os clientes ou subcontratados tenham visibilidade do projeto, sem teres de lhes comprar licenças,
• os dados dos projetos, as especificações e as notas relacionadas com clientes devem ficar no teu servidor na UE,
• a Jira é demasiado pesada para a equipa e querem uma ferramenta rápida e legível ao estilo da Linear.

A edição Community não tem todas as funcionalidades dos planos pagos do Plane (Pro, Business). Antes de transferires uma equipa grande, vale a pena comparares a lista de funcionalidades na página de preços do Plane e verificares se o que usam na Jira no dia a dia está disponível no Community.

Cálculo dos custos

Para utilizar o Plane, precisas de um Box L (mais informações abaixo), que custa 139 € por ano, ou seja, cerca de 11 € por mês. O preço do primeiro período é igual ao preço da renovação. Comparação com o Jira Standard, a cerca de 7 € por pessoa:

Equipa	Jira Standard por ano	Plane no Box L por ano	Diferença
5 pessoas	cerca de 409 €	139 €	cerca de 273 €
10 pessoas	cerca de 818 €	139 €	cerca de 682 €
15 pessoas	cerca de 1227 €	139 €	cerca de 1091 €
25 pessoas	cerca de 2045 €	139 €	cerca de 1909 €

Há duas observações honestas a fazer sobre esta tabela. Primeiro, existe o Jira Free para até 10 pessoas, por isso, se as limitações da versão gratuita não atrapalham a tua pequena equipa, não vais poupar um único euro com o Plane. Segundo, o Box L não serve apenas para o Plane. Tens 6 GB de RAM e 60 GB de disco, por isso, para além do Plane, também cabem normalmente aplicações mais leves, como Uptime Kuma para monitorização, ou o site da tua empresa. O número de aplicações no Box não está limitado, apenas a memória e o disco impõem limites.

Requisitos e escolha do Box

Plane é uma das receitas mais pesadas do catálogo. A instalação cria seis contentores:

• postgres (PostgreSQL 16) para os dados da aplicação,
• redis para cache e sessões,
• rabbitmq como fila de tarefas em segundo plano,
• storage, ou seja, um armazenamento de ficheiros compatível com S3 (SeaweedFS) para anexos e avatares,
• storage-init, um contentor de execução única que cria o bucket de ficheiros e termina,
• plane, ou seja, a própria aplicação.

A receita requer no mínimo 3 GB de RAM e 10 GB de disco. Isto exclui Box S (1 GB) e Box M (2 GB). A escolha certa é:

• Box L (6 GB de RAM, 60 GB de disco, 139 € por ano, cópias de segurança de 7 dias) para uma equipa de até uma dúzia de pessoas, com reserva de memória para uma ou duas aplicações leves a funcionar em paralelo,
• Box XL (12 GB de RAM, 150 GB de disco, 299 € por ano, cópias de segurança de 14 dias), quando a equipa é maior, as tarefas incluem muitos anexos ou se pretende que outras aplicações mais pesadas funcionem no mesmo Box, por exemplo n8n ou CRM.

Ambos os planos dispose de acesso SSH com sudo total, o que será útil na configuração do correio eletrónico.

Instalação passo a passo

1. Inicia sessão no Painel Saplo e entra no Catálogo de aplicações. Podes encontrar o Plane nas ferramentas. Também podes começar pela página do Plane e clicar no botão de implementação.
2. Escolhe o Box. Se tiver pouca memória livre, o Painel informa-te antes da instalação, e não depois de uma tentativa falhada.
3. Indica o endereço. A opção mais simples é um subdomínio como zadania.saploapp.pl. Configuras o teu próprio domínio, por exemplo projects.asuaempresa.com, durante a instalação, e o certificado SSL é emitido automaticamente.
4. Confirma. O motor instala o Docker, gera palavras-passe aleatórias para a base de dados, o Redis, o RabbitMQ e o armazenamento de ficheiros, bem como chaves de sessão, guarda-as permanentemente na configuração desta instalação e inicia os contentores pela ordem correta: primeiro a base de dados, a cache, a fila e o armazenamento, depois a criação do bucket e, por último, a aplicação.
5. Espera. No primeiro arranque, o Plane executa a migração do esquema da base de dados, que demora mais do que alguns segundos. A instalação só termina quando a aplicação está efetivamente a responder no teu endereço, portanto o estado "a funcionar" significa que o Plane está pronto.
6. Abre o endereço no navegador.

Dentro do contentor, o Plane executa o seu próprio servidor proxy na porta 80, sem certificado. O servidor Box termina a encriptação HTTPS, tal como acontece em qualquer outra aplicação no Saplo, por isso não tens de configurar nada aqui.

Primeira configuração: administrador e workspace

O Plane não recebe uma senha de administrador gerada de antemão. Crias a Conta por ti próprio na primeira entrada:

1. Na primeira visita, o Plane conduz-te pela configuração da instância. Quem a concluir torna-se administrador da instância, por isso faz isso logo após a instalação, antes que o endereço chegue a alguém.
2. Cria um workspace, ou seja, o espaço de trabalho da empresa. O nome e o endereço do workspace aparecerão nos links para as tarefas.
3. Cria o primeiro projeto com um identificador curto, por exemplo WEB. As tarefas recebem os números WEB-1, WEB-2 e assim por diante, como no Jira.
4. Nas definições do projeto, ajusta os estados (por exemplo, Backlog, A fazer, Em curso, Code review, Concluído) e ativa as funcionalidades que usas: ciclos, módulos, páginas.

A descrição da instalação, incluindo os nomes de todos os contentores e os comandos para consultar os logs, é guardada no ficheiro PLANE-SETUP.txt, na pasta de aplicações no Box. O Painel Saplo mostra o seu conteúdo sempre que precisares dele.

Trabalho da equipa: convites e correio eletrónico

Podes convidar mais membros da equipa nas definições do workspace. Há aqui uma coisa que precisas de saber: a receita não liga automaticamente um servidor de correio eletrónico. O convite será criado, mas o e-mail que o acompanha não será enviado, o mesmo acontece com as notificações de atribuição de uma tarefa.

Há duas opções:

• mais simples: os membros da equipa criam contas com o teu endereço de e-mail e, depois de iniciarem sessão, aceitam o convite, ou tu adicionas-nos manualmente ao workspace,
• completa: configuras o SMTP, por exemplo, utilizando uma caixa de correio da empresa. Fazes isto por SSH, preenchendo as variáveis EMAIL_* no ficheiro docker-compose.yml no catálogo de aplicações (host, porta, utilizador, palavra-passe, endereço do remetente) e reiniciando o contentor com o comando docker compose up -d. A partir daí, os convites, as notificações e a reposição da palavra-passe funcionam normalmente.

Podes criar a caixa de correio para envio no serviço de correio eletrónico da Saplo, que está incluído no preço de cada Box.

Migração da Jira. O mais sensato é começar por um projeto e um sprint, e não pela migração de todo o histórico. As tarefas antigas e fechadas podem ficar na Jira apenas para consulta ou ser exportadas. Antes da migração, consulta a Documentação do Plane para verificares se a edição em questão tem um importador automático da Jira. Se for necessário, podes utilizar a API Plane para carregar as tarefas através de um script.

Segurança e configurações que valem a pena alterar

Algumas coisas para a primeira semana:

• Configura a instância desde o início. A primeira pessoa que concluir a configuração fica com o papel de administrador, por isso não deixes uma instalação nova sem supervisão.
• Restringe o registo. Quando todas as pessoas da equipa já tiverem contas, desativa no painel de administração da instância a possibilidade de qualquer pessoa que conheça o endereço criar contas livremente.
• Usa as funções. Um cliente que apenas pretenda consultar o progresso não precisa da função de membro com permissões de edição. O Plane tem funções de administrador, membro e convidado.
• Cópias de segurança. O Box L faz cópias de segurança com 7 dias de histórico, e o Box XL com 14 dias. Além disso, cada Box tem uma cópia fora do servidor. Antes de alterações mais extensas, como uma atualização de versão, podes exportar manualmente a base de dados através de docker exec no contentor PostgreSQL.
• Os segredos ficam no local. As palavras-passe e as chaves são guardadas em docker-compose.yml desta instalação. Não as alteres manualmente sem necessidade, porque alterar a chave de sessão termina as sessões de todas as pessoas, e alterar a palavra-passe da base de dados sem a mudar também na própria base de dados faz com que a aplicação pare.

Problemas mais frequentes

A página demora muito tempo a carregar logo após a instalação. Dentro do contentor, são iniciados vários processos ao mesmo tempo (migrações, API, worker, servidor de colaboração). Num Box recém-instalado, o primeiro acesso pode demorar um pouco mais. Pré-visualização: docker logs -f com o nome do contentor a partir do ficheiro PLANE-SETUP.txt.

Os convites não chegam. Não é um erro, mas sim a falta de SMTP. A descrição da configuração do email está mais acima.

Não é possível carregar um anexo. Os anexos são enviados para o armazenamento SeaweedFS. Se o contentor storage-init não tiver criado o bucket, o upload termina com um erro. A instalação garante esta ordem, mas, quando reinicias os contentores manualmente, verifica os logs do armazenamento e do contentor storage-init.

O Box começa a ficar lento. Seis contentores precisam de memória. Se, além do Plane, estiverem a funcionar outras aplicações pesadas, verifica o consumo de RAM no painel do Saplo. A solução é acrescentar memória ou passar de Box L para Box XL, sem mover os dados.

Depois do reinício, todas as sessões são encerradas. Isto não deveria acontecer, porque as chaves de sessão estão guardadas de forma permanente. Se acontecer, verifica se alguém não limpou as variáveis SECRET_KEY ou LIVE_SERVER_SECRET_KEY na configuração.

Resumo

O Plane dá à equipa de desenvolvimento sprints, backlogs, épicos e vistas conhecidas da Jira, sem um custo por utilizador. Para uma equipa com mais de 10 pessoas, a diferença representa milhares de euros por ano, e os dados dos projetos ficam no teu servidor, na União Europeia. O preço a pagar: alguns minutos a configurar o email e a manter cópias de segurança, que na Saplo são feitas automaticamente.

Se a equipa for pequena e a Jira Free chegar, não há motivo para mudar. Se a fatura das licenças aumentar a cada trimestre, abre a página do Plane no Catálogo de aplicações da Saplo, escolhe a Box L e cria a tua própria instância. Encontra a comparação completa dos planos na lista de preços.