CLI をインストールする
edge CLI は、HTTP API でできることをすべてターミナルやスクリプトから実行できます。 このページを終えると、CLI をインストールしてサインインし、フォルダをプレビュー deployment として公開できています。
Edge が有効な組織の DECA Cloud アカウントと、index.html を含むフォルダが必要です。 このページでは既存の distribution acme-marketing を使います。まだない場合は、先に 最初のサイトを公開する で作成してください。
1. インストール
curl -fsSL https://cli.edge.deca-dev.com/install.sh | shirm https://cli.edge.deca-dev.com/install.ps1 | iexbrew install resola-ai/tap/deca-edge
edge profile use edge.deca-dev.comインストールスクリプトは、お使いのプラットフォーム用のバイナリを 1 つダウンロードし、公開されている チェックサムで検証してから PATH に配置します。CLI の接続先もこの環境に設定するため、Homebrew の場合だけ profile use の行が追加で必要です。
動作を確認します。
edge versionedge 0.1.6 (c8ca7f4, 2026-10-24)2. サインイン
edge loginOpened the sign-in page in your browser…
✓ Signed in as kenji@acme.example (organization acme, workspace default)ブラウザでサインインを完了し、Auth0 が求めたら組織を選んでください。CLI はループバックの コールバックで待機し、自動で完了します。Edge の権限は組織メンバーシップに付くため、この 手順を飛ばさないでください。
ブラウザのない環境(SSH、リモートコンテナ)では edge login --device でワンタイムコードを 使えます。Auth0 ではその経路に組織ロールを載せられないため、可能なときは既定のブラウザ ログインを使ってください。
サインイン情報はシステムのキーチェーンに保存されます。自分が誰で、何ができるかを確認します。
edge whoamiapi_url https://api.edge.deca-dev.com
expires_at 2026-10-10T10:12:44Z
organization_id acme
profile edge.deca-dev.com
scopes ["deployment.promote","deployment.read","deployment.write","distribution.read"]
token_source keychain
workspace_id default3. フォルダを distribution に紐付ける
プロジェクトのフォルダで次を実行します。
edge link --distribution acme-marketing --dir dist✓ Linked to acme-marketing (d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)
wrote .edge/project.jsonリンクファイルには distribution の ID と公開するフォルダが記録されます。秘密情報は含まないため、 コミットしてチームで同じ公開先を共有できます。
4. プレビューを公開する
edge deployPacking dist/ → bundle.tar.gz (14 files, 212 KB)
Created deployment 01M4A7Q2XKJ9T3VN6P8RWS5BCD
Uploaded
Committed — waiting for the preview…
✓ ready
Preview https://01m4a7q2xkj9t3vn6p8rws5bcd.preview.edge.deca-dev.com
The live site is unchanged. Promote with: edge deployments promote 01M4A7Q2XKJ9T3VN6P8RWS5BCDedge deploy は公開の流れをすべて実行します。フォルダをファイルがルートに来る .tar.gz にまとめ、 deployment を作成し、アップロードと commit を行い、プレビューの準備ができるまで待ちます。
公開中のサイトは変わりません。 プレビュー URL を開いて確認してください。数秒間 404 が返る場合は、 プレビューがまだ各エッジロケーションに届いていないだけです。少し待って再読み込みしてください。
5. promote する
プレビューに問題がなければ次を実行します。
edge deployments promote 01M4A7Q2XKJ9T3VN6P8RWS5BCDPromote 01M4A7Q2XKJ9T3VN6P8RWS5BCD to https://acme-marketing.edge.deca-dev.com? [y/N] y
✓ Live https://acme-marketing.edge.deca-dev.com訪問者に見える内容が変わるのはこの手順です。元に戻すこともできます。 edge deployments rollback --distribution acme-marketing で前の deployment に戻ります。 パッチ、公開、切り戻し を参照してください。
流れに慣れたら、edge deploy --promote で手順 4 と 5 を一度に実行できます。
次に読む
- GitHub から実行する: GitHub Actions から公開する
- ほかのパイプラインから実行する: CI で CLI を使う
- すべてのコマンド、フラグ、終了コード: CLI リファレンス