Planka en un VPS: instalación, configuración y mantenimiento

La instalación, configuración y mantenimiento de Planka en un VPS incluye el despliegue de contenedores Docker, la configuración de un servidor web (Nginx o Caddy) para proxy inverso y HTTPS, así como copias de seguridad y actualizaciones regulares para garantizar el funcionamiento estable de un sistema moderno de gestión de proyectos.

En el contexto de equipos y proyectos en constante evolución, la gestión eficaz de tareas se vuelve fundamental. Planka se presenta como una solución potente y flexible para organizar el flujo de trabajo, ofreciendo una funcionalidad similar a la de productos comerciales populares, pero con la ventaja del control total sobre los datos y la infraestructura. La elección de Planka en un VPS permite no solo garantizar la total confidencialidad, sino también configurar el sistema según las necesidades específicas de su equipo, evitando la dependencia de servicios en la nube de terceros. En esta guía detallada, exploraremos todas las etapas: desde la comprensión de qué es Planka y para qué sirve, hasta la instalación paso a paso de Planka en su servidor, su configuración, la garantía de seguridad y el mantenimiento posterior.

¿Qué es Planka y por qué elegir Planka en un VPS?

Planka es una plataforma de gestión de proyectos moderna y autoalojada (Planka self-hosted), inspirada en soluciones como Trello y Jira. Proporciona una interfaz intuitiva para organizar tareas mediante tableros Kanban, listas y tarjetas. Las funciones principales incluyen la creación de proyectos, la gestión de tareas, la asignación de responsables, el establecimiento de plazos, la adición de comentarios y archivos adjuntos, así como el seguimiento del historial de cambios. Planka está escrita en Node.js utilizando PostgreSQL como base de datos y ofrece una API flexible para la integración con otros sistemas.

Ventajas clave de Planka para su equipo

• Control total sobre los datos: Al alojar Planka en un servidor, usted es el propietario total de sus datos, lo cual es crucial para empresas con altos requisitos de seguridad y privacidad.
• Ahorro de costes: La ausencia de pagos mensuales por usuario o proyecto, característicos de las soluciones en la nube, permite reducir significativamente los costes operativos a medida que el equipo crece.
• Flexibilidad y personalización: El código fuente abierto de Planka permite adaptar la funcionalidad a los procesos de negocio únicos de su organización.
• Rendimiento: El alojamiento optimizado en su propio VPS garantiza una alta velocidad de funcionamiento sin depender de proveedores externos.
• Facilidad de despliegue con Docker: El uso de Planka Docker simplifica enormemente el proceso de instalación y gestión de la aplicación, proporcionando aislamiento y portabilidad.

Al elegir Planka en un VPS, obtiene una herramienta de gestión de proyectos fiable, escalable y totalmente controlada que crecerá con su equipo.

Requisitos del sistema de Planka: ¿qué VPS elegir?

Antes de proceder con la instalación de Planka, es importante determinar los requisitos mínimos y recomendados del sistema para su VPS. Estos parámetros dependen de la carga prevista: número de usuarios, proyectos activos, tareas y volumen de archivos adjuntos almacenados. Planka, siendo una aplicación Node.js con PostgreSQL, es bastante eficiente, pero requiere recursos adecuados para un funcionamiento estable.

Características mínimas y recomendadas del VPS para Planka

Para equipos pequeños (hasta 10-15 usuarios) y un uso no muy intensivo, las configuraciones básicas serán suficientes. Para equipos medianos y grandes, así como para un uso activo con un gran número de proyectos y tareas, se requerirán recursos más potentes.

Parámetro	Mínimo (hasta 10 usuarios)	Recomendado (hasta 50 usuarios)	Para cargas altas (más de 50 usuarios)
Sistema Operativo	Ubuntu 20.04+, Debian 11+, CentOS 8+	Ubuntu 22.04+, Debian 12+	Ubuntu 22.04+, Debian 12+
CPU	1 vCPU (2.0 GHz+)	2 vCPU (2.5 GHz+)	4+ vCPU (3.0 GHz+)
RAM	2 GB	4 GB	8+ GB
Disco (NVMe SSD)	25 GB (mínimo)	50 GB (recomendado)	100+ GB (para archivos adjuntos grandes)
Ancho de banda	100 Mbps	500 Mbps	1 Gbps
Adicional	Docker y Docker Compose	Docker y Docker Compose, Nginx/Caddy	Docker y Docker Compose, Nginx/Caddy, sistema de monitorización

