第10章 OpenShift Serverless Logic Knative Workflow プラグインのインストール

手順

1. 次のコマンドを実行して logic-kn-workflow-cli-artifacts-rhel8 イメージを使用して Knative Workflow プラグインをダウンロードします。

   1. 次のコマンドを実行して、Red Hat レジストリーにログインします。

      $ podman login registry.redhat.io

      Red Hat カスタマーポータルアカウントまたはレジストリーサービスアカウントを使用できます。

   2. 次のコマンドを実行して、KN_IMAGE の変数を設定し、logic-kn-workflow-cli-artifacts-rhel8 イメージを起動します。

      $ export KN_IMAGE=registry.redhat.io/openshift-serverless-1/logic-kn-workflow-cli-artifacts-rhel8:1.33.0

   3. 以下のコマンドを実行して、KN_CONTAINER_ID の変数を設定します。

      $ export KN_CONTAINER_ID=$(podman run -di $KN_IMAGE)

   4. 以下のコマンドを実行して、Knative Workflow プラグインのバイナリーファイルをコピーします。

      $ podman cp $KN_CONTAINER_ID:<path_to_binary> .

      ここで、<path_to_binary> は、ご使用の環境のファイルへのパスです。

      環境	バイナリーファイルへのパス
      Linux amd64 アーキテクチャー	/usr/share/kn/linux_amd64/kn-workflow-linux-amd64.tar.gz
      Linux arm64 アーキテクチャー	/usr/share/kn/linux_arm64/kn-workflow-linux-arm64.tar.gz
      macOS amd64 アーキテクチャー	/usr/share/kn/macos_amd64/kn-workflow-macos-amd64.tar.gz
      macOS arm64 アーキテクチャー	/usr/share/kn/macos_arm64/kn-workflow-macos-arm64.tar.gz
      Windows amd64 アーキテクチャー	/usr/share/kn/windows/kn-workflow-windows-amd64.zip

   5. 次のコマンドを実行して、コンテナーを停止します。

      $ podman stop $KN_CONTAINER_ID

   6. 以下のコマンドを実行してコンテナーを削除します。

      $ podman rm $KN_CONTAINER_ID

   7. 次のコマンドを実行して、選択した Knative Workflow プラグインのバイナリーファイルを展開します。

      $ tar xvzf kn-workflow-linux-amd64.tar.gz

   8. 次のコマンドを実行して、Knative Workflow プラグインのバイナリーファイルの名前を kn-workflow に変更します。

      $ mv kn kn-workflow

2. 次のコマンドを実行して、kn-workflow コマンドを Knative CLI のプラグインとしてインストールします。

   1. kn-workflow バイナリーファイルを /usr/local/bin などの PATH 内のディレクトリーにコピーし、ファイル名が kn-workflow であることを確認します。

      $ cp path/to/downloaded/kn-workflow /usr/local/bin/kn-workflow

   2. バイナリーファイルを実行可能にします。

      $ chmod +x /usr/local/bin/kn-workflow

検証

1. 次のコマンドを実行して、kn-workflow プラグインが正常にインストールされていることを確認します。

   $ kn plugin list

2. プラグインをインストールした後、kn-workflow を使用して関連するサブコマンドを実行できます。

   workflow サブコマンドを使用するエイリアス

   kn-workflow

   kn-workflow help コマンドの出力例

   Manage OpenShift Serverless Logic Workflow projects
   
   Usage:
     kn workflow [command]
   
   Aliases:
     kn workflow, kn-workflow
   
   Available Commands:
     completion  Generate the autocompletion script for the specified shell
     create      Creates a new OpenShift Serverless Logic Workflow project
     deploy      Deploy an OpenShift Serverless Logic Workflow project on Kubernetes via SonataFlow Operator
     help        Help about any command
     quarkus     Manage OpenShift Serverless Logic Workflow projects built in Quarkus
     run         Run an OpenShift Serverless Logic Workflow project in development mode
     undeploy    Undeploy an OpenShift Serverless Logic Workflow project on Kubernetes via SonataFlow Operator
     version     Show the version
   
   Flags:
     -h, --help      help for kn
     -v, --version   version for kn
   
   Use "kn [command] --help" for more information about a command.