Ir al contenido

마스터 매뉴얼: Plane의 배포 및 관리 (Prime 에디션)

Linux에서 Plane Commercial/Prime 에디션의 배포, Cloudflare를 통한 DNS 설정 및 prime-cli를 통한 관리에 대한 종합 기술 가이드입니다.

0조회

  1. 사전 조건 및 환경 준비
  2. Docker Engine 및 Compose V2 올바른 설치
  3. DNS 및 SSL (Cloudflare) 설정
  4. Plane 설치 및 실행
  5. Prime CLI 도구 참조 매뉴얼
  6. 자주 발생하는 문제 해결

주 포트(80 및 443)에서 안정적이고 충돌 없는 배포를 보장하기 위해 깨끗한 서버에서 인스턴스를 초기화해야 합니다:

  • 추천 운영 체제: Ubuntu Server 20.04 LTS, 22.04 LTS 또는 24.04 LTS.
  • 추천 최소 자원: 4GB RAM 및 2 vCPUs(실제 생산 환경의 경우 8GB RAM이 권장됩니다).
  • 전용 도메인: 호스트의 공용 IP(plane.portelcore.com)를 가리키는 DNS 레코드가 필요합니다.

[!IMPORTANT] Ubuntu 기본 저장소에서 apt install docker.io을 직접 사용하는 것은 권장되지 않습니다. 이는 Plane 백엔드와 호환되지 않는 오래된 패키지를 설치하기 때문입니다. 공식 엔진을 설치하려면 표준화된 절차를 따르십시오.

Ventana de terminal
sudo apt-get remove docker docker-engine docker.io containerd runc

공식 보안 Docker 저장소의 GPG 키를 추가하십시오:

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

Docker Compose V2의 오케스트레이션 명령어가 올바르게 통합되었는지 확인하십시오:

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

라우팅 파라미터 --behind-proxy 하에서 정상적인 배포를 위해 Cloudflare의 DNS 관리 패널에서 설정을 수행하세요:

  1. DNS 레코드 (A): 서브도메인 (plane)에 대한 A 입력을 생성하여 서버의 공용 IP 주소로 해석하세요.
  2. 프록시 상태: 주황색 클라우드가 활성화되어 있는지 확인하세요 (프록시).
  3. SSL/TLS 암호화: 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. 프록시 모드에서 설치 프로그램 실행

Sección titulada «4.2. Ejecución del Instalador en Modo Proxy»

이 단계는 Plane에서 로컬 TLS 인증서 자동 관리를 건너뛰고 SSL을 우리의 보안 프록시에 위임하기 위해 필수적입니다:

Ventana de terminal
sudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"

스크립트는 기본 서비스 이미지(Valkey, PostgreSQL, MinIO, 커널 백엔드 및 프론트엔드)를 다운로드하여 백그라운드에서 컨테이너를 시작합니다.


Plane Prime 편집판은 /bin/prime-cli에 설치된 명령줄 인터페이스 prime-cli를 통해 중앙에서 관리됩니다.

실행 구문:

Ventana de terminal
sudo prime-cli [comando]
  • prime-cli start: 스택에 정의된 모든 컨테이너를 시작합니다. 호스트가 재시작된 경우 유용합니다.
  • prime-cli stop: Plane의 컨테이너를 순서대로 중지합니다. 호스트 유지보수 전 항상 실행해야 합니다.
  • prime-cli restart: 성능 저하 시 운영 컨테이너에 완전 재시작을 적용합니다.
  • prime-cli configure: 콘솔에서 대화형 메뉴를 열어 SMTP, 기업용 S3/MinIO 저장소 및 애플리케이션 시크릿과 같은 환경 변수를 관리합니다.
  • prime-cli upgrade: 공식 채널의 최신 버전으로 Plane을 업데이트하고 데이터베이스 마이그레이션을 실행합니다. 실행 전 전체 백업을 권장합니다.
  • prime-cli repair: 애플리케이션 시작 실패 시 의존성 또는 이미지 손상을 복구합니다.
  • prime-cli update-cli: prime-cli 관리 도구를 별도로 업데이트합니다.
  • prime-cli backup: 로컬 MySQL/Postgres 데이터베이스, 작업 첨부파일 및 .env 설정을 포함한 압축 파일 .tar.gz 또는 .zip를 생성합니다. 기본적으로 /opt/plane/backups에 저장됩니다.
  • prime-cli restore: 이전 복구 포인트를 로드하여 현재 상태를 덮어씁니다.
  • prime-cli monitor: 모든 서비스의 실시간 로그 추적 정보를 표시합니다.
  • prime-cli healthcheck: 내부 상태 요청을 수행하고 Redis/Valkey, Postgres, 백엔드 및 프론트엔드 마이크로서비스의 상태를 보고합니다.

  • 원인: 현재 콘솔 사용자는 로컬 소켓 /var/run/docker.sock에 대한 권한이 없습니다.
  • 영구적 해결책: Docker 운영 그룹에 사용자 추가:
    Ventana de terminal
    sudo usermod -aG docker $USER
    newgrp docker
  1. 로컬 컨테이너 상태를 확인하세요: sudo prime-cli healthcheck.
  2. Plane 컨테이너의 역방향 프록시가 호스트에 할당된 내부 HTTP 포트에서 응답하는지 확인하세요.
  3. 네트워크 방화벽 지침(예: UFW)이 내부 통신을 차단하지 않도록 하세요.