Ir al contenido

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.

0čtení

  1. Prerekvizity a příprava prostředí
  2. Správná instalace Docker Engine a Compose V2
  3. Konfigurace DNS a SSL (Cloudflare)
  4. Instalace a nasazení Plane
  5. Referenční příručka nástroje Prime CLI
  6. Řešení běžných problémů

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).

[!IMPORTANT]\r Se desaconseja el uso directo de apt install docker.io en 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)»
Ventana de terminal
sudo apt-get remove docker docker-engine docker.io containerd runc

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

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

Ověřte, že je orchestrační příkaz Docker Compose V2 správně integrován:

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

Aby nasazení fungovalo správně pod parametrem směrování --behind-proxy, proveďte konfiguraci ve svém administrátorském panelu DNS Cloudflare:

  1. DNS záznam (A): Vytvořte záznam A pro svou subdoménu (plane), který směruje na veřejnou IP adresu vašeho serveru.
  2. Stav proxy: Ujistěte se, že oranžový mrak je aktivní (Proxied).
  3. Šifrování SSL/TLS: Nastavte režim šifrování na Full nebo Full (Strict) v panelu 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. 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:

Ventana de terminal
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í.


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í:

Ventana de terminal
sudo prime-cli [comando]
  • 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ů.
  • 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ávy prime-cli.
  • prime-cli backup: Vytváří komprimovaný soubor .tar.gz nebo .zip s 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.
  • 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.

  • 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 $USER
    newgrp docker
  1. Zkontrolujte stav místních kontejnerů: sudo prime-cli healthcheck.
  2. Ověřte, že reverzní proxy kontejneru Plane odpovídá na interním HTTP portu přiřazeném na hostiteli.
  3. Ujistěte se, že pravidla síťové brány firewall (např. UFW) neblokují interní komunikaci.