Function Compute:イベントハンドラ

クイックスタート

以下の Python 3.10 向け Flask の例は、最小限のイベントハンドラを示しています。

from flask import Flask, request

REQUEST_ID_HEADER = 'x-fc-request-id'

app = Flask(__name__)

@app.route("/invoke", methods=["POST"])
def handler():
    # 共通ヘッダーからリクエスト ID を抽出
    rid = request.headers.get(REQUEST_ID_HEADER)
    print("FC Invoke Start RequestId: " + rid)

    # イベントペイロードを読み取り
    data = request.stream.read()
    print(str(data))

    print("FC Invoke End RequestId: " + rid)
    # 応答ボディを返す
    return "Hello, World!"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=9000)

主なポイント：

• @app.route("/invoke", methods=["POST"]) により、<code code-type="xCode" data-tag="code">POST /invoke パスに対するハンドラが登録されます。

• <code code-type="xCode" data-tag="code">request.headers.get(REQUEST_ID_HEADER) により、共通ヘッダーからリクエスト ID を読み取ります。

• <code code-type="xCode" data-tag="code">request.stream.read() により、リクエストボディからイベントペイロードを読み取ります。

• <code code-type="xCode" data-tag="code">return "Hello, World!" は、応答本文を呼び出し元に送信します。

仕組み

関数が呼び出されると、Function Compute はリクエストを 3 つのステップで HTTP サーバーにルーティングします。

1. Function Compute は、実行時コンテキスト（リクエスト ID、関数名、一時的な資格情報など）を含む共通ヘッダーとともに、イベントペイロードをリクエストボディとして、HTTP サーバーの POST /invoke に送信します。

2. HTTP サーバーがイベントを処理し、ビジネスロジックを実行します。

3. サーバーは応答ボディとして結果を返します。Function Compute はこのボディを呼び出し元に配信します。

また、新しいインスタンスが起動する際に、Function Compute は POST /initialize リクエストを送信します。モデルの読み込みやデータベース接続の確立など、1 回限りの初期化処理が必要な場合は、このパスを実装してください。

リクエストおよび応答の仕様

その他の言語での例

Serverless Devs を使用すると、数回のクリック操作でアプリケーションを Function Compute に移行できます。以下の例では、Serverless Devs を用いて関数を効率的にデプロイおよび呼び出す方法を示します。サンプルコードは、ご自身のビジネス要件に応じて変更可能です。

• PHP

• Go

• Node.js

• Python

• Ruby

• C++

• TypeScript

• PowerShell

• Lua

• Dart

• Rust

よくある質問

• カスタムランタイムのリスニングポートは、カスタムランタイムの HTTP サーバーのポートと同一である必要がありますか？

• カスタムランタイムで起動したサービス内でサードパーティ製サービスを呼び出した際、FunctionNotStarted エラーが発生した場合の対処方法を教えてください。

• 関数が予期せず終了し、「Process exited unexpectedly before completing request」というメッセージが報告された場合の対処方法を教えてください。

• ブラウザまたは cURL ツールを使用して関数にアクセスした際に 404 エラーが発生した場合の対処方法を教えてください。