Podręcznik: wdrożenie i zarządzanie Plane (Edycja Prime)
Kompleksowy przewodnik techniczny dotyczący wdrożenia Plane Commercial/Prime Edition w systemie Linux, konfiguracji DNS z Cloudflare i administracji za pomocą prime-cli.
🗺️ Mapa drogowa wdrożenia
Sección titulada «🗺️ Mapa de Ruta del Despliegue»- Wymagania Wstępne i Przygotowanie Środowiska
- Poprawna Instalacja Silnika Docker i Compose V2
- Konfiguracja DNS i SSL (Cloudflare)
- Instalacja i Uruchomienie Plane
- Podręcznik Referencyjny Narzędzia Prime CLI
- Rozwiązywanie Powszechnych Problemów
1. Wymagania wstępne i przygotowanie środowiska
Sección titulada «1. Requisitos Previos y Preparación del Entorno»Aby zapewnić stabilne i wolne od konfliktów wdrażanie w głównych portach (80 i 443), wymagane jest zainicjowanie instancji na czystym serwerze:
- Zalecany System Operacyjny: Ubuntu Server 20.04 LTS, 22.04 LTS lub 24.04 LTS.
- Zalecane Minimalne Zasoby: 4 GB pamięci RAM i 2 vCPUs (zalecane 8 GB pamięci RAM dla aktywnych środowisk produkcyjnych).
- Własny Domena: Rekord DNS wskazujący na publiczny adres IP hosta (np.
plane.portelcore.com).
2. Poprawna instalacja Docker Engine i Compose V2
Sección titulada «2. Instalación Correcta de Docker Engine y Compose V2»[!IMPORTANT] Odradza się bezpośrednie użycie
apt install docker.iow podstawowych repozytoriach Ubuntu, ponieważ instaluje nieaktualne pakiety niezgodne z backendem Plane. Postępuj zgodnie z tym standardowym procedurą, aby zainstalować oficjalny silnik.
2.1. Usuwanie konfliktowych wersji (czyszczanie)
Sección titulada «2.1. Depuración de Versiones Conflictivas (Limpieza)»sudo apt-get remove docker docker-engine docker.io containerd runc2.2. Konfiguracja oficjalnego repozytorium Docker
Sección titulada «2.2. Configuración del Repositorio Oficial de Docker»Dodaj klucze GPG bezpiecznego oficjalnego repozytorium 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. Instalacja silnika i wtyczki 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. Weryfikacja zmodernizowanej wersji
Sección titulada «2.4. Validación de la Versión Modernizada»Sprawdź, czy polecenie orkiestracji Docker Compose V2 jest poprawnie zintegrowane:
docker compose version# Salida esperada: Docker Compose version v2.x.x3. Konfiguracja DNS i SSL (Cloudflare)
Sección titulada «3. Configuración de DNS y SSL (Cloudflare)»Aby wdrożenie działało poprawnie pod parametrem routingu --behind-proxy, wykonaj konfigurację w panelu administracyjnym DNS Cloudflare:
- Rejestr DNS (A): Utwórz wpis
Adla swojej subdomeny (plane) rozwiązując w kierunku publicznego adresu IP serwera. - Stan proxy: Upewnij się, że chmura pomarańczowa jest aktywna (Przekierowana).
- Szyfrowanie SSL/TLS: Skonfiguruj tryb szyfrowania na Pełne lub Pełne (Ścisłe) w panelu Cloudflare.
4. Instalacja i uruchomienie Plane
Sección titulada «4. Instalación y Puesta en Marcha de Plane»4.1. Utworzenie katalogu roboczego
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. Uruchomienie instalatora w trybie proxy
Sección titulada «4.2. Ejecución del Instalador en Modo Proxy»Ten krok jest krytyczny, aby pominąć automatyczne zarządzanie certyfikatami TLS lokalnymi w Plane i delegować SSL do naszego bezpiecznego proxy:
sudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"Skrypt pobierze obrazy podstawowych usług (valkey, postgres, minio, backend i frontend) i uruchomi kontenery w tle.
5. Podręcznik referencyjny narzędzia Prime CLI
Sección titulada «5. Manual de Referencia de la Herramienta Prime CLI»Edycja Plane Prime jest zarządzana centralnie za pomocą interfejsu wiersza polecenia prime-cli, zainstalowanego w /bin/prime-cli.
Składnia wykonania:
sudo prime-cli [comando]A. Kontrola cyklu życia stosu
Sección titulada «A. Control del Ciclo de Vida del Stack»prime-cli start: Uruchamia wszystkie zdefiniowane kontenery w stosie. Przydatne, jeśli host został ponownie uruchomiony.prime-cli stop: Zatrzymuje kontenery Plane w sposób uporządkowany. Należy go uruchomić zawsze przed przeprowadzeniem konserwacji hosta.prime-cli restart: Wykonuje pełne restartowanie kontenerów operacyjnych w przypadku spowolnienia.
B. Zaawansowana konfiguracja i konserwacja
Sección titulada «B. Configuración y Mantenimiento Avanzado»prime-cli configure: Otwiera interaktywne menu w konsoli do zarządzania zmiennymi środowiskowymi, takimi jak SMTP, magazyn S3/MinIO dla firm i sekrety aplikacji.prime-cli upgrade: Aktualizuje Plane do najnowszej wersji dostępnej w oficjalnym kanale, wykonując migracje bazy danych. Zalecane jest wykonanie pełnego kopii zapasowej przed jego uruchomieniem.prime-cli repair: Przywraca i naprawia uszkodzone zależności lub obrazy, jeśli uruchomienie aplikacji nie powiedzie się.prime-cli update-cli: Niezależnie aktualizuje narzędzie do zarządzaniaprime-cli.
C. Strategia tworzenia kopii zapasowych
Sección titulada «C. Estrategia de Respaldos»prime-cli backup: Generuje skompresowany plik.tar.gzlub.zipz lokalną bazą danych MySQL/Postgres, plikami załączników zadań i konfiguracją pliku.env. Domyślnie zapisywany w/opt/plane/backups.prime-cli restore: Nadpisuje bieżący stan, ładując poprzedni punkt przywracania.
D. Diagnostyka i monitorowanie
Sección titulada «D. Diagnóstico y Monitoreo»prime-cli monitor: Wyświetla wydumpowane ślady logów w czasie rzeczywistym ze wszystkich usług.prime-cli healthcheck: Wykonuje wewnętrzne żądania kondycji i raportuje stan Redis/Valkey, Postgres, Backend i mikrousług frontend.
6. Rozwiązywanie typowych problemów
Sección titulada «6. Resolución de Problemas Comunes»Błąd: „Permission Denied” w terminalu Docker
Sección titulada «Error: “Permission Denied” en la Terminal de Docker»- Przyczyna: Bieżący użytkownik konsoli nie ma uprawnień do gniazda lokalnego
/var/run/docker.sock. - Rozwiązanie stałe: Dodaj swojego użytkownika do grupy operacyjnej Docker:
Ventana de terminal sudo usermod -aG docker $USERnewgrp docker
Błąd: 502 Bad Gateway (Cloudflare Edge)
Sección titulada «Error: 502 Bad Gateway (Cloudflare Edge)»- Sprawdź stan kontenerów lokalnych:
sudo prime-cli healthcheck. - Sprawdź, czy proxy zwrotne kontenera Plane odpowiada na wewnętrznym porcie HTTP przypisanym na hoście.
- Upewnij się, że reguły zapory sieciowej (np. UFW) nie blokują komunikacji wewnętrznej.

