第1章 スタートガイド
1.1. Knative Workflow プラグインを使用したワークフローの作成および実行 リンクのコピーリンクがクリップボードにコピーされました!
OpenShift Serverless Logic ワークフローをローカルで作成し、実行できます。
1.1.1. ワークフローの作成 リンクのコピーリンクがクリップボードにコピーされました!
kn workflow で create コマンドを使用して、現在のディレクトリーに新しい OpenShift Serverless Logic プロジェクトを設定できます。
前提条件
-
OpenShift Serverless Logic
kn-workflowCLI プラグインがインストールされている。
手順
次のコマンドを実行して、新しい OpenShift Serverless Logic ワークフロープロジェクトを作成します。
kn workflow create
$ kn workflow createCopy to Clipboard Copied! Toggle word wrap Toggle overflow デフォルトでは、生成されるプロジェクト名は
new-projectです。次のように[-n|--name]フラグを使用してプロジェクト名を変更できます。コマンドの例
kn workflow create --name my-project
$ kn workflow create --name my-projectCopy to Clipboard Copied! Toggle word wrap Toggle overflow
1.1.2. Operator マニフェストのリストを生成する リンクのコピーリンクがクリップボードにコピーされました!
ワークフロープロジェクトを作成したら、kn workflow で gen-manifest コマンドを使用して、カレントディレクトリーに OpenShift Serverless Logic ワークフロープロジェクトの Operator マニフェストファイルを生成できます。
前提条件
-
OpenShift Serverless Logic
kn-workflowCLI プラグインがインストールされている。 - OpenShift Serverless Logic ワークフロープロジェクトを作成している。
手順
次のコマンドを実行して、OpenShift Serverless Logic ワークフロープロジェクトの Operator マニフェストを生成します。
kn workflow gen-manifest
$ kn workflow gen-manifestCopy to Clipboard Copied! Toggle word wrap Toggle overflow これにより、プロジェクトの
./manifestsディレクトリーに新しいファイルが作成されます。次のコマンドを実行して、生成された Operator マニフェストをクラスターに適用します。
oc apply -f manifests/01-sonataflow_hello.yaml -n <namespace>
$ oc apply -f manifests/01-sonataflow_hello.yaml -n <namespace>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.1.3. ワークフローのローカルでの実行 リンクのコピーリンクがクリップボードにコピーされました!
kn workflow で run コマンドを使用して、現在のディレクトリーに OpenShift Serverless Logic ワークフロープロジェクトをビルドして実行できます。
前提条件
- ローカルマシンに Podman がインストールされている。
-
OpenShift Serverless Logic
kn-workflowCLI プラグインがインストールされている。 - OpenShift Serverless Logic ワークフロープロジェクトを作成している。
手順
OpenShift Serverless Logic プロジェクトを作成したディレクトリーから、以下のコマンドを実行してプロジェクトディレクトリーに移動します。
cd ./<your-project-name>
$ cd ./<your-project-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、OpenShift Serverless Logic ワークフロープロジェクトをビルドして実行します。
kn workflow run
$ kn workflow runCopy to Clipboard Copied! Toggle word wrap Toggle overflow プロジェクトの準備が整うと、開発 UI がブラウザーの
localhost:8080/q/dev-uiで自動的に開き、Serverless Workflow Tools タイルが利用可能になります。または、http://localhost:8080/q/dev-ui/org.apache.kie.sonataflow.sonataflow-quarkus-devui/workflowsを使用してツールに直接アクセスすることもできます。
マシン上で実行されるコンテナーを使用して、ワークフローをローカルで実行できます。Ctrl+C でコンテナーを停止します。
1.1.4. Quarkus ワークフロープロジェクトの作成 リンクのコピーリンクがクリップボードにコピーされました!
ほとんどのワークフロー作成およびデプロイメントシナリオでは、kn-workflow プラグインを備えた Operator を使用します。Quarkus ワークフロープロジェクトは、開発または高度なユースケースを対象としています。
quarkus create コマンドを kn workflow とともに使用して、カレントディレクトリーに新しい Quarkus ワークフロープロジェクトをスキャフォールディングできます。プロジェクトの作成時に追加の Quarkus エクステンションを含めることもできます。
Quarkus の詳細は、Red Hat build of Quarkus ドキュメント を参照してください。
前提条件
-
OpenShift Serverless Logic
kn-workflowCLI プラグインがインストールされている。
手順
次のコマンドを実行して、新しい Quarkus ワークフロープロジェクトを作成します。
kn workflow quarkus create
$ kn workflow quarkus createCopy to Clipboard Copied! Toggle word wrap Toggle overflow デフォルトでは、生成されたプロジェクトの名前は
new-projectになります。次のように--nameフラグを付けてコマンドを実行すると、プロジェクト名を上書きできます。kn workflow quarkus create --name <your-project-name>
$ kn workflow quarkus create --name <your-project-name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記生成されたプロジェクトには、
./<project-name>/src/main/resources/内のサンプルworkflow.sw.jsonファイルを含む、最小限の Quarkus ワークフローセットアップが含まれています。初回実行の場合、依存関係をダウンロードするため、数分かかる場合があります。オプション: 次のように
--extensionフラグを指定してコマンドを実行し、Quarkus プロジェクトに 1 つ以上のエクステンションを追加します。kn workflow quarkus create --extension quarkus-jsonp,quarkus-smallrye-openapi
$ kn workflow quarkus create --extension quarkus-jsonp,quarkus-smallrye-openapiCopy to Clipboard Copied! Toggle word wrap Toggle overflow 複数のエクステンションをコンマ区切りのリストとして追加できます。たとえば、次のコマンドは、
quarkus-jsonpおよびquarkus-smallrye-openapiエクステンションを追加します。kn workflow quarkus create --extension quarkus-jsonp,quarkus-smallrye-openapi
$ kn workflow quarkus create --extension quarkus-jsonp,quarkus-smallrye-openapiCopy to Clipboard Copied! Toggle word wrap Toggle overflow