Nota importante: El uso de discos NVMe SSD es crucial para el rendimiento de la base de datos y la respuesta general de la aplicación. Los HDD tradicionales o los SSD SATA pueden ralentizar significativamente el funcionamiento de Planka.

¿Por qué Valebyte.com es la mejor opción para Planka VPS?

En Valebyte.com ofrecemos VPS de alto rendimiento con discos NVMe SSD y potentes procesadores, ideales para alojar Planka en un servidor. Nuestras tarifas están diseñadas para satisfacer diversas necesidades, desde pequeños equipos hasta grandes empresas, garantizando el funcionamiento estable de su instancia de Planka. Puede escalar fácilmente los recursos a medida que su equipo crece y la carga aumenta, asegurando el funcionamiento ininterrumpido del proyecto.

Preparación del VPS para la instalación de Planka Docker

Antes de proceder con el despliegue de Planka, es necesario preparar su VPS. Esta etapa incluye la actualización del sistema, la instalación de Docker y Docker Compose, herramientas que simplificarán significativamente la instalación de Planka y su gestión posterior.

Actualización del sistema e instalación de utilidades necesarias

Conéctese a su VPS por SSH y ejecute los siguientes comandos para actualizar el sistema e instalar los paquetes básicos:

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl git nano

Para CentOS/RHEL, use:

sudo yum update -y
sudo yum install -y curl git nano

Instalación de Docker y Docker Compose

Planka Docker es el método de despliegue preferido, ya que proporciona aislamiento para la aplicación y sus dependencias. Instalaremos Docker Engine y Docker Compose. Para Ubuntu/Debian:

# Instalación de Docker
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Añadir el usuario actual al grupo docker (para no usar sudo con los comandos docker)
sudo usermod -aG docker $USER
newgrp docker

Para CentOS/RHEL:

# Instalación de Docker
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl start docker
sudo systemctl enable docker

# Añadir el usuario actual al grupo docker
sudo usermod -aG docker $USER
newgrp docker

Verifique la instalación de Docker:

docker run hello-world

Si ve el mensaje "Hello from Docker!", significa que Docker está instalado y funciona correctamente. Ahora su VPS está listo para la instalación de Planka.

Instalación paso a paso de Planka en un VPS con Docker Compose

El despliegue de Planka utilizando Docker Compose es el método más sencillo y recomendado. Permite definir todos los servicios (Planka, PostgreSQL) y sus dependencias en un solo archivo, simplificando la gestión. Siga estos pasos para la instalación de Planka en su VPS.

Creación del archivo docker-compose.yml

Cree un directorio para Planka y navegue hasta él:

mkdir ~/planka
cd ~/planka

Cree el archivo docker-compose.yml, utilizando su editor de texto favorito (por ejemplo, nano):

nano docker-compose.yml

Pegue el siguiente contenido. Asegúrese de reemplazar YOUR_SECRET_KEY por una cadena larga y aleatoria (mínimo 32 caracteres) y YOUR_POSTGRES_PASSWORD por una contraseña segura para la base de datos.

version: '3.8'

services:
  planka:
    image: ghcr.io/plankanban/planka:latest
    container_name: planka_app
    restart: always
    ports:
      - "1337:1337"
    environment:
      - DATABASE_URL=postgresql://planka:${YOUR_POSTGRES_PASSWORD}@db:5432/planka
      - SECRET_KEY=${YOUR_SECRET_KEY}
      - ROOT_URL=http://localhost:1337 # Se cambiará al configurar el dominio
      - TRUST_PROXY=1 # Importante al usar un proxy inverso
    depends_on:
      - db
    volumes:
      - ./uploads:/app/uploads # Almacenamiento de archivos subidos
      - ./data:/app/data # Otros datos de Planka

  db:
    image: postgres:15-alpine
    container_name: planka_db
    restart: always
    environment:
      - POSTGRES_DB=planka
      - POSTGRES_USER=planka
      - POSTGRES_PASSWORD=${YOUR_POSTGRES_PASSWORD}
    volumes:
      - ./db_data:/var/lib/postgresql/data # Almacenamiento de datos de la base de datos

volumes:
  uploads:
  data:
  db_data:

Explicaciones del archivo:

