Ir al contenido

マスターマニュアル: Planeのデプロイと管理(プライムエディション)

LinuxでのPlane Commercial/Prime Editionのデプロイ、CloudflareによるDNS設定、およびprime-cliを用いた管理に関する包括的な技術ガイド。

0閲覧数

🗺️ デプロイメントロードマップ

Sección titulada «🗺️ Mapa de Ruta del Despliegue»
  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。
  • 最小推奨リソース: 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)»
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

2.3. エンジンとComposeプラグインのインストール

Sección titulada «2.3. Instalación del Motor y Plugin Compose»
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パネルで暗号化モードをフルまたはフル(厳格)に設定します。

4.1. ワーキングディレクトリの作成

Sección titulada «4.1. Creación del Directorio de Trabajo»
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、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 によって一元管理されます。

実行構文:

Ventana de terminal
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: 以前の復元ポイントを読み込んで、現在の状態を上書きします。
  • 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 $USER
    newgrp docker

エラー: 502 Bad Gateway (Cloudflare Edge)

Sección titulada «Error: 502 Bad Gateway (Cloudflare Edge)»
  1. ローカルコンテナの状態を確認します:sudo prime-cli healthcheck。
  2. Planeコンテナの逆プロキシがホストで割り当てられた内部HTTPポートに応答していることを確認してください。
  3. ネットワークファイアウォールの指示(例: UFW)が内部通信をブロックしていないことを確認してください。