Function Compute:Web 関数を使用して Web アプリケーションを迅速に作成する

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

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

   pip install Flask tabulate

2. 「code」という名前のフォルダと、そのフォルダ内に「app.py」という名前のファイルを作成します。次のサンプルコードをファイルに貼り付けます。このコードは、シンプルなカレンダーサービスを実装し、API としてカプセル化します。ユーザーが 2025 年 1 月などの年と月を指定すると、API は対応するカレンダーテーブルを返します。

   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 a format such as {'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 アプリケーションで必要なプロジェクトファイル。

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

1. 依存関係のインストール: Web アプリケーションプロジェクトのルートディレクトリで、次のコマンドを実行して、必要な依存ライブラリ (この例では tabulate) をディレクトリにインストールします。コマンドが実行されると、プロジェクトのルートディレクトリにプロジェクトファイルと依存ライブラリが含まれます。

   説明

   Web 関数の Python ランタイムには、すでに Flask ライブラリが含まれています。したがって、サンプルアプリケーションの要件を満たすには、tabulate をインストールするだけで済みます。

   pip install -t . tabulate

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

   Linux または macOS

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

   説明

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

   Windows

   プロジェクトディレクトリに移動し、すべてのファイルを選択し、選択したファイルを右クリックして ZIP ファイルにパッケージ化します。このコマンドは、プロジェクトファイルと依存ライブラリを ZIP ファイルにパッケージ化します。これで、コードパッケージの作成は完了です。

ステップ 3: Web 関数の作成とコードパッケージのデプロイ

1. Web 関数のタイプを選択: Function Compute コンソールにログインします。左側のナビゲーションウィンドウで、[関数] > [関数] を選択します。上部のナビゲーションバーで、関数を作成するリージョンを選択します。[関数の作成] をクリックし、[Web 関数] を選択してから、プロンプトに従って関数を作成します。

2. ランタイムの選択: [カスタムランタイム] > [Python] > [Python 3.10] を選択します。このランタイムには、Flask フレームワーク用の依存ライブラリが組み込まれています。

   説明

   • Web 関数の場合は、[カスタムランタイム] を使用することをお勧めします。[カスタムランタイム] を使用すると、起動コマンドとリッスンポートをカスタマイズでき、同時リクエスト処理がサポートされます。[組み込みランタイム] にはこれらの機能がなく、他の Alibaba Cloud サービスによって生成されたイベントの処理に適しています。

   • コンテナ化されたデプロイメントを希望する場合は、[カスタムイメージ] を使用して 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"}' 

   このコマンドは、2025 年 1 月のカレンダー情報を返します。次の出力はサンプルです。

   

   説明

   • デフォルトの HTTP トリガー構成を使用する場合、上記のサンプルコマンドを実行すると MissingRequiredHeader エラーが返されます。この場合、テスト環境にいる場合は、トリガーの [認証方法] を [認証なし] に変更できます。

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

3. (任意) ブラウザから関数にアクセスする: HTTP トリガーによって提供されるパブリックエンドポイントは、ファイルのダウンロードを強制するため、ブラウザからアクセスできません。このエンドポイントは、テスト目的でのみ使用されます。ブラウザからのアクセスを有効にし、本番環境で使用するために、カスタムドメイン名を関数にバインドすることをお勧めします。詳細については、「カスタムドメイン名の設定」をご参照ください。

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

各言語の依存関係を追加する手順については、次のドキュメントを参照してください。