• planka: Servicio para la aplicación Planka en sí. Utiliza la imagen oficial de Docker.
• ports: - "1337:1337": Mapea el puerto 1337 del contenedor al puerto 1337 de la máquina host. Este es el puerto interno de Planka.
• DATABASE_URL: Cadena de conexión a la base de datos PostgreSQL.
• SECRET_KEY: Clave secreta única para el cifrado de datos de sesión. ¡Debe cambiarla!
• ROOT_URL: URL base de su aplicación. Actualmente configurado como localhost, pero se cambiará más tarde para el acceso por dominio.
• TRUST_PROXY=1: Variable importante que indica a Planka que confíe en los encabezados del servidor proxy (por ejemplo, Nginx o Caddy) para la correcta identificación de las direcciones IP de los clientes y el protocolo HTTPS.
• volumes: Monta directorios del host en los contenedores para preservar los datos (archivos, base de datos) incluso después de eliminar los contenedores. Esto es crucial para la persistencia de datos y la copia de seguridad.
• db: Servicio para la base de datos PostgreSQL. Utiliza la imagen oficial.
• POSTGRES_PASSWORD: Contraseña para el usuario de la base de datos Planka. ¡Debe cambiarla!

Guarde el archivo (Ctrl+X, Y, Enter para nano).

Inicio de Planka con Docker Compose

Ahora que el archivo docker-compose.yml está listo, puede iniciar Planka:

docker compose up -d

La clave -d inicia los contenedores en segundo plano. Docker Compose descargará las imágenes necesarias, creará los contenedores y los iniciará. Este proceso puede tardar varios minutos la primera vez.

Puede verificar el estado de los contenedores con el comando:

docker compose ps

Debería ver que los contenedores planka_app y planka_db están en estado "Up".

