Ir al contenido

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.

0lecturas

  1. Predbežné požiadavky a príprava prostredia
  2. Správna inštalácia Docker Engine a Compose V2
  3. Konfigurácia DNS a SSL (Cloudflare)
  4. Inštalácia a uvedenie Plane do prevádzky
  5. Manuál referencie nástroja Prime CLI
  6. 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.io v 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)»
Ventana de terminal
sudo apt-get remove docker docker-engine docker.io containerd runc

2.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:

Ventana de terminal
# Instalar dependencias previas
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg -y
# Crear el llavero seguro en el sistema
sudo install -m 0755 -d /etc/apt/keyrings
# Descargar e importar la clave GPG
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
# Añadir el repositorio a las fuentes estables de Apt
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
Ventana de terminal
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Overte, či je príkaz na orchestráciu Docker Compose V2 správne integrovaný:

Ventana de terminal
docker compose version
# Salida esperada: Docker Compose version v2.x.x

Aby nasadenie fungovalo správne pod parametrom smerovania --behind-proxy, vykonajte konfiguráciu v ovládacom paneli DNS služby Cloudflare:

  1. Záznam DNS (A): Vytvorte záznam A pre váš poddoménu (plane) riešiaci sa na verejnú IP adresu vášho servera.
  2. Stav proxy: Uistite sa, že oranžová oblačnosť je aktívna (Proxied).
  3. Šifrovanie SSL/TLS: Konfigurujte režim šifrovania na Full alebo Full (Strict) v ovládacom paneli Cloudflare.

Ventana de terminal
mkdir plane-selfhost && cd plane-selfhost
curl -fsSL https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/install.sh -o setup.sh
chmod +x setup.sh

4.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:

Ventana de terminal
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:

Ventana de terminal
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.
  • 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ávy prime-cli nezávisle.
  • prime-cli backup: Vytvorí komprimovaný súbor .tar.gz alebo .zip s 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.
  • 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.

  • 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 $USER
    newgrp docker
  1. Skontrolujte stav lokálnych kontajnerov: sudo prime-cli healthcheck.
  2. Overte, či proxy server kontajnera Plane reaguje na pridelenom porte HTTP vo vnútri hostiteľa.
  3. Uistite sa, že smerovacie pravidlá brány firewall (napr. UFW) neblokujú internú komunikáciu.