Edgeファンクションのアクションとトリガーを使う

エッジ・ファンクションは、アクションとトリガーという2つの主要コンポーネントで構成されている。 アクションは JavaScript、エッジで実行されるロジックを定義するファイルです。 トリガーはURLに基づいたルーティングルールで、いつ、どのような状況下でアクションを実行するかを定義します。 トリガーは、特定のリクエストパターン（ドメインやパスなど）を適切なアクションに接続する。 関連するトリガーがなければ、アクションはトラフィックに影響を与えない。

エッジ機能アクション

アクションは、JavaScript で書かれているため、トリガー・イベントに応答するためにイベント・リスナーが必要です。 アクションは、トリガーによって使用されない限り、トラフィックに影響を与えない。

プランの違い

アクションを伴う場合の違いは、プランによる：

標準プラン

  • アカウントごとに1つのアクションのみ許可し、ドメイン名を自動的に付けます（名前は変更できません）。
  • アクションを更新するには、新しい JavaScript ファイルをアップロードするか、エディタで直接コードを編集してください。 新しいファイルのアップロードは、既存のアクションを置き換えます。
  • JavaScript ファイルをアップロードすると、そのファイル名は常にあなたのドメイン名に設定されます。

企業向けプラン

  • アップロードできるスクリプトの数は無制限。
  • アクションを作成する際、カスタム名を指定することができます。
  • JavaScript ファイルをアップロードする場合、アクション名はファイル名から取られます。

アクションの操作

アクションを作成、アップロード、編集、管理することで、トリガーイベントに反応してEdge機能が実行するロジックを定義できます。 コンソールは、それぞれのコア操作のためのツールを提供する：

  • アクションの作成- 組み込みのコードエディタを使用してアクションを追加するには、 作成をクリックします。 JavaScript コードを追加したら、 Save をクリックしてアクションを作成します。

  • アクションの読み込み- アクションテーブルから既存のアクションをクリックして、エディタで開きます。 これにより、変更を加えることなくコードを見ることができる。

  • アクションの更新- アクションを修正するには、リストのアクションをクリックしてエディタで開きます。 変更を加え、「 保存 」をクリックします。 変更を保存すると、更新されたアクションがアップロードされます。 アクションが使用中であれば、アップデートは即座に有効になる。

  • アクションのアップロード- アップロードをクリックして、 JavaScript ファイルをアップロードします。 既存のアクションと同じ名前のアクションをアップロードしたり作成したりすると、既存のアクションは上書きされます。 アップロードする前にアクションファイルの名前を変更するか、作成時に一意の名前を入力して、この動作を回避してください。

    アップロードは、名前がすでに存在するかどうかに応じて、アクションの作成または更新の一部として使用することもできます。

  • アクションの削除- アクションを削除するには、選択したアクションのテーブル行の削除アイコン クリックします。 アクションは、トリガーに関連付けられている間は削除できません。 アクションを削除するには、まずそのアクションを使用している全てのトリガーを削除する必要があります。 Uses " 列には、各アクションにリンクされているトリガーの数が表示されます。

  • トリガーを関連付ける- トリガーは、アクションを実行するために必要です。 トリガー タブからトリガーを追加し、既存のアクションのリストからアクションを選択する。 アクションテーブルの Uses 列には、各アクションに現在リンクされているトリガーの数が表示されます。

エッジ機能トリガー

トリガー（ルート）は、ドメインのトラフィックがどのようにアクションにルーティングされるかを決定する。 アカウントのドメインに基づく URL パターンを、事前に定義されたアクションに関連付ける。 URL パターンはドメインを含む必要があり、ドメインのプレフィックスとして、またはパスの最後にワイルドカードを含めることができる。 パスが指定されない場合、 / が暗黙的に追加される。 URL パターンには、infixワイルドカードやクエリーパラメーターを含めることはできません。

プランの違い

プランによってトリガーの仕組みに違いはない。 すべてのプランでトリガーの追加、編集、削除が可能です。

トリガーの操作

トリガーを追加する前にドメインを追加する必要があります。 トリガーは、トラフィックがエッジ機能のアクションにどのようにルーティングされるかを定義します。 トリガーは、 URL パターンを既存のアクションに接続する。

トリガーはアクションが存在しなくても作成できますが、アクションが選択されるまでロジックは起動しません。

  • トリガーを追加する- Triggers タブに行き、 Add triggerをクリックする。 URL パターンを入力し、既存のアクションリストからこのパターンに関連付けるアクションを選択する。 これにより、ルートとアクションの間のリンクが確立される。

    エッジ関数を実行せずにトリガー パスをアクティブにしておくには、 エッジ関数を回避するを有効にします。 例えば、 my-function が gamma.cistest-load.com/* に割り当てられているが、 gamma.cistest-load.com/data をバイパスさせたい場合、 /data 用に別のトリガーを作成し、 Avoid エッジ機能を有効にします。 これにより、 my-function を呼び出さずとも、 /data パスはアクティブなままとなる。

  • トリガーの編集- 変更したいトリガーのテーブル行で 編集 アイコン 編集アイコン をクリックし、変更を加えて セーブ をクリックする。

  • トリガの削除- 修正したいトリガのテーブル行で、 削除アイコン をクリックします。 このアクションは元に戻すことができません。 トリガーを削除すると、ルートとアクションの関連付けが削除されます。