すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:DCDN コンソールで EdgeRoutine を使用する

    ドキュメントセンター

    Edge Security Acceleration:DCDN コンソールで EdgeRoutine を使用する

    最終更新日:Jun 11, 2025

    このトピックでは、Dynamic Content Delivery Network（DCDN）コンソールで EdgeRoutine を有効化して使用する方法について説明します。

    重要

    DCDN は、2025 年 5 月 8 日 00:00 から 5 月 13 日 23:00（UTC + 08:00）まで、新規ユーザー向けに EdgeRoutine を段階的に廃止します。 現在のユーザーは影響を受けません。

    ESA にアップグレードしてEdge Routineを使用することをお勧めします。

    ワークフロー

    EdgeRoutine を使用するには、DCDN をアクティブ化する必要があります。 次の図は、EdgeRoutine でルーチンが作成および実装される方法を示しています。

    説明

    EdgeRoutine はベータリリースであり、一部のユーザーのみが利用できます。 DCDN サービスの 1 日のピーク帯域幅が 500 Mbit/s を超える場合は、チケットを送信して EdgeRoutine を有効にすることができます。 リクエストが承認されると、EdgeRoutine が DCDN コンソールの左側のナビゲーションウィンドウに表示されます。

    EdgeRoutine を有効にする

    1. DCDN コンソール にログオンします。

    2. 左側のナビゲーションウィンドウで、EdgeRoutine をクリックします。

    3. [ER を有効にする] > [今すぐアクティブ化] を選択して、EdgeRoutine を有効にします。

    ルーチンを作成および構成する

    1. DCDN コンソール にログオンします。

    2. 左側のナビゲーションウィンドウで、EdgeRoutine をクリックします。

    3. EdgeRoutine を初めて使用する場合は、サブドメインを作成します。

      1. エッジ関数 ページで、サブドメインの作成 をクリックします。

        image.png

      2. サブドメインの作成 ダイアログボックスで、サブドメイン名を指定します。

        説明

        • サブドメインは、作成したすべてのルーチンが配置されるリポジトリです。 サブドメインを作成したら、サブドメインの名前を変更することはできません。

        • サブドメインは、各ユーザーの一意の識別子であり、ルーチン ID の一部です。

        • サブドメインは、作成後に名前を変更することはできません。 名前に使用できるのは、小文字、数字、ハイフン（-）です。 名前の長さは 2 文字以上である必要があります。 例：subdomain-name。

      3. OK をクリックします。

    4. エッジ関数 ページで、関数の作成 をクリックします。 次の表にパラメータを示します。

      创建程序

      パラメータ

      説明

      関数名

      ルーチン名を入力します。

      説明

      名前には、小文字、数字、およびハイフン (-) を使用することができます。長さは必ず 2 文字以上にしてください (例：routine-name)。関数名は作成後に変更することができません。

      説明

      オプション。 ルーチンの説明を入力します。

      仕様

      ルーチンの 1 回の実行の最大 CPU 時間スライスを選択します。 ネットワーク応答を待機する I/O 時間は含まれません。 料金はルーチンの仕様によって異なります。 詳細については、「請求ルール」をご参照ください。

      • リクエストごとの CPU タイムスライス：5 ms、

      • リクエストごとの CPU タイムスライス：50 ms（デフォルト）

      • リクエストごとの CPU タイムスライス：100 ms

    5. ルーチンを作成したら、操作 列の 詳細 をクリックして、さまざまな環境でルーチンを構成します。 ルーチンの設定は、環境ごとに独立しています。 本番環境、テスト環境、カナリアリリース環境のルーチン設定を変更できます。 詳細については、「カナリア環境（オプション）」をご参照ください。 次の表にパラメータを示します。

      パラメータ

      説明

      関数の仕様

      ルーチンの 1 回の実行の最大 CPU 時間スライス。 ネットワーク応答を待機する I/O 時間は含まれません。 最大リアルタイム: 120 秒。 メモリ: 128 MB。

      • リクエストごとの CPU タイムスライス：5 ms、

      • リクエストごとの CPU タイムスライス：50 ms（デフォルト）

      • リクエストごとの CPU タイムスライス：100 ms

      ドメイン名のホワイトリスト

      • ルーチンに関連付けることができるドメイン名。

      • ワイルドカードドメイン名がサポートされています。

      • デフォルトでは、ドメイン名ホワイトリストは空です。 これは、任意のドメイン名をルーチンに関連付けることができることを示します。

      説明

      たとえば、[ドメイン名ホワイトリスト] パラメータを example.com に設定すると、example.com からのリクエストのみがルーチンをトリガーできます。

    ルーチンにドメイン名を関連付ける

    ルーチンは、クライアントにサービスを提供するためにドメイン名を必要とします。 ドメイン名は、CDN 高速化ドメイン名または DCDN 高速化ドメイン名にすることができます。 ルーチンを作成および構成したら、DCDN 高速化ドメイン名をルーチンに関連付ける必要があります。 その後、ルーチンは、ルーチンに関連付けられているドメイン名からのリクエストによってトリガーされます。 ドメイン名が追加されているサービスのコンソールにログオンします。

    1. DCDN コンソール にログオンします。

    2. 左側のナビゲーションウィンドウで、ドメイン名 をクリックします。

    3. ドメイン名 ページで、管理するドメイン名を見つけて、設定 をクリックします。

    4. 左側のナビゲーションウィンドウで、EdgeRoutine をクリックします。

    5. EdgeRoutine ページで、スイッチをオンにして、EdgeRoutine ID パラメータを構成します。 次の表にパラメータを示します。

      边缘程序

      パラメータ

      説明

      EdgeRoutine ID

      ルーチン ID は、各ルーチンの一意の識別子です。 フォーマット: routineName.subdomain。

      説明

      DCDN コンソールの左側のナビゲーションウィンドウで、EdgeRoutine をクリックします。 関数 ページでルーチンの ID を表示できます。

      image.png

      トリガーモード

      DCDN 高速化ドメイン名にアクセスしようとするリクエストがルーチンをトリガーするモードを選択します。 次のモードがサポートされています。

      • リダイレクト: DCDN 高速化ドメイン名にアクセスしようとするリクエストは、ルーチンによって処理されます。 リクエストを処理するために、ルーチンにコードを記述できます。 ルーチンは、リクエストされたコンテンツをクライアントに返したり、キャッシュ API を呼び出してキャッシュを読み取ったり、フェッチリクエストを送信してオリジンサーバーにリクエストをリダイレクトしたりできます。

      • バイパス: DCDN 高速化ドメイン名にアクセスしようとするリクエストは、ルーチンをトリガーします。 その後、DCDN コンソールで構成された設定が実行され、リクエストがオリジンサーバーにリダイレクトされます。 このトリガーモードは、認証やログ追跡などのシナリオに適しています。

      エラー時に配信元へリダイレクト

      • ○: ルーチンが例外をスローすると、ポイント オブ プレゼンス（POP）は、クライアントによってリクエストされた URL を使用して、DCDN 高速化ドメイン名のオリジンサーバーにリクエストを転送します。 オリジンサーバーはリクエストを処理します。 これにより、業務継続とディザスタリカバリが確保されます。

      • ×: ルーチンで例外がスローされると、エラーメッセージが返されます。

        説明

        • 初めてルーチンを使用する場合は、[エラー発生時にオリジンにリダイレクト] パラメーターを [いいえ] に設定することをお勧めします。返される HTTP 5xx 状態コードを使用して、問題のトラブルシューティングを行うことができます。

        • 例外が発生した場合、原点復帰リクエストの数に対して課金されます。異常な原点復帰リクエストの割合は非常に低いため、無視できます。

    ルーチンを開発およびデバッグする

    1. DCDN コンソール にログオンします。

    2. 左側のナビゲーションウィンドウで、EdgeRoutine をクリックします。

    3. 作成したルーチンを見つけ、[アクション] 列の 詳細 をクリックします。

    4. 表示されたルーチンページで、コード タブをクリックして、JavaScript を使用してルーチンを開発します。サンプルコードでは、HelloWorld スクリプトが使用されています。代码

    5. コーディングが完了したら、Publish to Test Environment をクリックします。ページに表示されているテスト環境の IP アドレスを、ルーチンをデバッグするために使用するマシンに関連付けることができます。

      説明

      テスト環境の IP アドレスとルーチンに関連付けられているドメイン名を、オンプレミスマシンの hosts ファイルに追加できます。たとえば、10.10.10.10 と example.com をオンプレミスマシンの hosts ファイルに追加します。IP アドレスを前の図に示されている IP アドレスに置き換え、ドメイン名をルーチンに関連付けられている DCDN 高速化ドメイン名に置き換えます。

    バージョンの保存

    デバッグが完了したら、新しいバージョンとして保存 を コード タブでクリックします。测试

    バージョンを公開する

    1. 表示されたルーチンページで、バージョン タブをクリックし、公開するバージョンを見つけ、操作 列の 公開 をクリックします。

    2. バージョンを公開する テスト環境、本番環境、または カナリアリリース環境 を選択します。

      説明

      スクリプトを本番環境に公開する前に、ルーチンをカナリアリリース環境に公開することを推奨します。

    3. OK をクリックして、すべての POP の本番環境にコードをデプロイします。

    反復

    前のセクションでは、HelloWorld を使用してルーチンの構成と公開方法を説明しました。

    • ルーチンの反復方法については、「ルーチンの開発とデバッグ」、「バージョンの保存」、および「バージョンの公開」のセクションをご参照ください。

    • ルーチンの仕様やドメイン名ホワイトリストなどの構成を調整する場合は、「ルーチンの作成と構成」セクションをご参照ください。

    • DCDN 高速化ドメイン名に対して EdgeRoutine を無効にする場合は、「ドメイン名をルーチンに関連付ける」セクションの手順に従って構成したルーチン構成を削除します。

    FAQ