Function Compute:Web 関数を使用した Web アプリケーションの作成

ステップ 1：アプリケーションの開発とテスト

1. ローカルマシンで新しいコマンドラインウィンドウを開き、次のコマンドを実行して、必要な Flask および tabulate ライブラリをインストールします。

   pip install Flask tabulate

2. code という名前のフォルダと、その中に app.py という名前のファイルを作成します。ファイルに次のサンプルコードを貼り付けます。このコードは、API としてパッケージ化されたシンプルなカレンダーサービスを実装します。この API は、2025 年 1 月などの年と月を受け取り、その月のカレンダーテーブルを返します。

   import calendar
   from flask import Flask, request
   from tabulate import tabulate
   import logging
   import json
   
   logger = logging.getLogger()
   app = Flask(__name__)
   
   
   @app.route("/", methods=["POST"])
   def get_month_calendar():
       # リクエスト ID を取得し、ログを出力します。
       requestId = request.headers.get('x-fc-request-id', '')
       logger.info("FC Invoke Start RequestId: " + requestId)
       # リクエストの内容を取得し、リクエストのフォーマットをチェックします。
       data = json.loads(request.stream.read().decode('utf-8'))
       if not ('year' in data and 'month' in data):
           message = "Request must be in format like {'year': '1999', 'month': '12'}"
           return message
   
       # カレンダーテーブルを取得します。
       result = print_calendar(year=int(data['year']), month=int(data['month']))
       # 結果が返される前に関数の実行が完了したことを示すログを出力します。
       logger.info("FC Invoke End RequestId: " + requestId)
       return result
   
   
   def print_calendar(year, month):
       # 指定された年月のカレンダーマトリックスを取得します。
       cal = calendar.monthcalendar(year, month)
       # その月に属さない日付を 0 から空の文字列に変更します。
       cal = list(map(lambda sublist: list(map(lambda x: '' if x == 0 else x, sublist)), cal))
       # テーブルヘッダーを作成します。
       headers = ["Mo", "Tu", "We", "Th", "Fr", "Sa", "Su"]
   
       # tabulate を使用してカレンダーテーブルを出力します。
       return tabulate(cal, headers=headers, tablefmt="grid", stralign='center', numalign='center')
   
   
   if __name__ == "__main__":
       app.run(host='0.0.0.0', port=9000)
   

3. python3 app.py コマンドを実行して Flask アプリケーションを実行します。出力に Running on http://127.0.0.1:9000 が表示された場合、Flask アプリケーションは実行中です。その後、cURL コマンドを使用してアプリケーションをテストできます。

   python3 app.py 
    * Serving Flask app 'app'
    * Debug mode: off
   WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
    * Running on http://127.0.0.1:9000
    * Running on http://47.100.XX.XX:9000
   Press CTRL+C to quit

4. 新しいターミナルウィンドウを開き、cURL を使用してサンプルリクエストを送信します。コマンドが成功すると、カレンダーテーブルが返されます。

   curl -X POST http://127.0.0.1:9000 -d '{"year": "2000", "month": "1"}'

   

これで、プロジェクトをローカルで作成し、テストが完了しました。

ステップ 2：コードパッケージの生成

Function Compute に適したコードパッケージをローカルでビルドします。コードパッケージには、次の内容が含まれている必要があります。

• Web アプリケーションに必要なプロジェクトファイル。

• アプリケーションにランタイムに含まれていない依存関係がある場合は、それらをコードパッケージに追加する必要があります。ランタイムの組み込みの依存関係については、「組み込みの依存関係」をご参照ください。

1. 依存関係のインストール：Web アプリケーションプロジェクトのルートディレクトリで、次のコマンドを実行して、必要な依存関係 (この例では tabulate) をそのディレクトリにインストールします。このコマンドは、プロジェクトのルートディレクトリに依存関係をインストールします。

   説明

   Python Web 関数ランタイムには、すでに Flask ライブラリが含まれています。サンプルアプリケーションを動作させるには、tabulate ライブラリのみをインストールする必要があります。

   pip install -t . tabulate

