ホーム
製品
Red Hat OpenShift Serverless
1.29
関数
第12章関数開発リファレンスガイド

第12章関数開発リファレンスガイド

OpenShift Serverless Functions は、基本的な関数を作成するために使用できるテンプレートを提供します。テンプレートは、関数プロジェクトのボイラープレートを開始し、kn func ツールで使用できるように準備します。各関数テンプレートは特定のランタイム用に調整されており、その規則に従います。テンプレートを使用すると、関数プロジェクトを自動的に開始できます。

次のランタイムのテンプレートが利用可能です。

12.1. Node.js コンテキストオブジェクトのリファレンス

context オブジェクトには、関数開発者が利用可能なプロパティーが複数あります。これらのプロパティーにアクセスすると、HTTP 要求に関する情報が提供され、出力がクラスターログに書き込まれます。

12.1.1. log

出力をクラスターロギングに書き込むために使用可能なロギングオブジェクトを提供します。ログは Pino logging API に準拠します。

ログの例

function handle(context) {
  context.log.info(“Processing customer”);
}

function handle(context) {
  context.log.info(“Processing customer”);
}

Copy to Clipboard

kn func invoke コマンドを使用して、この関数にアクセスできます。

コマンドの例

kn func invoke --target 'http://example.function.com'

$ kn func invoke --target 'http://example.function.com'

Copy to Clipboard

出力例

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"Processing customer"}

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"Processing customer"}

Copy to Clipboard

ログレベルは、fatal、error、warn、info、debug、trace、または silent のいずれかに設定できます。これを実行するには、config コマンドを使用してこれらの値のいずれかを環境変数 FUNC_LOG_LEVEL に割り当てて、logLevel の値を変更します。

12.1.2. query

要求のクエリー文字列 (ある場合) をキーと値のペアとして返します。これらの属性はコンテキストオブジェクト自体にも表示されます。

サンプルクエリー

function handle(context) {
  // Log the 'name' query parameter
  context.log.info(context.query.name);
  // Query parameters are also attached to the context
  context.log.info(context.name);
}

function handle(context) {
  // Log the 'name' query parameter
  context.log.info(context.query.name);
  // Query parameters are also attached to the context
  context.log.info(context.name);
}

Copy to Clipboard

kn func invoke コマンドを使用して、この関数にアクセスできます。

コマンドの例

kn func invoke --target 'http://example.com?name=tiger'

$ kn func invoke --target 'http://example.com?name=tiger'

Copy to Clipboard

出力例

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"tiger"}

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"tiger"}

Copy to Clipboard

12.1.3. ボディー

要求ボディー (ある場合) を返します。要求ボディーに JSON コードが含まれている場合は、属性が直接利用できるように解析されます。

ボディーの例

function handle(context) {
  // log the incoming request body's 'hello' parameter
  context.log.info(context.body.hello);
}

function handle(context) {
  // log the incoming request body's 'hello' parameter
  context.log.info(context.body.hello);
}

Copy to Clipboard

curl コマンドを使用してこの関数を呼び出すことができます。

コマンドの例

kn func invoke -d '{"Hello": "world"}'

$ kn func invoke -d '{"Hello": "world"}'

Copy to Clipboard

出力例

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"world"}

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"world"}

Copy to Clipboard

12.1.4. ヘッダー

HTTP 要求ヘッダーをオブジェクトとして返します。

ヘッダーの例

function handle(context) {
  context.log.info(context.headers["custom-header"]);
}

function handle(context) {
  context.log.info(context.headers["custom-header"]);
}

Copy to Clipboard

kn func invoke コマンドを使用して、この関数にアクセスできます。

コマンドの例

kn func invoke --target 'http://example.function.com'

$ kn func invoke --target 'http://example.function.com'

Copy to Clipboard

出力例

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"some-value"}

{"level":30,"time":1604511655265,"pid":3430203,"hostname":"localhost.localdomain","reqId":1,"msg":"some-value"}

Copy to Clipboard

12.1.5. HTTP 要求

方法: HTTP 要求メソッドを文字列として返します。
httpVersion: HTTP バージョンを文字列として返します。
httpVersionMajor: HTTP メジャーバージョン番号を文字列として返します。
httpVersionMinor: HTTP マイナーバージョン番号を文字列として返します。

トップに戻る

第12章関数開発リファレンスガイド

12.1. Node.js コンテキストオブジェクトのリファレンス

12.1.1. log

12.1.2. query

12.1.3. ボディー

12.1.4. ヘッダー

12.1.5. HTTP 要求

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第12章 関数開発リファレンスガイド

12.1. Node.js コンテキストオブジェクトのリファレンス

12.1.1. log

12.1.2. query

12.1.3. ボディー

12.1.4. ヘッダー

12.1.5. HTTP 要求

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

第12章関数開発リファレンスガイド