すべてのプロダクト
Search

このプロダクト

    Edge Security Acceleration:DCDN コンソールでの EdgeRoutine の使用

    ドキュメントセンター

    Edge Security Acceleration:DCDN コンソールでの EdgeRoutine の使用

    最終更新日:Feb 12, 2026

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

    重要

    DCDN は、2025 年 5 月 1 日 00:00 (UTC+08:00) 以降、新規ユーザーに対する EdgeRoutine の提供を段階的に廃止します。既存ユーザーには影響しません。

    Functions and Pages を使用するには、ESA へのアップグレードをお勧めします。

    ワークフロー

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

    image
    説明

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

    EdgeRoutine の有効化

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

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

    3. 「[ER の有効化] → [今すぐアクティブ化]」を選択して、エッジルーチンを有効化します。

    ルーチンの作成と構成

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

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

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

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

        image.png

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

        説明

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

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

        • サブドメインは一度作成すると、その名前を変更することはできません。名前には、小文字、数字、ハイフン (-) を含めることができます。名前は 2 文字以上である必要があります。例: subdomain-name。

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

    4. [エッジルーチン] ページで、[ルーチンの作成] をクリックします。次の表では、パラメーターについて説明します。

      创建程序

      パラメーター

      説明

      関数名

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

      説明

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

      説明

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

      仕様

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

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

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

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

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

      パラメーター

      説明

      関数の仕様

      ルーチンの単一の実行に対する最大 CPU タイムスライス。ネットワーク応答を待機する I/O 時間は含まれません。最大リアルタイム: 120s。メモリ: 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 の高速化ドメイン名へのリクエストは、ルーチンによって処理されます。 ルーチンにコードを記述してリクエストを処理できます。 ルーチンは、リクエストされたコンテンツをクライアントに返す、Cache API を呼び出してキャッシュを読み取る、またはフェッチリクエストを送信してオリジンサーバーにリクエストをリダイレクトすることが可能です。

      • バイパス: Alibaba Cloud CDN/DCDN 高速化ドメイン名へのアクセスを試行するリクエストがこのルーティンをトリガーします。その後、Alibaba Cloud CDN/DCDN コンソールで設定された構成が実行され、リクエストはオリジンサーバーにリダイレクトされます。このトリガーモードは、認証やログトラッキングなどのシナリオに適しています。

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

      • ○: ルーティンで例外が発生した場合、ポイント・オブ・プレゼンス (POP) は、クライアントが要求した URL を使用して、DCDN で高速化された CDN ドメイン名のオリジンサーバーにリクエストを転送します。オリジンサーバーがリクエストを処理します。これにより、業務継続と災害復旧が保証されます。

      • ×: ルーチンで例外が発生した場合、 HTTP ステータスコード 5xx がクライアントに返されます。

        説明

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

        • 例外が発生した場合、back-to-origin リクエストの数に対して課金されます。異常な back-to-origin リクエストの割合は非常に低く、無視できます。

    ルーチンの開発とデバッグ

    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 を無効にする場合は、「ルーチンへのドメイン名の関連付け」セクションの手順に従って構成したルーチン構成を削除します。

    image

    よくある質問