mcpField
Z
zeabur-project-create

zeabur-project-create

github.com/zeaburクラウド・DevOps39179 回インストール7 週間前に更新
リポジトリ

zeabur-project-create について

zeabur-project-create は Zeabur CLI でプロジェクトを作成するスキルです。サーバー上で環境を用意するユーザー向けで、利用可能なサーバーを一覧し、選択後にテンプレートをデプロイできます。

主な機能

  1. 01サーバーとリージョン情報の一覧
  2. 02選択したサーバーでのプロジェクト作成
  3. 03プロジェクト ID の取得
  4. 04プロジェクトへのテンプレートデプロイ
  5. 05適切なサーバーの選択を必須化

活用シーン

  1. 01選択したサーバーでプロジェクトを作成
  2. 02プロジェクト設定後にテンプレートをデプロイ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zeabur/agent-skills --skill zeabur-project-create

インストール後、Claude Code で/zeabur-project-createを入力して読み込まれたか確認します。

詳細

Zeabur プロジェクトの作成

Zeabur CLI の実行には、必ず npx zeabur@latest を使用してください。 zeabur を直接実行したり、ほかのインストール方法を使用したりしないでください。npx が利用できない場合は、先に Node.js をインストールしてください。

リージョンの選択

リージョンコードをハードコードしたり、推測したりしないでください。 hnd1 や tpe1 などの古いリージョンコードは非推奨です。リージョンは、必ずユーザーのサーバーリストから判断してください。

ステップ 1 — ユーザーのサーバーを一覧表示します：

npx zeabur@latest server list -i=false --json

ステップ 2 — 使用するサーバーをユーザーに確認します：

サーバーのリスト（それぞれの名前、プロバイダー、リージョンを表示）をユーザーに提示し、どれを使うか選んでもらいます。ユーザーに代わってサーバーを選ばないでください。既存のサーバーがどれも適していない場合は、新しいサーバーをレンタルする選択肢も提示してください。

  • os が ZeaburOS のサーバーのみ、プロジェクトをホストできます。 Ubuntu を報告するサーバーには Zeabur サービスがなく、そのサーバーにプロジェクトを作成しようとすると失敗します。メニューから除外するか、「先に ZeaburOS のインストールが必要」として別に表示してください。デプロイ先として、黙って提示してはいけません。

  • ユーザーにサーバーがない場合は、zeabur-server-catalog スキルで選択肢を調べてから、zeabur-server-rent スキルでレンタルしてください。

ステップ 3 — 選択したサーバー ID に server- 接頭辞を付けてリージョンとして使用します：

リージョンコードの形式は server-<server-id> です。<server-id> はサーバーリストの出力に含まれるものを使用します。

一部のテンプレート（例：REQUIRE_DEDICATED_SERVER を含むテンプレート）は、専用サーバーにのみデプロイできます。Unsupported template (code: REQUIRE_DEDICATED_SERVER) が表示された場合、ユーザーには ZeaburOS を実行するサーバーが必要です。そのリージョンを使用してプロジェクトを再作成してください。レンタルすると Zeabur サービスのない Ubuntu がプロビジョニングされるため、そのサーバーにプロジェクトを作成する前に ZeaburOS をインストールする必要があります（zeabur-server-rent スキルを参照）。

プロジェクトの作成

# Create project with name and region (region must be server-<server-id>)
npx zeabur@latest project create -n "<project-name>" -r "server-<server-id>" -i=false --json

プロジェクト ID の取得

# List projects as JSON and extract project ID by name
PROJECT_ID=$(npx zeabur@latest project list -i=false --json | jq -r '.[] | select(.name == "<project-name>") | ._id')

テンプレートのプロジェクトへのデプロイ

# Deploy template file to specific project (non-interactive)
npx zeabur@latest template deploy -i=false --json \
  -f <template-file> \
  --project-id <project-id> \
  --var PUBLIC_DOMAIN=myapp \
  --var KEY=value

ワークフロー

# 1. Find server ID
npx zeabur@latest server list -i=false --json

# 2. Create project (use server-<id> from step 1)
npx zeabur@latest project create -n "wrenai-prod" -r "server-<server-id>" -i=false --json

# 3. Get project ID
PROJECT_ID=$(npx zeabur@latest project list -i=false --json | jq -r '.[] | select(.name == "wrenai-prod") | ._id')
echo "Project ID: $PROJECT_ID"
echo "Dashboard: https://zeabur.com/projects/$PROJECT_ID"

# 4. Deploy template — use the `zeabur-template-deploy` skill for detailed flags and troubleshooting
npx zeabur@latest template deploy -i=false --json -f template.yml --project-id $PROJECT_ID --var PUBLIC_DOMAIN=myapp

コメント

Markdown 対応