Skip to content

CLI をインストールする ​

edge CLI は、HTTP API でできることをすべてターミナルやスクリプトから実行できます。 このページを終えると、CLI をインストールしてサインインし、フォルダをプレビュー deployment として公開できています。

Edge が有効な組織の DECA Cloud アカウントと、index.html を含むフォルダが必要です。 このページでは既存の distribution acme-marketing を使います。まだない場合は、先に 最初のサイトを公開する で作成してください。

1. インストール ​

bash
curl -fsSL https://cli.edge.deca-dev.com/install.sh | sh
powershell
irm https://cli.edge.deca-dev.com/install.ps1 | iex
bash
brew install resola-ai/tap/deca-edge
edge profile use edge.deca-dev.com

インストールスクリプトは、お使いのプラットフォーム用のバイナリを 1 つダウンロードし、公開されている チェックサムで検証してから PATH に配置します。CLI の接続先もこの環境に設定するため、Homebrew の場合だけ profile use の行が追加で必要です。

動作を確認します。

bash
edge version
text
edge 0.1.6 (c8ca7f4, 2026-10-24)

2. サインイン ​

bash
edge login
text
Opened 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 ではその経路に組織ロールを載せられないため、可能なときは既定のブラウザ ログインを使ってください。

サインイン情報はシステムのキーチェーンに保存されます。自分が誰で、何ができるかを確認します。

bash
edge whoami
text
api_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     default

3. フォルダを distribution に紐付ける ​

プロジェクトのフォルダで次を実行します。

bash
edge link --distribution acme-marketing --dir dist
text
✓ Linked to acme-marketing (d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)
  wrote .edge/project.json

リンクファイルには distribution の ID と公開するフォルダが記録されます。秘密情報は含まないため、 コミットしてチームで同じ公開先を共有できます。

4. プレビューを公開する ​

bash
edge deploy
text
Packing 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 01M4A7Q2XKJ9T3VN6P8RWS5BCD

edge deploy は公開の流れをすべて実行します。フォルダをファイルがルートに来る .tar.gz にまとめ、 deployment を作成し、アップロードと commit を行い、プレビューの準備ができるまで待ちます。

公開中のサイトは変わりません。 プレビュー URL を開いて確認してください。数秒間 404 が返る場合は、 プレビューがまだ各エッジロケーションに届いていないだけです。少し待って再読み込みしてください。

5. promote する ​

プレビューに問題がなければ次を実行します。

bash
edge deployments promote 01M4A7Q2XKJ9T3VN6P8RWS5BCD
text
Promote 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 を一度に実行できます。

次に読む ​