Function Compute:インスタンスライフサイクルの設定

コンソール

1. Function Compute コンソールにログインします。左側のナビゲーションウィンドウで、[関数管理] > [関数] を選択します。

2. トップナビゲーションバーでリージョンを選択し、[関数] ページで目的の関数をクリックします。

3. 関数詳細ページで、設定 タブをクリックし、変更 セクションの インスタンスの設定 をクリックします。

4. インスタンスの設定 パネルで、Initializer フックとそのタイムアウト期間を設定します。

   このトピックでは、GPU アクセラレーション関数を例に、Initializer フックの設定方法を説明します。イベントトリガー関数、Web 関数、およびタスク関数の場合、Initializer フックはコード呼び出しタイプのみをサポートします。このトピックで説明されているコード呼び出しタイプの手順に従うことができます。

   • コード呼び出しタイプを選択

     [Initializer フック] スイッチをオンにし、[Initializer フックのタイムアウト] を 300 秒に設定します。この機能を有効にすると、インスタンスの起動時に Function Compute が関数に HTTP POST /initialize リクエストを送信します。200 応答は成功を示し、4xx または 5xx 応答はエラーまたはインスタンスの再起動を引き起こします。

   • コマンド実行タイプを選択

     [Initializer フック] スイッチをオンにし、[Initializer フックのタイムアウト] を 300 秒に設定し、[コマンド] を >/bin/sh に設定します。コードエディタで、ローカルの Stable Diffusion API にヘルスチェックの POST リクエストを送信するシェルスクリプトを記述します。URL を http://localhost:7860 に、REQUEST_PATH を sdapi/v1/txt2img に設定します。prompt、steps、height、および width フィールドを含む JSON ペイロードを構築し、curl を使用してリクエストを送信します。

5. インスタンスの設定 パネルで、PreStop フックとそのタイムアウト期間を設定し、デプロイ をクリックします。

6. コード呼び出しタイプのフックを設定した場合は、コードに対応する関数を実装する必要があります。

   1. コード タブをクリックします。コードエディタで、フック関数のロジックを追加します。

      たとえば、PreStop フックハンドラを index.preStop として設定した場合、コードに preStop 関数を実装する必要があります。さまざまなランタイムでインスタンスライフサイクルフックを実装する方法については、「関数インスタンスのライフサイクルフック」をご参照ください。

      説明

      オンライン IDE は PHP、Python、Node.js、およびカスタムランタイムをサポートしていますが、Java、Go、.NET などのコンパイル型言語やカスタムコンテナランタイムはサポートしていません。

   2. コードエディタの上部で、デプロイメントコード をクリックし、次に 関数のテスト をクリックします。

Serverless Devs

Serverless Devs を使用して Initializer フックを設定する場合、s.yaml ファイル内のコードスニペットは次の例のようになります。

  codeUri: './code.zip'
  ......
  instanceLifecycleConfig:
    initializer:
      timeout: 60
      command:
        - /bin/sh
        - -c
        - echo "hello"

フックを無効にする必要がある場合は、そのハンドラとコマンドパラメーターを明示的に空の文字列に設定する必要があります。これは、そうしないとバックエンドが更新を適用しないためです。たとえば、Initializer フックを無効にするには、次の設定をデプロイします。Initializer フックのタイムアウトとコマンドパラメーターは無視されます。

  codeUri: './code.zip'
  ......
  instanceLifecycleConfig:
    initializer:
      handler: ""
      timeout: 60
      command: ""

さまざまなランタイムでインスタンスライフサイクルフックを実装する方法については、「関数インスタンスのライフサイクルフック」をご参照ください。

SDK

SDK を使用してフックをデプロイおよび更新できます。このセクションでは、関数を作成する際にフックを設定するためのサンプル SDK コードを取得する方法について説明します。

1. CreateFunction API リファレンストピックに移動し、[デバッグ] をクリックして OpenAPI Portal を開きます。

2. [パラメーター] タブで、作成する関数に基づいて入力パラメーターを指定します。

   説明

   command パラメーターは PreStop フックではサポートされていません。

   instanceLifecycleConfig を展開します。initializer セクションで、timeout を 300 に設定します。command リストで、インデックス 0 に値 curl -X POST 'http://localhost:9000/preWarm' の項目を追加します。preStop セクションで、handler を index.preStop に、timeout を 3 に設定します。

3. パラメーターを設定した後、[SDK サンプル] タブをクリックして、希望する言語のサンプルコードを取得します。

さまざまなランタイムでインスタンスライフサイクルフックを実装する方法については、「関数インスタンスのライフサイクルフック」をご参照ください。