11.2. Node.js 関数の開発

手順

1. 関数の test フォルダーに移動します。

2. テストを実行します。

   $ npm test

手順

1. 関数コードで、次のインターフェイスを実装する Function オブジェクトを作成します。

   export interface Function {
     init?: () => any; 1
   
     shutdown?: () => any; 2
   
     liveness?: HealthCheck; 3
   
     readiness?: HealthCheck; 4
   
     logLevel?: LogLevel;
   
     handle: CloudEventFunction | HTTPFunction; 5
   }

   1

   サーバーの起動前に呼び出される初期化関数。この関数はオプションであり、同期する必要があります。

   2

   サーバーの停止後に呼び出される shutdown 関数。この関数はオプションであり、同期する必要があります。

   3

   liveness 関数。サーバーが生きているかどうかを確認するために呼び出されます。この関数はオプションであり、サーバーが稼動している場合は 200/OK を返す必要があります。

   4

   readiness 関数。サーバーがリクエストを受け入れる準備ができているかどうかを確認するために呼び出されます。この関数はオプションであり、サーバーが準備できている場合は 200/OK を返すはずです。

   5

   HTTP リクエストを処理する関数。

   たとえば、以下のコードを index.js ファイルに追加します。

   const Function = {
   
     handle: (context, body) => {
       // The function logic goes here
       return 'function called'
     },
   
     liveness: () => {
       process.stdout.write('In liveness\n');
       return 'ok, alive';
     }, 1
   
     readiness: () => {
       process.stdout.write('In readiness\n');
       return 'ok, ready';
     } 2
   };
   
   Function.liveness.path = '/alive'; 3
   Function.readiness.path = '/ready'; 4
   
   module.exports = Function;

   1

   カスタム liveness 関数。

   2

   カスタム readiness 関数。

   3

   カスタム liveness エンドポイント。

   4

   カスタム readiness エンドポイント。

   Function.liveness.path および Function.readiness.path の代わりに、LIVENESS_URL および READINESS_URL 環境変数を使用してカスタムエンドポイントを指定できます。

   run:
     envs:
     - name: LIVENESS_URL
       value: /alive 1
     - name: READINESS_URL
       value: /ready 2

   1

   liveness パス。ここで /alive に設定されます。

   2

   readiness パス。ここで /ready に設定されます｡

2. 新しいエンドポイントを func.yaml ファイルに追加して、Knative サービスのコンテナーに適切にバインドされるようにします。

   deploy:
     healthEndpoints:
       liveness: /alive
       readiness: /ready