edgeone-pages-deploy

EdgeOne Pages デプロイ スキル

あらゆるプロジェクトをEdgeOne Pagesにデプロイします。

⛔ 重要なルール（必ず守ってください）

1. CLI のバージョンは 1.2.30 以上であること — それより古い場合は再インストールします。古いバージョンのまま絶対に進めないでください。
2. デプロイ URL を途中で省略しないこと — EDGEONE_DEPLOY_URL にはアクセスに必要なクエリパラメーターが含まれています。常に完全な URL を出力してください。
3. ログイン前に、中国サイトかグローバルサイトかをユーザーに選んでもらうこと。 決めつけないでください。
4. ログイン方法を自動判定すること — デスクトップ環境ではブラウザログイン、ヘッドレス／リモート／CI 環境ではトークンログインを使用します。以下の判断表に従ってください。
5. トークンログインの後、トークンを今後のためにローカルに保存するかどうか、ユーザーに尋ねること。

---

デプロイの流れ

まず以下のチェックを実行し、その後、判断表に従ってください。

# Check 1: CLI installed and correct version?
edgeone -v

# Check 2: Already logged in?
edgeone whoami

# Check 3: Project already linked?
cat edgeone.json 2>/dev/null

# Check 4: Saved token exists?
cat .edgeone/.token 2>/dev/null

判断表

CLI バージョン	ログイン状態	アクション
未インストール、または 1.2.30 未満	—	→ CLI のインストールへ進む
≥ 1.2.30 ✓	ログイン済み	→ デプロイへ進む
≥ 1.2.30 ✓	未ログイン、保存済みトークンあり	→ トークンを使ったデプロイへ進む（保存済みトークンを使用）
≥ 1.2.30 ✓	未ログイン、保存済みトークンなし	→ ログインへ進む

---

CLI のインストール

npm install -g edgeone@latest

確認：edgeone -v — 出力が 1.2.30 以上であることを確認します。そうでない場合はインストールをやり直してください。

---

ログイン

1. ユーザーにサイトを選んでもらう

ログインコマンドを実行する前に、IDE の選択コントロール（ask_followup_question）を使用します。

EdgeOne Pages のサイトを選択してください：

• 中国 — 中国本土のユーザー向け（console.cloud.tencent.com）
• グローバル — 中国以外のユーザー向け（console.intl.cloud.tencent.com）

2. 環境を判定してログイン方法を選ぶ

条件	方法
ローカルのデスクトップ IDE（VS Code、Cursor など）	ブラウザログイン
リモート／SSH／コンテナー／CI／クラウド IDE／ヘッドレス	トークンログイン
ユーザーがトークンを明示的に希望	トークンログイン

ブラウザログイン

# China site
edgeone login --site china

# Global site
edgeone login --site global

ユーザーがブラウザー認証を完了するまで待ちます。完了すると、CLI に成功メッセージが表示されます。

トークンログイン

トークンログインでは edgeone login を使用しません。デプロイコマンドに -t を指定して、トークンを直接渡します。

トークンの取得方法をユーザーに案内します。

1. コンソールにアクセスします：
   • 中国：https://console.cloud.tencent.com/edgeone/pages?tab=settings
   • グローバル：https://console.intl.cloud.tencent.com/edgeone/pages?tab=settings
2. API Token → Create Token を選択し、トークンをコピーします

⚠️ ユーザーに注意を促します：トークンにはアカウントレベルの権限があります。リポジトリに絶対にコミットしないでください。

3. トークンをローカルに保存するか確認する

ユーザーからトークンを受け取った後、次のように尋ねます。

今後のデプロイのために、このトークンをローカルに保存しますか？

• はい — .edgeone/.token に保存します（次回から自動的に使用）
• いいえ — 今回のデプロイでのみ使用します

「はい」の場合：

mkdir -p .edgeone
echo "<token>" > .edgeone/.token
grep -q '.edgeone/.token' .gitignore 2>/dev/null || echo '.edgeone/.token' >> .gitignore

ユーザーに次のように確認します：「✅ トークンを .edgeone/.token に保存し、.gitignore に追加しました。」

---

デプロイ

ブラウザー認証済みのデプロイ

# Project already linked (edgeone.json exists)
edgeone pages deploy

# New project (no edgeone.json)
edgeone pages deploy -n <project-name>

<project-name>：プロジェクトのディレクトリー名から自動生成します。初回のデプロイ時に edgeone.json が自動的に作成されます。

トークンを使ったデプロイ

まず、保存済みトークンがあるか確認します。

cat .edgeone/.token 2>/dev/null

• 保存済みトークンが見つかった場合 → 使用し、ユーザーに「.edgeone/.token の保存済みトークンを使用しています」と伝えます
• 保存済みトークンがない場合 → ユーザーにトークンの入力を依頼します（上記の「トークンログイン」を参照）

# Project already linked
edgeone pages deploy -t <token>

# New project
edgeone pages deploy -n <project-name> -t <token>

トークンにはサイト情報が含まれているため、--site フラグは不要です。

手入力したトークンでデプロイに成功した後、保存するかどうかをユーザーに尋ねます（上記の「トークンをローカルに保存するか確認する」を参照）。

プレビュー環境へのデプロイ

edgeone pages deploy -e preview

ビルドの動作

CLI がフレームワークを自動検出し、ビルドを実行して、出力ディレクトリーをアップロードします。手動での設定は不要です。

---

⚠️ デプロイ出力の解析（重要）

edgeone pages deploy が成功すると、CLI は次の内容を出力します。

[cli][✔] Deploy Success
EDGEONE_DEPLOY_URL=https://my-project-abc123.edgeone.cool?<auth_query_params>
EDGEONE_DEPLOY_TYPE=preset
EDGEONE_PROJECT_ID=pages-xxxxxxxx
[cli][✔] You can view your deployment in the EdgeOne Pages Console at:
https://console.cloud.tencent.com/edgeone/pages/project/pages-xxxxxxxx/deployment/xxxxxxx

抽出ルール：

フィールド	抽出方法	⛔ 警告
アクセス URL	EDGEONE_DEPLOY_URL= の後に続く値全体	クエリ文字列全体（? とその後すべて）を含めてください。これらのパラメーターがないと、ページは読み込まれません
プロジェクト ID	EDGEONE_PROJECT_ID= の後に続く値	—
コンソール URL	「You can view your deployment...」の次の行	—

ユーザーに表示する内容：

✅ デプロイが完了しました！

• アクセス URL：https://my-project-abc123.edgeone.cool?<auth_query_params>
• コンソール URL：https://console.cloud.tencent.com/edgeone/pages/project/...

---

エラー処理

エラー	解決方法
command not found: edgeone	npm install -g edgeone@latest を実行します
ログイン中にブラウザーが開かない	トークンログインに切り替えます
"not logged in" エラー	edgeone whoami を実行して確認し、再ログインするかトークンを使用します
トークンによる認証エラー	トークンの有効期限が切れている可能性があります。コンソールで再生成します
プロジェクト名の競合	-n を指定して別の名前を使用します
ビルドの失敗	ログを確認してください。通常は依存関係の不足またはビルドスクリプトの問題です

---

CLI コマンドのリファレンス、環境変数、ローカル開発環境のセットアップ、トークン管理の詳細については、references/command-reference.md を参照してください。