第1章 Knative Serving CLI コマンド

前提条件

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

手順

• Knative サービスを作成します。

  $ kn service create <service-name> --image <image> --tag <tag-value>

  ここでは、以下のようになります。

  • --image は、アプリケーションのイメージの URI です。

  • --tag は、サービスで作成される初期リビジョンにタグを追加するために使用できるオプションのフラグです。

    コマンドの例

    $ kn service create showcase \
        --image quay.io/openshift-knative/showcase

    出力例

    Creating service 'showcase' in namespace 'default':
    
      0.271s The Route is still working to reflect the latest desired specification.
      0.580s Configuration "showcase" is waiting for a Revision to become ready.
      3.857s ...
      3.861s Ingress has not yet been reconciled.
      4.270s Ready to serve.
    
    Service 'showcase' created with latest revision 'showcase-00001' and URL:
    http://showcase-default.apps-crc.testing

コマンドの例

• 新規の環境変数を追加してサービスを更新します。

  $ kn service update <service_name> --env <key>=<value>

• 新しいポートを追加してサービスを更新します。

  $ kn service update <service_name> --port 80

• 新しい要求および制限パラメーターを追加してサービスを更新します。

  $ kn service update <service_name> --request cpu=500m --limit memory=1024Mi --limit cpu=1000m

• latest タグをリビジョンに割り当てます。

  $ kn service update <service_name> --tag <revision_name>=latest

• サービスの最新の READY リビジョンについて、testing から staging にタグを更新します。

  $ kn service update <service_name> --untag testing --tag @latest=staging

• test タグをトラフィックの 10% を受信するリビジョンに追加し、残りのトラフィックをサービスの最新の READY リビジョンに送信します。

  $ kn service update <service_name> --tag <revision_name>=test --traffic test=10,@latest=90

コマンドの例

• サービスを作成します。

  $ kn service apply <service_name> --image <image>

• 環境変数をサービスに追加します。

  $ kn service apply <service_name> --image <image> --env <key>=<value>

• JSON または YAML ファイルからサービス宣言を読み取ります。

  $ kn service apply <service_name> -f <filename>

コマンドの例

• サービスを記述します。

  $ kn service describe --verbose <service_name>

  --verbose フラグは任意ですが、さらに詳細な説明を提供するために追加できます。通常の出力と詳細出力の違いを次の例に示します。

  --verbose フラグを使用しない出力例

  Name:       showcase
  Namespace:  default
  Age:        2m
  URL:        http://showcase-default.apps.ocp.example.com
  
  Revisions:
    100%  @latest (showcase-00001) [1] (2m)
          Image:  quay.io/openshift-knative/showcase (pinned to aaea76)
  
  Conditions:
    OK TYPE                   AGE REASON
    ++ Ready                   1m
    ++ ConfigurationsReady     1m
    ++ RoutesReady             1m

  --verbose フラグを使用する出力例

  Name:         showcase
  Namespace:    default
  Annotations:  serving.knative.dev/creator=system:admin
                serving.knative.dev/lastModifier=system:admin
  Age:          3m
  URL:          http://showcase-default.apps.ocp.example.com
  Cluster:      http://showcase.default.svc.cluster.local
  
  Revisions:
    100%  @latest (showcase-00001) [1] (3m)
          Image:  quay.io/openshift-knative/showcase (pinned to aaea76)
          Env:    GREET=Bonjour
  
  Conditions:
    OK TYPE                   AGE REASON
    ++ Ready                   3m
    ++ ConfigurationsReady     3m
    ++ RoutesReady             3m

• サービスを YAML 形式で記述します。

  $ kn service describe <service_name> -o yaml

• サービスを JSON 形式で記述します。

  $ kn service describe <service_name> -o json

• サービス URL のみを出力します。

  $ kn service describe <service_name> -o url