dispatch.yaml リファレンス

ルーティング ルールをオーバーライドするには、dispatch.yaml を使用します。dispatch.yaml を使用すると、URL 内のパスやホスト名に基づいて受信リクエストを特定のサービス(旧名: モジュール)に送信できます。たとえば、URL http://simple-sample.appspot.com/mobile/ へのリクエストをモバイル フロントエンドにルーティングする場合やすべての静的コンテンツをデフォルト サービスから提供する場合に、このファイルを使用します。

dispatch.yaml ファイルは Go ソースコードと同じディレクトリに配置する必要があります。

ディスパッチ設定ファイルのデプロイ

ディスパッチ設定ファイルをデプロイするには、次のコマンドを実行します。

gcloud

gcloud app deploy dispatch.yaml

appcfg

元の App Engine SDK をインストールする場合は、次のコマンドを実行できます。

appcfg.py update_dispatch [YOUR_APP_DIR]

すべてのディスパッチ ルールの削除

すべてのディスパッチ ルールを削除する手順は次のとおりです。

  1. dispatch.yaml ファイルの内容を、次のように編集します。

    dispatch:
    

  2. dispatch.yaml ファイルを App Engine にデプロイします。

dispatch:
  # Default service serves the typical web resources and all static resources.
  - url: "*/favicon.ico"
    service: default

  # Default service serves simple hostname request.
  - url: "simple-sample.appspot.com/"
    service: default

  # Send all mobile traffic to the mobile frontend.
  - url: "*/mobile/*"
    service: mobile-frontend

  # Send all work to the one static backend.
  - url: "*/work/*"
    service: static-backend

構文

dispatch.yaml ファイル内のルート要素は <dispatch-entries> であり、各エントリは以下の要素を含む <dispatch> 要素です。
要素 説明
service

url パターンに一致するリクエストを処理するサービスの名前を指定します。サービスは、以前はモジュールと呼ばれていました。

url

ホスト名と URL パスで構成可能な URL パターン。Glob 文字を使用してパターンを照合することができます。Glob 文字を指定できるのは、パターンの先頭と末尾のみです。

ディスパッチ ルールは cron の設定タスクキューの設定で使用される URL にも適用されることに注意してください。

/_ah/ で始まる URL パスは、ディスパッチ ファイルによってルーティングされません。

制限

ディスパッチ ファイルには最大 20 個のルーティング ルールを含めることができます。URL 文字列を指定するときに、100 文字を超えるホスト名やパスは使用できません。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Go の App Engine スタンダード環境