11.2. 関数を使い始める

前提条件

• OpenShift Serverless Operator および Knative Serving がクラスターにインストールされている。
• Knative (kn) CLI をインストールしている。

手順

• 関数プロジェクトを作成します。

  $ kn func create -r <repository> -l <runtime> -t <template> <path>

  • 受け入れられるランタイム値には、quarkus、node、typescript、go、python、springboot、および rust が含まれます。

  • 受け入れられるテンプレート値には、http と cloudevents が含まれます。

    コマンドの例

    $ kn func create -l typescript -t cloudevents examplefunc

    出力例

    Created typescript function in /home/user/demo/examplefunc

  • または、カスタムテンプレートを含むリポジトリーを指定することもできます。

    コマンドの例

    $ kn func create -r https://github.com/boson-project/templates/ -l node -t hello-world examplefunc

    出力例

    Created node function in /home/user/demo/examplefunc

前提条件

• OpenShift Serverless Operator および Knative Serving がクラスターにインストールされている。
• Knative (kn) CLI をインストールしている。
• OpenShift Container Platform でアプリケーションおよび他のワークロードを作成するために、プロジェクトを作成しているか、適切なロールおよびパーミッションを持つプロジェクトにアクセスできる。
• デプロイする関数を作成し、初期化している必要がある。

手順

• 関数をデプロイします。

  $ kn func deploy [-n <namespace> -p <path> -i <image>]

  出力例

  Function deployed at: http://func.example.com

  • namespace が指定されていない場合には、関数は現在の namespace にデプロイされます。
  • この関数は、パス が指定されない限り、現在のディレクトリーからデプロイされます。
  • Knative サービス名はプロジェクト名から派生するので、以下のコマンドでは変更できません。

前提条件

• OpenShift Serverless Operator および Knative Serving がクラスターにインストールされている。
• Knative (kn) CLI をインストールしている。
• OpenShift Container Platform でアプリケーションおよび他のワークロードを作成するために、プロジェクトを作成しているか、適切なロールおよびパーミッションを持つプロジェクトにアクセスできる。
• 呼び出す関数をすでにデプロイしている必要があります。

手順

• 関数を呼び出します。

  $ kn func invoke

  • kn func invoke コマンドは、ローカルのコンテナーイメージが実行中の場合や、クラスターにデプロイされた関数がある場合にのみ機能します。
  • kn func invoke コマンドは、デフォルトでローカルディレクトリーで実行され、このディレクトリーが関数プロジェクトであると想定します。

手順

• 関数を削除します。

  $ kn func delete [<function_name> -n <namespace> -p <path>]

  • 削除する関数の名前またはパスが指定されていない場合には、現在のディレクトリーで func.yaml ファイルを検索し、削除する関数を判断します。
  • namespace が指定されていない場合には、func.yaml の namespace の値にデフォルト設定されます。

• Knative Eventing でのチャネルの使用 を参照してください。