4.6. 関数コマンド

前提条件

• 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 サービス名はプロジェクト名から派生するので、以下のコマンドでは変更できません。

手順

• 既存の関数を一覧表示します。

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

  出力例

  NAME           NAMESPACE  RUNTIME  URL                                                                                      READY
  example-function  default    node     http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com  True

• Knative サービスとしてデプロイされた関数を一覧表示します。

  $ kn service list -n <namespace>

  出力例

  NAME            URL                                                                                       LATEST                AGE   CONDITIONS   READY   REASON
  example-function   http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com   example-function-gzl4c   16m   3 OK / 3     True

手順

• 関数を説明します。

  $ kn func info [-f <format> -n <namespace> -p <path>]

  コマンドの例

  $ kn func info -p function/example-function

  出力例

  Function name:
    example-function
  Function is built in image:
    docker.io/user/example-function:latest
  Function is deployed as Knative Service:
    example-function
  Function is deployed in namespace:
    default
  Routes:
    http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com

前提条件

• 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 の値にデフォルト設定されます。