En esta etapa, Planka en el VPS ya está en funcionamiento y accesible a través de la dirección IP de su servidor en el puerto 1337 (por ejemplo, http://SU_IP:1337). Sin embargo, para un uso completo y para garantizar la seguridad, es necesario configurar un proxy inverso y HTTPS.

Configuración de proxy inverso y HTTPS para Planka

El acceso directo a Planka a través de la dirección IP y el puerto 1337 no es seguro ni conveniente. La configuración de un proxy inverso (Nginx o Caddy) con HTTPS (certificado SSL/TLS de Let's Encrypt) le permitirá acceder a Planka por nombre de dominio, garantizará el cifrado del tráfico y aumentará la seguridad general. Este es un paso clave para cualquier instalación de Planka self-hosted.

Antes de comenzar, asegúrese de tener un nombre de dominio que apunte a la dirección IP de su VPS.

Opción 1: Configuración de Nginx como proxy inverso con HTTPS

Nginx es un servidor web potente y popular, ideal para el papel de proxy inverso.

Instalación de Nginx y Certbot

sudo apt install -y nginx certbot python3-certbot-nginx

Para CentOS/RHEL:

sudo yum install -y nginx epel-release
sudo yum install -y certbot python3-certbot-nginx

Configuración de Nginx

Cree un nuevo archivo de configuración de Nginx para su dominio (reemplace your_domain.com por su dominio real):

sudo nano /etc/nginx/sites-available/planka.conf

Pegue el siguiente contenido:

server {
    listen 80;
    listen [::]:80;
    server_name your_domain.com www.your_domain.com;

    location / {
        proxy_pass http://localhost:1337; # Puerto de Planka
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Active la configuración creando un enlace simbólico y reiniciando Nginx:

sudo ln -s /etc/nginx/sites-available/planka.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Obtención de un certificado SSL con Certbot

Ahora obtenga un certificado SSL gratuito de Let's Encrypt usando Certbot:

sudo certbot --nginx -d your_domain.com -d www.your_domain.com

Siga las instrucciones de Certbot. Actualizará automáticamente la configuración de Nginx para usar HTTPS y configurará la renovación automática del certificado.

Actualización de ROOT_URL en Docker Compose

Vuelva al archivo docker-compose.yml y actualice la variable ROOT_URL para que use su nombre de dominio con HTTPS:

nano ~/planka/docker-compose.yml

Cambie la línea:

      - ROOT_URL=http://localhost:1337

A:

      - ROOT_URL=https://your_domain.com

Guarde el archivo y reinicie los contenedores de Planka para que los cambios surtan efecto:

cd ~/planka
docker compose down
docker compose up -d

Ahora su Planka en el VPS es accesible en https://your_domain.com con una conexión segura.

Opción 2: Configuración de Caddy como proxy inverso con HTTPS

Caddy es un servidor web moderno que gestiona automáticamente los certificados SSL de Let's Encrypt, lo que lo hace muy fácil de configurar.

Instalación de Caddy

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

Para CentOS/RHEL:

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://dl.cloudsmith.io/public/caddy/stable/rpm/caddy-stable.repo
sudo yum install -y caddy

Configuración de Caddyfile

Cree o edite el archivo Caddyfile:

sudo nano /etc/caddy/Caddyfile

Elimine todo el contenido existente y pegue lo siguiente (reemplace your_domain.com por su dominio real):

your_domain.com {
    reverse_proxy localhost:1337 # Puerto de Planka
}

Caddy obtendrá y configurará automáticamente un certificado SSL para your_domain.com. Reinicie Caddy:

sudo systemctl restart caddy

Actualización de ROOT_URL en Docker Compose

Al igual que con Nginx, actualice la variable ROOT_URL en su archivo docker-compose.yml:

nano ~/planka/docker-compose.yml

Cambie la línea:

      - ROOT_URL=http://localhost:1337

A:

      - ROOT_URL=https://your_domain.com

Guarde el archivo y reinicie los contenedores de Planka:

cd ~/planka
docker compose down
docker compose up -d

Ahora su Planka en el servidor es accesible en https://your_domain.com con HTTPS automático.

Mantenimiento de Planka: copias de seguridad, actualizaciones y monitorización

Después de una instalación exitosa de Planka en un VPS, es importante garantizar su funcionamiento estable y seguro mediante un mantenimiento regular. Esto incluye la copia de seguridad de datos, actualizaciones oportunas y monitorización del rendimiento.

Estrategias de copia de seguridad de datos de Planka

La copia de seguridad es un aspecto crucial para cualquier instalación de Planka self-hosted. La pérdida de datos puede tener graves consecuencias. Dado que utilizamos Docker Compose con volúmenes persistentes, el proceso de copia de seguridad es relativamente sencillo.

Los datos principales de Planka se almacenan en dos lugares:

1. Base de datos PostgreSQL (./db_data en nuestro docker-compose.yml).
2. Archivos subidos (./uploads en nuestro docker-compose.yml).

Copia de seguridad manual:

Puede crear un archivo de estas directorios:

cd ~/planka
docker compose stop planka_app # Detenga la aplicación Planka antes de la copia de seguridad de la BD para consistencia
pg_dump -h localhost -p 5432 -U planka planka > db_backup_$(date +%Y%m%d%H%M%S).sql # Si PostgreSQL es accesible directamente
# O, si solo a través de Docker:
docker exec planka_db pg_dump -U planka planka > db_backup_$(date +%Y%m%d%H%M%S).sql
tar -czvf uploads_backup_$(date +%Y%m%d%H%M%S).tar.gz uploads
docker compose start planka_app

Copia de seguridad automatizada:

Para la automatización, puede usar cron y scripts que ejecutarán estos comandos regularmente. Se recomienda usar herramientas especializadas para copias de seguridad, como Restic o BorgBackup, que admiten copias de seguridad incrementales y cifrado. Guarde las copias de seguridad en un almacenamiento remoto (S3, Backblaze B2, etc.), no en el mismo VPS.

Actualización de Planka e imágenes Docker

Las actualizaciones regulares de Planka son importantes para obtener nuevas funciones, correcciones de errores y solucionar vulnerabilidades de seguridad.

Para actualizar Planka Docker, basta con ejecutar los siguientes comandos en el directorio ~/planka:

cd ~/planka
docker compose pull # Descarga las últimas versiones de las imágenes
docker compose down # Detiene los contenedores actuales
docker compose up -d # Inicia nuevos contenedores con las imágenes actualizadas

Siempre se recomienda hacer una copia de seguridad antes de actualizar.

Monitorización del rendimiento y registros

Para mantener la salud de su Planka en el servidor, supervise su estado:

• Registros de contenedores: Verifique los logs de Planka y PostgreSQL en busca de errores:

  docker compose logs planka_app
  docker compose logs planka_db

• Uso de recursos: Utilice los comandos htop, free -h, df -h en su VPS para monitorizar la CPU, RAM y el espacio en disco.
• Sistemas de monitorización: Para escenarios más complejos, considere el uso de Prometheus + Grafana para recopilar y visualizar métricas de su VPS y contenedores Docker.

El mantenimiento y la monitorización regulares garantizarán la estabilidad y seguridad a largo plazo de su instalación de Planka.

Elección de la configuración óptima de VPS para la carga real de Planka

La elección de la configuración correcta de VPS para Planka en un VPS es un factor clave para garantizar el rendimiento y la escalabilidad. Aunque ya hemos cubierto las recomendaciones generales, profundizaremos en los detalles, considerando diferentes escenarios de uso y la carga real. La elección correcta ayudará a evitar "cuellos de botella" y garantizará un trabajo cómodo para su equipo.

Factores que influyen en la elección de la configuración

1. Número de usuarios activos: Cuantos más usuarios trabajen simultáneamente con Planka, mayores serán los requisitos de CPU y RAM. Cada usuario activo genera solicitudes a la base de datos y a la API de la aplicación.
2. Intensidad de uso: Un equipo que crea, mueve y comenta activamente cientos de tareas diariamente generará una carga significativamente mayor que uno que usa Planka solo para una docena de tareas a la semana.
3. Volumen de archivos adjuntos almacenados: Planka permite adjuntar archivos a las tareas. Si su equipo planea almacenar grandes volúmenes de archivos (imágenes, documentos, archivos), necesitará más espacio en disco.
4. Otras aplicaciones en el VPS: Si su VPS no solo se usa para Planka, sino también para otros servicios (por ejemplo, Vikunja, un servidor Git, un almacenamiento de archivos Filebrowser), es necesario tener en cuenta sus requisitos al planificar los recursos.

Recomendaciones de configuración de VPS de Valebyte.com

Basándonos en nuestra experiencia, ofrecemos las siguientes configuraciones de VPS de Valebyte.com, optimizadas para Planka en el servidor:

• Para equipos pequeños (hasta 10-15 usuarios activos):
  • CPU: 2 vCPU (2.5 GHz+)
  • RAM: 4 GB
  • Disco: 50 GB NVMe SSD
  • Ancho de banda: 500 Mbps
  • Presupuesto mensual aproximado: desde $15-$25
  • Justificación: Esto garantizará un rendimiento suficiente para la base de datos y la aplicación en sí, así como un pequeño margen para picos de carga. El NVMe SSD asegura un acceso rápido a los datos.
• Para equipos medianos (15-50 usuarios activos):
  • CPU: 4 vCPU (2.8 GHz+)
  • RAM: 8 GB
  • Disco: 100 GB NVMe SSD
  • Ancho de banda: 1 Gbps
  • Presupuesto mensual aproximado: desde $30-$60
  • Justificación: El aumento de los recursos de CPU y RAM permitirá procesar eficazmente un mayor número de solicitudes simultáneas y tareas en segundo plano. Un disco más grande será necesario para el creciente volumen de archivos adjuntos y registros.
• Para equipos grandes y cargas altas (más de 50 usuarios activos):
  • CPU: 6-8+ vCPU (3.0 GHz+)
  • RAM: 16+ GB
  • Disco: 200+ GB NVMe SSD
  • Ancho de banda: 1 Gbps+
  • Presupuesto mensual aproximado: desde $70-$150+
  • Justificación: Esta configuración proporcionará un margen de rendimiento significativo para manejar un gran número de solicitudes, operaciones complejas de la base de datos y soporte para un gran número de usuarios simultáneos. Posiblemente, valga la pena considerar la separación de la base de datos en un servidor aparte o el uso de soluciones de clúster si la carga es extremadamente alta.

Nuestras tarifas de VPS en Valebyte.com son flexibles, lo que le permite adaptar con precisión los recursos a sus necesidades. Siempre puede empezar con una tarifa más modesta y escalarla a medida que su equipo y proyecto crecen, minimizando los costes iniciales y optimizando los gastos de infraestructura para su Planka self-hosted.

Conclusiones

El despliegue de Planka en un VPS proporciona a su equipo una herramienta potente, flexible y totalmente controlada para la gestión de proyectos. Siguiendo las instrucciones paso a paso para la instalación de Planka a través de Docker Compose, la configuración de un proxy inverso con HTTPS y adhiriéndose a las recomendaciones de mantenimiento, podrá crear un entorno de trabajo fiable y seguro. Para un rendimiento y escalabilidad óptimos, elija servidores VPS de alto rendimiento con NVMe SSD de Valebyte.com, que garantizarán el funcionamiento estable de su instalación de Planka Docker incluso bajo una carga significativa.