Manual mestre: Desplegament i gestió de Plane (Edició Prime)
Guia tècnica integral per al desplegament de Plane Commercial/Prime Edition en Linux, configuració DNS amb Cloudflare i administració mitjançant prime-cli.
🗺️ Mapa de ruta del desplegament
Sección titulada «🗺️ Mapa de Ruta del Despliegue»- Requisits previs i preparació de l'entorn
- Instal·lació correcta de Docker Engine i Compose V2
- Configuració de DNS i SSL (Cloudflare)
- Instal·lació i posta en marxa de Plane
- Manual de referència de l'eina Prime CLI
- Resolució de problemes comuns
1. Requisits previs i preparació de l'entorn
Sección titulada «1. Requisitos Previos y Preparación del Entorno»Per garantir un desplegament estable i lliure de conflictes en els ports principals (80 i 443), cal inicialitzar la instància en un servidor net:
- Sistema Operatiu Recomanat: Ubuntu Server 20.04 LTS, 22.04 LTS o 24.04 LTS.
- Recursos Mínims Recomanats: 4 GB de memòria RAM i 2 vCPUs (es suggereixen 8 GB de RAM per a entorns de producció activa).
- Dominio Dedicat: Un registre DNS apuntant a la IP pública de l'host (ex.
plane.portelcore.com).
2. Instal·lació Correcta de Docker Engine i Compose V2
Sección titulada «2. Instalación Correcta de Docker Engine y Compose V2»[!IMPORTANT] Es desaconsella l'ús directe de
apt install docker.ioen repositoris bàsics d'Ubuntu, ja que instal·la paquets obsolets i incompatibles amb el backend de Plane. Segueix aquest procediment estandaritzat per instal·lar el motor oficial.
2.1. Depuració de Versions Conflictives (Neteja)
Sección titulada «2.1. Depuración de Versiones Conflictivas (Limpieza)»sudo apt-get remove docker docker-engine docker.io containerd runc2.2. Configuració del Repositori Oficial de Docker
Sección titulada «2.2. Configuración del Repositorio Oficial de Docker»Afegeix les claus GPG del repositori oficial segur de Docker:
# Instalar dependencias previassudo apt-get updatesudo apt-get install ca-certificates curl gnupg -y
# Crear el llavero seguro en el sistemasudo install -m 0755 -d /etc/apt/keyrings
# Descargar e importar la clave GPGcurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgsudo chmod a+r /etc/apt/keyrings/docker.gpg
# Añadir el repositorio a las fuentes estables de Aptecho \ "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/null2.3. Instal·lació del Motor i el Plugin Compose
Sección titulada «2.3. Instalación del Motor y Plugin Compose»sudo apt-get updatesudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y2.4. Validació de la Versió Modernitzada
Sección titulada «2.4. Validación de la Versión Modernizada»Verifica que el comand d'orquestació de Docker Compose V2 estigui correctament integrat:
docker compose version# Salida esperada: Docker Compose version v2.x.x3. Configuració de DNS i SSL (Cloudflare)
Sección titulada «3. Configuración de DNS y SSL (Cloudflare)»Perquè el desplegament funcioni correctament sota el paràmetre d'enrutament --behind-proxy, realitza la configuració al teu panell d'administració DNS de Cloudflare:
- Registre DNS (A): Crea una entrada
Aper al teu subdomini (plane) resolent cap a l'adreça IP pública del teu servidor. - Estat del Proxy: Assegura't que el núvol naranja estigui actiu (Proxied).
- Criptografia SSL/TLS: Configura el mode de xifratge a Full o Full (Strict) al panell de Cloudflare.
4. Instal·lació i posada en marxa de Plane
Sección titulada «4. Instalación y Puesta en Marcha de Plane»4.1. Creació del directori de treball
Sección titulada «4.1. Creación del Directorio de Trabajo»mkdir plane-selfhost && cd plane-selfhostcurl -fsSL https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/install.sh -o setup.shchmod +x setup.sh4.2. Execució de l'instal·lador en mode proxy
Sección titulada «4.2. Ejecución del Instalador en Modo Proxy»Aquest pas és crític per omitir l'autogestió de certificats TLS locals en Plane i delegar el SSL al nostre proxy segur:
sudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"L'script descarregarà les imatges dels serveis base (valkey, postgres, minio, core backend i frontend) i aixecarà els contenidors en segon pla.
5. Manual de referència de l'eina Prime CLI
Sección titulada «5. Manual de Referencia de la Herramienta Prime CLI»L'edició Plane Prime s'administra centralment mitjançant la interfície de línia de comandes prime-cli, instal·lada a /bin/prime-cli.
Sintaxi d'execució:
sudo prime-cli [comando]A. Control del cicle de vida de l'stack
Sección titulada «A. Control del Ciclo de Vida del Stack»prime-cli start: Encesa tots els contenidors definits en l'stack. Útil si l'host s'ha reiniciat.prime-cli stop: Atura ordenadament els contenidors de Plane. S'ha d'executar sempre abans de manteniments de l'host.prime-cli restart: Aplica un reinici complet als contenidors operatius davant ralentitzacions.
B. Configuració i Manteniment Avançat
Sección titulada «B. Configuración y Mantenimiento Avanzado»prime-cli configure: Obre un menú interactiu a la consola per gestionar variables d'entorn com SMTP, emmagatzematge S3/MinIO corporatiu i secrets de l'aplicació.prime-cli upgrade: Actualitza Plane a l'última versió disponible del canal oficial, executant migracions de base de dades. Es suggereix realitzar una còpia de seguretat completa abans de la seva execució.prime-cli repair: Restableix i repareix dependències o imatges corruptes si l'inici de l'aplicació falla.prime-cli update-cli: Actualitza de manera independent l'eina de gestióprime-cli.
C. Estratègia de Còpies de Seguretat
Sección titulada «C. Estrategia de Respaldos»prime-cli backup: Genera un fitxer comprimit.tar.gzo.zipamb la base de dades MySQL/Postgres local, fitxers adjunts de tasques i la configuració del fitxer.env. Emmagatzemat per defecte a/opt/plane/backups.prime-cli restore: Sobrescriu l'estat actual carregant un punt de restauració previ.
D. Diagnòstic i Monitoratge
Sección titulada «D. Diagnóstico y Monitoreo»prime-cli monitor: Mostra el volcat de traces de logs en temps real de tots els serveis.prime-cli healthcheck: Realitza peticions de salut internes i informa de l'estat de Redis/Valkey, Postgres, Backend i els microserveis frontend.
6. Resolució de Problemes Comuns
Sección titulada «6. Resolución de Problemas Comunes»Error: “Permission Denied” a la terminal de Docker
Sección titulada «Error: “Permission Denied” en la Terminal de Docker»- Causa: L'usuari de consola actual no té privilegis sobre el socket local
/var/run/docker.sock. - Solució Permanent: Afegeix el teu usuari al grup operatiu de Docker:
Ventana de terminal sudo usermod -aG docker $USERnewgrp docker
Error: 502 Bad Gateway (Cloudflare Edge)
Sección titulada «Error: 502 Bad Gateway (Cloudflare Edge)»- Inspecciona l'estat dels contenidors locals:
sudo prime-cli healthcheck. - Verifica que el proxy invers del contenidor de Plane responsi al port HTTP intern assignat a l'host.
- Assegura't que les directives del firewall de xarxa (p. ex. UFW) no estiguin bloquejant la comunicació interna.

