Hlavní příručka: Nasazení a správa Plane (Prime Edition)
Komplexní technická příručka pro nasazení Plane Commercial/Prime Edition na Linuxu, konfiguraci DNS pomocí Cloudflare a správu prostřednictvím prime-cli.
🗺️ Plán nasazení
Sección titulada «🗺️ Mapa de Ruta del Despliegue»- Prerekvizity a příprava prostředí
- Správná instalace Docker Engine a Compose V2
- Konfigurace DNS a SSL (Cloudflare)
- Instalace a nasazení Plane
- Referenční příručka nástroje Prime CLI
- Řešení běžných problémů
1. Předpoklady a příprava prostředí
Sección titulada «1. Requisitos Previos y Preparación del Entorno»Pro zajištění stabilního nasazení bez konfliktů na hlavních portech (80 a 443) je nutné inicializovat instanci na čistém serveru:
- Doporučený operační systém: Ubuntu Server 20.04 LTS, 22.04 LTS nebo 24.04 LTS.
- Doporučené minimální prostředky: 4 GB operační paměti RAM a 2 vCPU (pro aktivní produkční prostředí se doporučuje 8 GB RAM).
- Dedikovaná doména: DNS záznam ukazující na veřejnou IP adresu hostitele (např.
plane.portelcore.com).
2. Správná instalace Docker Engine a Compose V2
Sección titulada «2. Instalación Correcta de Docker Engine y Compose V2»[!IMPORTANT]\r Se desaconseja el uso directo de
apt install docker.ioen repositorios básicos de Ubuntu, ya que instala paquetes obsoletos e incompatibles con el backend de Plane. Sigue este procedimiento estandarizado para instalar el motor oficial.
2.1. Odstranění konfliktních verzí (Čištění)
Sección titulada «2.1. Depuración de Versiones Conflictivas (Limpieza)»sudo apt-get remove docker docker-engine docker.io containerd runc2.2. Konfigurace oficiálního repozitáře Docker
Sección titulada «2.2. Configuración del Repositorio Oficial de Docker»Přidejte GPG klíče zabezpečeného oficiálního repozitáře 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. Instalace enginu a pluginu 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. Ověření modernizované verze
Sección titulada «2.4. Validación de la Versión Modernizada»Ověřte, že je orchestrační příkaz Docker Compose V2 správně integrován:
docker compose version# Salida esperada: Docker Compose version v2.x.x3. Konfigurace DNS a SSL (Cloudflare)
Sección titulada «3. Configuración de DNS y SSL (Cloudflare)»Aby nasazení fungovalo správně pod parametrem směrování --behind-proxy, proveďte konfiguraci ve svém administrátorském panelu DNS Cloudflare:
- DNS záznam (A): Vytvořte záznam
Apro svou subdoménu (plane), který směruje na veřejnou IP adresu vašeho serveru. - Stav proxy: Ujistěte se, že oranžový mrak je aktivní (Proxied).
- Šifrování SSL/TLS: Nastavte režim šifrování na Full nebo Full (Strict) v panelu Cloudflare.
4. Instalace a spuštění Plane
Sección titulada «4. Instalación y Puesta en Marcha de Plane»4.1. Vytvoření pracovního adresáře
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. Spuštění instalátoru v režimu Proxy
Sección titulada «4.2. Ejecución del Instalador en Modo Proxy»Tento krok je kritický pro přeskočení vlastní správy lokálních certifikátů TLS v Plane a delegování SSL na naši zabezpečenou proxy:
sudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"Skript stáhne obrazy základních služeb (valkey, postgres, minio, core backend a frontend) a spustí kontejnery na pozadí.
5. Referenční příručka nástroje Prime CLI
Sección titulada «5. Manual de Referencia de la Herramienta Prime CLI»Edice Plane Prime je centrálně spravována pomocí rozhraní příkazového řádku prime-cli, nainstalovaného na /bin/prime-cli.
Syntaxe spuštění:
sudo prime-cli [comando]A. Řízení životního cyklu stacku
Sección titulada «A. Control del Ciclo de Vida del Stack»prime-cli start: Spustí všechny definované kontejnery ve stacku. Užitečné, pokud byl host restartován.prime-cli stop: Pořádně zastaví kontejnery Plane. Musí se vždy spouštět před údržbou hostitele.prime-cli restart: V případě zpomalení provede úplný restart provozních kontejnerů.
B. Pokročilá konfigurace a údržba
Sección titulada «B. Configuración y Mantenimiento Avanzado»prime-cli configure: Otevře interaktivní konzolové menu pro správu proměnných prostředí, jako je SMTP, firemní úložiště S3/MinIO a tajné klíče aplikace.prime-cli upgrade: Aktualizuje Plane na nejnovější dostupnou verzi z oficiálního kanálu a provede migrace databáze. Před spuštěním se doporučuje vytvořit plnou zálohu.prime-cli repair: Obnovuje a opravuje závislosti nebo poškozené obrazy, pokud se spuštění aplikace nezdaří.prime-cli update-cli: Samostatně aktualizuje nástroj správyprime-cli.
C. Strategie zálohování
Sección titulada «C. Estrategia de Respaldos»prime-cli backup: Vytváří komprimovaný soubor.tar.gznebo.zips lokální databází MySQL/Postgres, přílohami úloh a konfigurací souboru.env. Ve výchozím nastavení se ukládá do/opt/plane/backups.prime-cli restore: Přepisuje aktuální stav načtením předchozího bodu obnovy.
D. Diagnostika a monitorování
Sección titulada «D. Diagnóstico y Monitoreo»prime-cli monitor: Zobrazuje výpis logů všech služeb v reálném čase.prime-cli healthcheck: Provádí interní kontroly stavu a hlásí stav Redis/Valkey, Postgres, Backend a frontendových mikroslužeb.
6. Řešení běžných problémů
Sección titulada «6. Resolución de Problemas Comunes»Chyba: „Permission Denied“ v terminálu Docker
Sección titulada «Error: “Permission Denied” en la Terminal de Docker»- Příčina: Aktuální konzolový uživatel nemá oprávnění k místnímu socketu
/var/run/docker.sock. - Trvalé řešení: Přidejte svého uživatele do provozní skupiny Docker:
Ventana de terminal sudo usermod -aG docker $USERnewgrp docker
Chyba: 502 Bad Gateway (Cloudflare Edge)
Sección titulada «Error: 502 Bad Gateway (Cloudflare Edge)»- Zkontrolujte stav místních kontejnerů:
sudo prime-cli healthcheck. - Ověřte, že reverzní proxy kontejneru Plane odpovídá na interním HTTP portu přiřazeném na hostiteli.
- Ujistěte se, že pravidla síťové brány firewall (např. UFW) neblokují interní komunikaci.

