diff --git a/modules/serverless-logic-creating-workflows-quarkus.adoc b/modules/serverless-logic-creating-workflows-quarkus.adoc new file mode 100644 index 000000000000..9f62bb635668 --- /dev/null +++ b/modules/serverless-logic-creating-workflows-quarkus.adoc @@ -0,0 +1,51 @@ +// Module included in the following assemblies: +// +// * serverless/serverless-logic/serverless-logic-creating-managing-workflows.adoc + +:_mod-docs-content-type: PROCEDURE +[id="serverless-logic-creating-workflows-quarkus_{context}"] += Creating a Quarkus workflow project + +You can use the `quarkus create` command with `kn workflow` to scaffold a new Quarkus workflow project in your current directory. You can also include additional Quarkus extensions during project creation. + +For more information about Quarkus, see link:https://docs.redhat.com/en/documentation/red_hat_build_of_quarkus/latest[Red Hat build of Quarkus documentation]. + +.Prerequisites + +* You installed the {ServerlessLogicProductName} `kn-workflow` CLI plugin. + +.Procedure + +. Create a new Quarkus workflow project by running the following command: ++ +[source, teminal] +---- +$ kn workflow quarkus create +---- ++ +By default, the generated project is named `new-project`. You can overwrite the project name by running the command with the `--name` flag: ++ +[source, teminal] +---- +$ kn workflow quarkus create --name +---- ++ +[NOTE] +==== +The generated project contains a minimal Quarkus workflow setup, including a sample `workflow.sw.json` file in `.//src/main/resources/`. +First-time execution might take several minutes due to dependency downloads. +==== + +. Optional: Add more extensions to the Quarkus project by running the command with the `--extension` flag: ++ +[source, teminal] +---- +$ kn workflow quarkus create --extension quarkus-jsonp,quarkus-smallrye-openapi +---- ++ +You can include multiple extensions as a comma-separated list. The following example adds the `quarkus-jsonp` and `quarkus-smallrye-openapi` extensions: ++ +[source, teminal] +---- +$ kn workflow quarkus create --extension quarkus-jsonp,quarkus-smallrye-openapi +---- diff --git a/modules/serverless-logic-generate-manifest.adoc b/modules/serverless-logic-generate-manifest.adoc new file mode 100644 index 000000000000..d0d8c3478ff5 --- /dev/null +++ b/modules/serverless-logic-generate-manifest.adoc @@ -0,0 +1,32 @@ +// Module included in the following assemblies: +// +// * serverless/serverless-logic/serverless-logic-creating-managing-workflows.adoc + +:_mod-docs-content-type: PROCEDURE +[id="serverless-logic-generate-manifest_{context}"] += Generating a list of Operator manifests + +After creating your workflow project, you can use the `gen-manifest` command with `kn workflow` to generate operator manifest files for your {ServerlessLogicProductName} workflow project in your current directory. + +.Prerequisites + +* You have installed the {ServerlessLogicProductName} `kn-workflow` CLI plugin. +* You have created an {ServerlessLogicProductName} workflow project. + +.Procedure + +. Generate operator manifests for your {ServerlessLogicProductName} workflow project by running the following command: ++ +[source,terminal] +---- +$ kn workflow gen-manifest +---- ++ +This creates a new file in the `./manifests` directory in your project. + +. Apply the generated operator manifest to your cluster by running the following command: ++ +[source,terminal] +---- +$ oc apply -f manifests/01-sonataflow_hello.yaml -n +---- diff --git a/modules/serverless-logic-running-workflows.adoc b/modules/serverless-logic-running-workflows.adoc index 21b427ba864e..1275e2b8c03f 100644 --- a/modules/serverless-logic-running-workflows.adoc +++ b/modules/serverless-logic-running-workflows.adoc @@ -30,5 +30,3 @@ When the project is ready, the Development UI automatically opens in your browse ==== You can execute a workflow locally using a container that runs on your machine. Stop the container with Ctrl+C. ==== - - diff --git a/serverless-logic/serverless-logic-configuring-workflow-services.adoc b/serverless-logic/serverless-logic-configuring-workflow-services.adoc index 177dd7f310c9..c3420b1ee867 100644 --- a/serverless-logic/serverless-logic-configuring-workflow-services.adoc +++ b/serverless-logic/serverless-logic-configuring-workflow-services.adoc @@ -12,4 +12,4 @@ include::modules/serverless-logic-modifying-workflow-configuration.adoc[leveloff include::modules/serverless-logic-modifying-managed-properties-workflow-services.adoc[leveloffset=+1] -include::modules/serverless-logic-defining-global-managed-properties.adoc[leveloffset=+1] \ No newline at end of file +include::modules/serverless-logic-defining-global-managed-properties.adoc[leveloffset=+1] diff --git a/serverless-logic/serverless-logic-getting-started/serverless-logic-creating-managing-workflows.adoc b/serverless-logic/serverless-logic-getting-started/serverless-logic-creating-managing-workflows.adoc index f5436f8288f1..417ff3009dc6 100644 --- a/serverless-logic/serverless-logic-getting-started/serverless-logic-creating-managing-workflows.adoc +++ b/serverless-logic/serverless-logic-getting-started/serverless-logic-creating-managing-workflows.adoc @@ -9,7 +9,9 @@ toc::[] You can create and run the {ServerlessLogicProductName} workflows locally. include::modules/serverless-logic-creating-workflows.adoc[leveloffset=+1] -include::modules/serverless-logic-running-workflows.adoc[leveloffset=+1] +include::modules/serverless-logic-generate-manifest.adoc[leveloffset=+1] +include::modules/serverless-logic-running-workflows.adoc[leveloffset=+1] +include::modules/serverless-logic-creating-workflows-quarkus.adoc[leveloffset=+1] diff --git a/serverless-logic/serverless-logic-getting-started/serverless-logic-deploying-workflows.adoc b/serverless-logic/serverless-logic-getting-started/serverless-logic-deploying-workflows.adoc index 3e35fe1f575f..6433cd0e8bf8 100644 --- a/serverless-logic/serverless-logic-getting-started/serverless-logic-deploying-workflows.adoc +++ b/serverless-logic/serverless-logic-getting-started/serverless-logic-deploying-workflows.adoc @@ -95,10 +95,3 @@ include::modules/serverless-logic-editing-workflows.adoc[leveloffset=+1] include::modules/serverless-logic-testing-workflows.adoc[leveloffset=+1] include::modules/serverless-logic-troubleshooting-workflows.adoc[leveloffset=+1] include::modules/serverless-logic-deleting-workflows.adoc[leveloffset=+1] - - - - - - -