Edge Security Acceleration (ESA) は、エッジルーチンのライフサイクル全体を管理およびデバッグし、複数ファイルのプロジェクトをデプロイするための CLI ツールを提供します。
ESA CLI とは
ESA CLI は、ESA エッジルーチンのコマンドラインツールです。ESA CLI ツールを使用することで、以下のタスクを実行できます。
ルーチンの作成、バージョンのリリースとデプロイ、トリガー管理など、エッジルーチンのライフサイクル全体をローカルで管理します。
ローカルデバッグサービスを使用して、ローカルまたはイントラネット環境でルーチンをデバッグし、オンライン環境をシミュレートして機能テストを行います。
npm などのプロジェクト依存関係を自動的にパッケージ化およびビルドすることにより、複数ファイルのプロジェクトをデプロイします。たとえば、ローカルの Node.js プロジェクトをクラウドにデプロイします。
始める前に
ESA CLI を使用する前に、Node.js をインストールする必要があります。
yum install nodejs npmコマンドを実行して、Node.js と npm をインストールします。node -vコマンドを実行して、バージョンを表示します。
ESA CLI を使い始める
npm を使用して ESA CLI ツールをインストールし、CLI のバージョンとサポートされているコマンドを確認します。
npm install esa-cli -g # CLI をグローバルにインストールします。
esa -v # CLI のバージョンを表示します。
esa --help # CLI コマンドを表示します。アカウントにログインします。Alibaba Cloud RAM コンソール にログインして、
AccessKey SecretとAccessKey IDを取得します。次に、esa loginコマンドを実行して、ログインプロセスを完了します。ESA CLI ツールを使用してローカルでコードをデバッグするだけの場合は、アカウントにログインする必要はありません。
esa login # ログイン
esa logout # ログアウトプロジェクトを初期化します。これには、プロジェクト名入力とテンプレート選択が含まれます。初期化コマンドのガイダンスに基づいてプロセス全体を完了できます。
esa initローカルデバッグ。コーディングタスクが完了したら、ESA CLI ツールを使用してローカルでデバッグできます。ローカルデバッグ。コーディングタスクが完了したら、ESA CLI ツールを使用してローカルでデバッグできます。実行した後、
esa devコマンドを実行すると、エントリファイルが自動的にパッケージ化され、ローカルデバッグサービスが開始されます。 コマンドを実行すると、エントリファイルが自動的にパッケージ化され、ローカルデバッグサービスが開始されます。
bを押して、ブラウザでデバッグ ページを開きます。[押す]
dを押して、デバッグウィザードを表示します。注：Chrome では、コマンドラインからデバッグページを開くことはできません。 Chrome で を表示して、デバッグ ウィザードを表示します。注: Chrome では、コマンドラインからデバッグ ページを開くことはできません。chrome://inspect#devicesページを開くと、実行中の ページを Chrome で開き、実行中のRemote Targetが表示されます。をクリックします。inspectをクリックして、コンソールの情報を表示します。 エッジルーチンはサーバー側で動作することに注意してください。これは、エントリファイルからの コンソールの情報を表示します。 エッジルーチンはサーバー側で動作することに注意してください。これはconsoleログがプレビューページのコンソールに表示されないことを示しています。エントリファイルからのログは、プレビューページのコンソールに表示されません。 使用できるのは、inspect機能を使用してのみデバッグできます。 デバッグする機能。コンソールをクリアするには、
cを押します。デバッグを終了するには、
xを押します。一時的にポートを指定するには、
esa dev --port <port>コマンドを実行します。
バージョンの生成。ローカルでのデバッグが完了したら、デプロイ用のコードのバージョンを生成する必要があります。
esa commit # バージョンを生成します。オンラインデプロイメント。バージョンが生成された後、デプロイメントコマンドを使用して Alibaba Cloud の POP にコードをデプロイします。
esa deploy # デプロイするバージョンとターゲット環境を選択します。
esa deployments list # デプロイステータスを表示します。
esa deployments delete <versionId> # バージョンを削除します。トリガーを管理する
コードが ESA POP にデプロイされた後、トリガーを設定し、そのトリガーを使用してエッジルーチンを呼び出すことができます。エッジルーチンは、2 つのトリガーメソッドをサポートしています。
ドメイン名: Webサイトのドメイン名をルーチンに関連付けます。このドメインは、お客様の ESA サイトであるため、ドメイン名を使用してルーチンにアクセスできます。 エッジルーチンはそのドメインのオリジンとして機能します。：Web サイトのドメイン名をルーチンに関連付けます。このドメインは、 サイトのサブドメインである必要があります。そのため、ドメイン名を使用してルーチンにアクセスできます。 エッジルーチンは、そのドメインのオリジンとして機能します。
ルート: リクエスト URL をマップするルートを作成しますESA サイトをルーチンに関連付けます。リクエストがルートと一致する場合、ルーチンが呼び出されます。 オリジンサーバーと通信するためのエッジルーチン。： サイトのリクエスト URL をルーチンにマッピングするルートを作成します。リクエストがルートと一致するとルーチンが呼び出され、エッジルーチンがオリジンサーバーと通信できるようになります。
# ドメイン名
esa domain list
esa domain add <domainName> # ドメイン名は、インターネットコンテンツプロバイダー (ICP) に申請する必要があります。
esa domain delete <domainName>
# ルート
esa route list
esa route add [route] [site]
esa route delete <route>ルーチンを管理する。
ESA CLI ツールを使用して、ルーチンを表示および削除します。
esa routine list # ルーチンのリストを表示します。
esa routine delete <RoutineName> # ルーチンを削除します。共通コマンド
ESA CLI は、エッジルーチンを管理するためのコマンドを提供します。以下に、いくつかの一般的なコマンドパラメーターを示します。
init
プロジェクトを開始します。ESA が提供するテンプレートを選択して、プロジェクトの初期化を完了します。
dev
ローカルデバッグサービスを自動的に有効にします。
commit
プロジェクトコードを送信します。プロジェクトコードをクラウドに送信して、バージョンとして保存できます。
deploy
バージョンをデプロイします。特定のバージョンをすべてのオンライン ESA プレゼンスポイント (POP) にデプロイします。
deployments
現在のバージョンのデプロイステータスを表示するか、特定のバージョンを削除します。
routine
すべての エッジルーチンを表示するか、特定のルーチンを削除します。
site
アカウント下のすべての Web サイトに関する情報を表示します。
domain
エッジルーチンに関連付けられたドメイン名を管理します。
route
エッジルーチンに関連付けられたルートを管理します。
login
アクセスキー (AK) またはシークレットキー (SK) を使用してアカウントにログインします。
logout
ログオフします。
config
ESA CLI の構成ファイルを管理します。
lang
ESA CLI の言語を選択します。