2. プロジェクトのルートディレクトリにあるすべてのファイルをパッケージ化します。

   Linux または macOS

   プロジェクトのルートディレクトリで、zip code.zip -r ./* コマンドを実行します。このコマンドは、プロジェクトファイルと依存関係を ZIP ファイルにパッケージ化し、コードパッケージを作成します。

   説明

   ディレクトリに対する読み取りおよび書き込み権限があることを確認してください。

   Windows

   プロジェクトディレクトリに移動し、すべてのファイルを選択して右クリックし、ZIP ファイルにパッケージ化します。これにより、プロジェクトファイルと依存関係が ZIP ファイルにパッケージ化され、コードパッケージが作成されます。

ステップ 3：関数の作成とデプロイ

1. Web 関数タイプの選択：Function Compute コンソールにログインします。左側のナビゲーションウィンドウで、関数管理 > 関数リスト をクリックします。上部のナビゲーションバーで、関数を作成するリージョンを選択します。表示されたページで、関数を作成 をクリックし、画面の指示に従って Web 関数 を作成します。

2. ランタイムの選択：次の図に示すように、カスタム実行時 を選択します。このランタイムには、Flask フレームワークで必要な依存関係が含まれています。

   説明

   • Web 関数には カスタム実行時 を使用することを推奨します。カスタム実行時 を使用すると、起動コマンドとリッスンポートを指定でき、同時リクエスト処理をサポートします。組み込み実行時 はこれらの機能を提供せず、他のクラウドサービスによって生成されるイベントの処理により適しています。

   • コンテナ化されたデプロイを希望する場合は、カスタムイメージ を使用して Web 関数を作成できます。このランタイムも同時リクエスト処理をサポートしますが、依存関係はご自身で管理する必要があります。

   • ランタイムの詳細な比較については、「ランタイムの選択」をご参照ください。

3. コードパッケージのデプロイ：図に示すように、ステップ 2 で作成した ZIP コードパッケージをアップロードします。起動コマンドを python3 app.py に、リッスンポートを 9000 に設定します。既存の Flask アプリケーションを移行する場合は、実際の起動コマンドとポートに基づいて設定を変更してください。たとえば、Flask のデフォルトポートは 5000 です。

   作成 をクリックし、関数が作成されるのを待ちます。

ステップ 4：関数のテスト

1. 関数 URL の取得：新しく作成された関数の詳細ページで、トリガー タブをクリックします。HTTP トリガーの設定で、パブリックエンドポイントをコピーします。

   テスト環境で認証が不要な場合は、HTTP トリガーの作成時または作成後に、トリガーの設定で 認証方法 を 認証不要 に変更できます。

   

2. 関数のテスト：cURL、Postman、または任意の HTTP クライアントを使用して関数を呼び出し、Flask アプリケーションが期待どおりに動作することを確認できます。次の例では cURL コマンドを使用します。URL を前のステップでコピーしたエンドポイントに置き換えてください。

   curl https://******.cn-hangzhou.fcapp.run -d '{"year": "2025", "month": "1"}' 

   Web API は 2025 年 1 月のカレンダー情報を返します。以下は出力のサンプルです。

   

   説明

   • デフォルトの HTTP トリガー設定を使用すると、コマンドは「MissingRequiredHeader」エラーを返します。テスト環境の場合、トリガーの 認証方法 を 認証不要 に変更できます。

   • このステップのサンプルコマンドと出力は、サンプルコードにのみ適用されます。既存のアプリケーションを移行する場合は、実際の API 名とパラメーターに基づいてサービスを呼び出してください。詳細については、「cURL を使用した関数のテスト」をご参照ください。

3. (任意) ブラウザからの関数へのアクセス：HTTP トリガーが提供するパブリックエンドポイントは、ブラウザで直接開くことができず (強制ダウンロードがトリガーされる場合があります)、テスト目的でのみ使用されます。ブラウザからのアクセスを有効にし、本番環境で使用するためには、関数にカスタムドメイン名をバインドすることを推奨します。詳細については、「カスタムドメイン名の設定」をご参照ください。

(任意) ステップ 5：リソースのクリーンアップ

さまざまな言語の依存関係パッケージの追加方法の詳細については、次のトピックをご参照ください。