マスターマニュアル: Planeのデプロイと管理(プライムエディション)
LinuxでのPlane Commercial/Prime Editionのデプロイ、CloudflareによるDNS設定、およびprime-cliを用いた管理に関する包括的な技術ガイド。
🗺️ デプロイメントロードマップ
Sección titulada «🗺️ Mapa de Ruta del Despliegue»- 事前要件と環境準備
- Docker EngineおよびCompose V2の適切なインストール
- DNSとSSL設定(Cloudflare)
- Planeのインストールと起動
- Prime CLIツールのリファレンスマニュアル
- 一般的なトラブルシューティング
主要ポート(80 および 443)で競合のない、安定したデプロイを実現するために、クリーンなサーバー上でインスタンスを初期化する必要があります:
- 推奨オペレーティングシステム: Ubuntu Server 20.04 LTS、22.04 LTS、または24.04 LTS。
- 最小推奨リソース: 4 GB RAMと2 vCPU(8 GB RAMはアクティブな本番環境に推奨されます)。
- 専用ドメイン: ホストのパブリック IP を指す DNS レコード(例:
plane.portelcore.com)。
2. Docker EngineおよびCompose V2の正しいインストール
Sección titulada «2. Instalación Correcta de Docker Engine y Compose V2»[!IMPORTANT]
apt install docker.ioを Ubuntu の基本リポジトリから直接使用することは推奨されません。これは、Plane のバックエンドと互換性のない古いパッケージをインストールするためです。公式エンジンをインストールするには、以下の標準化された手順に従ってください。
2.1. 互換性のないバージョンの削除(クリーンアップ)
Sección titulada «2.1. Depuración de Versiones Conflictivas (Limpieza)»sudo apt-get remove docker docker-engine docker.io containerd runc2.2. 公式Dockerリポジトリの設定
Sección titulada «2.2. Configuración del Repositorio Oficial de Docker»信頼できる公式DockerリポジトリのGPGキーを追加してください:
# 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. エンジンと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. 最新バージョンの検証
Sección titulada «2.4. Validación de la Versión Modernizada»Docker Compose V2オーケストレーションコマンドが正しく統合されているか確認してください:
docker compose version# Salida esperada: Docker Compose version v2.x.x3. DNSとSSL設定(Cloudflare)
Sección titulada «3. Configuración de DNS y SSL (Cloudflare)»--behind-proxy ルーティングパラメーターでデプロイが正常に動作するよう、Cloudflare の DNS 管理パネルで次の設定を行います:
- DNS レコード(A): サブドメイン(
plane)に対するAエントリを作成し、サーバーのパブリック IP アドレスに解決するようにします。 - プロキシ状態: オレンジのクラウドがアクティブ(プロキシ済み)であることを確認してください。
- SSL/TLS暗号化: Cloudflareパネルで暗号化モードをフルまたはフル(厳格)に設定します。
4. Planeのインストールと起動
Sección titulada «4. Instalación y Puesta en Marcha de Plane»4.1. ワーキングディレクトリの作成
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. プロキシモードでインストーラーを実行する
Sección titulada «4.2. Ejecución del Instalador en Modo Proxy»このステップは、PlaneでローカルTLS証明書の自己管理をバイパスし、SSLを信頼できるプロキシに委譲するために重要です:
sudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"スクリプトは、ベースサービスのイメージ(valkey、postgres、minio、coreバックエンド、フロントエンド)をダウンロードし、バックグラウンドでコンテナを起動します。
5. Prime CLIツールリファレンスマニュアル
Sección titulada «5. Manual de Referencia de la Herramienta Prime CLI»Plane Prime エディションは、/bin/prime-cli にインストールされたコマンドラインインターフェース prime-cli によって一元管理されます。
実行構文:
sudo prime-cli [comando]A. スタックライフサイクル制御
Sección titulada «A. Control del Ciclo de Vida del Stack»prime-cli start: スタック内で定義されたすべてのコンテナを起動します。ホストを再起動した場合に便利です。prime-cli stop: Plane のコンテナを順序よく停止します。ホストのメンテナンス前には常に実行してください。prime-cli restart: 動作中のコンテナのパフォーマンスが低下した場合に、完全な再起動を適用します。
B. オーディエンス構成とメンテナンス
Sección titulada «B. Configuración y Mantenimiento Avanzado»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: 以前の復元ポイントを読み込んで、現在の状態を上書きします。
D. 診断とモニタリング
Sección titulada «D. Diagnóstico y Monitoreo»prime-cli monitor: すべてのサービスのログトレースをリアルタイムでダンプ表示します。prime-cli healthcheck: 内部ヘルスチェックを実行し、Redis/Valkey、Postgres、バックエンド、フロントエンドマイクロサービスの状態をレポートします。
6. 一般的な問題のトラブルシューティング
Sección titulada «6. Resolución de Problemas Comunes»エラー: Dockerターミナルで「権限がありません」
Sección titulada «Error: “Permission Denied” en la Terminal de Docker»- 原因: 現在のコンソールユーザーには、ローカルソケット
/var/run/docker.sockに対する権限がありません。 - 恒久的な解決策: ユーザーをDockerの運用グループに追加します:
Ventana de terminal sudo usermod -aG docker $USERnewgrp docker
エラー: 502 Bad Gateway (Cloudflare Edge)
Sección titulada «Error: 502 Bad Gateway (Cloudflare Edge)»- ローカルコンテナの状態を確認します:
sudo prime-cli healthcheck。 - Planeコンテナの逆プロキシがホストで割り当てられた内部HTTPポートに応答していることを確認してください。
- ネットワークファイアウォールの指示(例: UFW)が内部通信をブロックしていないことを確認してください。

