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()
   # Flask アプリケーションを作成
   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 = "リクエストは {'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 = ["月", "火", "水", "木", "金", "土", "日"]
   
       # 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 アプリケーションを実行します。 出力が の場合、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) をディレクトリにインストールします。 完了後、プロジェクトのルートディレクトリには、プロジェクトファイルと依存関係ライブラリが含まれます。

   説明

   Python Web 関数ランタイム環境にはすでに Flask ライブラリが含まれているため、tabulate をインストールすれば、サンプルアプリケーションのニーズを満たすことができます。

   pip install -t . tabulate

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

   Linux または macOS

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

   説明

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

   Windows

   プロジェクトディレクトリに入り、すべてのファイルを選択し、右クリックして、ZIP ファイルとしてパッケージ化するように選択します。 この手順では、プロジェクトファイルと依存関係ライブラリを ZIP ファイルにパッケージ化し、コードパッケージの構築を完了します。

3. Web 関数を作成し、コードパッケージをデプロイする

1. 関数のタイプを選択する: Function Compute 3.0 コンソールを開きます。 ページの左上にあるリージョンリストで、関数を作成するリージョンを選択します。 中国東部 1 (杭州) など、お近くのリージョンを選択することをお勧めします。 次に、[関数] ページで、[関数の作成] をクリックします。 関数の作成ページで、[Web 関数] を選択します。

2. ランタイム環境を選択する: 図に従って、[カスタムランタイム] > [Python] > [Python 3.10] を選択します。 このランタイムには、Flask フレームワークに必要な依存関係ライブラリが組み込まれています。

   説明

   • Web 関数の場合、[カスタムランタイム] を関数のランタイム環境として使用することをお勧めします。 [カスタムランタイム] では、起動コマンドとリスナーポートをカスタマイズでき、単一インスタンスのマルチコンカレンシーをサポートしているためです。 [組み込みランタイム] にはこれらの機能がなく、クラウドプロダクトによって生成されたイベントの処理に適しています。

   • コンテナ化されたデプロイメントを希望する場合は、[カスタムイメージ] を使用して Web 関数を作成することもできます。 この環境も単一インスタンスのマルチコンカレンシーをサポートしていますが、依存関係を自分で管理する必要があります。

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

3. コードパッケージをデプロイする: 図に従って、前の手順で取得した ZIP フォーマットのコードパッケージをアップロードし、起動コマンドを python3 app.py として、リスナーポートを 9000 として構成します。 既存の Flask アプリケーションを移行する場合は、実際の起動コマンドとポート (たとえば、Flask のデフォルトポート構成は 5000) に従って構成を変更します。

   完了したら、[作成] をクリックして、関数の作成が完了するまで待ちます。

4. 関数をテストする

1. 関数の URL を取得する: 新しく作成された関数の詳細ページで、[構成] タブをクリックし、左側のナビゲーションウィンドウで [トリガー] を選択します。 HTTP トリガーの構成情報で、パブリックアクセスアドレスをクリックしてアドレスをコピーします。

   

2. 関数をテストする: cURL、Postman、または任意の HTTP クライアントを使用して関数を呼び出し、Flask アプリケーションの機能を確認できます。 cURL を例にとると、コマンドラインで次のサンプルコマンドを実行します (アドレスは前の手順でコピーしたアドレスに置き換えます)。

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

   Web インターフェースには、2025 年 1 月のカレンダー情報が出力されます。 サンプル出力は次のとおりです。

   

   説明

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

3. (オプション) ブラウザから関数にアクセスする: HTTP トリガーによって提供されるパブリックアクセスアドレスは、ブラウザで開くことができず (強制ダウンロード)、テスト環境でのみ使用できます。 ブラウザアクセスと本番環境での使用をサポートするには、関数をカスタムドメイン名にバインドすることをお勧めします。 詳細については、「カスタムドメイン名を構成する」をご参照ください。

5. (オプション) リソースをクリーンアップする

他の言語でコードパッケージをビルドする手順の詳細については、次のドキュメントを参照してください。

• C# コードパッケージのコンパイルとデプロイ

• Go コードパッケージのコンパイルとデプロイ

• Java コードパッケージのコンパイルとデプロイ

• Node.js コードパッケージのデプロイ

• PHP コードパッケージのデプロイ