Manuál Majstra: Nasadenie a Správa Plane (Edícia Prime)
Integrovaný technický návod pre nasadenie Plane Commercial/Prime Edition na Linuxe, konfigurácia DNS s Cloudflare a správa pomocou prime-cli.
🗺️ Mapa Cesty Nasadenia
Sección titulada «🗺️ Mapa de Ruta del Despliegue»- Predbežné požiadavky a príprava prostredia
- Správna inštalácia Docker Engine a Compose V2
- Konfigurácia DNS a SSL (Cloudflare)
- Inštalácia a uvedenie Plane do prevádzky
- Manuál referencie nástroja Prime CLI
- Riešenie bežných problémov
1. Predchádzajúce Požiadavky a Príprava Prostredia
Sección titulada «1. Requisitos Previos y Preparación del Entorno»Na zabezpečenie stabilného nasadenia a bezkonfliktného prístupu k hlavným portom (80 a 443), je potrebné inicializovať inštanciu na čistom serveri:
- Doporučený operačný systém: Ubuntu Server 20.04 LTS, 22.04 LTS alebo 24.04 LTS.
- Minimálne odporúčané zdroje: 4 GB pamäte RAM a 2 vCPUs (odporúča sa 8 GB RAM pre aktívne produkčné prostredia).
- Dedikovaná doména: Záznam DNS ukazujúci na verejnú IP adresu hostiteľa (napr.
plane.portelcore.com).
2. Správna Inštalácia Docker Engine a Compose V2
Sección titulada «2. Instalación Correcta de Docker Engine y Compose V2»[!IMPORTANT] Odporúča sa nepoužívať priamo
apt install docker.iov základných úložiskách Ubuntu, pretože inštaluje zastarané a nekompatibilné balíky s backendom Plane. Postupujte podľa tohto štandardizovaného postupu pre inštaláciu oficiálneho motora.
2.1. Odstraňovanie Konfliktovných Verzií (Čistenie)
Sección titulada «2.1. Depuración de Versiones Conflictivas (Limpieza)»sudo apt-get remove docker docker-engine docker.io containerd runc2.2. Konfigurácia Oficiálneho Repozitára Docker
Sección titulada «2.2. Configuración del Repositorio Oficial de Docker»Pridajte GPG kľúče bezpečného oficiálneho repozitára 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. Inštalácia motora 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. Validácia modernizovanej verzie
Sección titulada «2.4. Validación de la Versión Modernizada»Overte, či je príkaz na orchestráciu Docker Compose V2 správne integrovaný:
docker compose version# Salida esperada: Docker Compose version v2.x.x3. Konfigurácia DNS a SSL (Cloudflare)
Sección titulada «3. Configuración de DNS y SSL (Cloudflare)»Aby nasadenie fungovalo správne pod parametrom smerovania --behind-proxy, vykonajte konfiguráciu v ovládacom paneli DNS služby Cloudflare:
- Záznam DNS (A): Vytvorte záznam
Apre váš poddoménu (plane) riešiaci sa na verejnú IP adresu vášho servera. - Stav proxy: Uistite sa, že oranžová oblačnosť je aktívna (Proxied).
- Šifrovanie SSL/TLS: Konfigurujte režim šifrovania na Full alebo Full (Strict) v ovládacom paneli Cloudflare.
4. Inštalácia a spustenie Plane
Sección titulada «4. Instalación y Puesta en Marcha de Plane»4.1. Vytvorenie pracovného adresára
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. Spustenie inštalátora v režime proxy
Sección titulada «4.2. Ejecución del Instalador en Modo Proxy»Tento krok je kritický pre vynechanie vlastnej správy lokálnych certifikátov TLS v Plane a delegovanie SSL nášmu bezpečnému proxy:
sudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"Skript stiahne obrazy základných služieb (valkey, postgres, minio, core backend a frontend) a spustí kontajnery na pozadí.
5. Referenčná príručka pre nástroj Prime CLI
Sección titulada «5. Manual de Referencia de la Herramienta Prime CLI»Edícia Plane Prime je centralizovane spravovaná pomocou rozhrania príkazového riadku prime-cli, nainštalovaného v /bin/prime-cli.
Syntax spustenia:
sudo prime-cli [comando]A. Kontrola životného cyklu zásobníka
Sección titulada «A. Control del Ciclo de Vida del Stack»prime-cli start: Spustí všetky definované kontajnery v zásobníku. Užitočné, ak sa hostiteľ reštartoval.prime-cli stop: Usporiadané zastaví kontajnery Plane. Musí sa vždy vykonať pred údržbou hostiteľa.prime-cli restart: Aplikuje kompletný reštart na operačné kontajnery v prípade spomalenia.
B. Pokročilá konfigurácia a údržba
Sección titulada «B. Configuración y Mantenimiento Avanzado»prime-cli configure: Otvorí interaktívne menu v konzole pre správu premenných prostredia, ako sú SMTP, úložisko S3/MinIO a aplikované tajné kľúče.prime-cli upgrade: Aktualizuje Plane na najnovšiu dostupnú verziu z oficiálneho kanála, vykonáva migrácie databáze. Odporúča sa vykonať úplnú zálohu pred spustením.prime-cli repair: Obnoví a opraví závislosti alebo poškodené obrazy, ak zlyhá spustenie aplikácie.prime-cli update-cli: Aktualizuje nástroj správyprime-clinezávisle.
C. Stratégia zálohovania
Sección titulada «C. Estrategia de Respaldos»prime-cli backup: Vytvorí komprimovaný súbor.tar.gzalebo.zips lokálnou databázou MySQL/Postgres, prílohami úloh a konfiguráciou súboru.env. Uložené štandardne v/opt/plane/backups.prime-cli restore: Prepíše aktuálny stav načítaním predchádzajúceho bodu obnovy.
D. Diagnostika a monitorovanie
Sección titulada «D. Diagnóstico y Monitoreo»prime-cli monitor: Zobrazí výpis protokolov v reálnom čase zo všetkých služieb.prime-cli healthcheck: Vykoná interné žiadosti o zdravotnom stave a nahlási stav Redis/Valkey, Postgres, Backend a frontend mikroslužieb.
6. Riešenie bežných problémov
Sección titulada «6. Resolución de Problemas Comunes»Chyba: „Permission Denied“ v termináli Docker
Sección titulada «Error: “Permission Denied” en la Terminal de Docker»- Príčina: Aktuálny používateľ konzoly nemá privilégiá nad lokálnym socketom
/var/run/docker.sock. - Trvalé riešenie: Pridajte svojho používateľa do operačnej 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)»- Skontrolujte stav lokálnych kontajnerov:
sudo prime-cli healthcheck. - Overte, či proxy server kontajnera Plane reaguje na pridelenom porte HTTP vo vnútri hostiteľa.
- Uistite sa, že smerovacie pravidlá brány firewall (napr. UFW) neblokujú internú komunikáciu.

