From 5cbeac0ff0af48e26d271bcb28666a716e9c7d21 Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Mon, 31 Jul 2023 09:31:32 +0200 Subject: [PATCH 1/8] KOGITO-9455: Create the getting started guide to describe how to run workflow projects Adds new file with guide containing create, run and deploy showcases to begin development of SonataFlow project using operator first approach. --- ...rkflow-service-with-kn-cli-and-vscode.adoc | 92 +++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc new file mode 100644 index 000000000..dbe5b997b --- /dev/null +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -0,0 +1,92 @@ += Creating and running workflow projects using KN CLI and Visual Studio Code + +This guide showcases the use of our Knative Workflow CLI and Visual Studio code to run {product_name} projects. + +.Prerequisites +* xref:tooling/kn-plugin-workflow-overview.adoc[Knative Workflow CLI] {kn_cli_version} is installed. +* Visual Studio Code with https://marketplace.visualstudio.com/items?itemName=redhat.vscode-extension-serverless-workflow-editor[Red Hat Serverless Workflow Editor] is installed to edit your workflows. + +.Preparing your environment +* Install https://docs.docker.com/engine/install/[Docker] or https://podman.io/docs/installation[Podman]. +* Install https://minikube.sigs.k8s.io/docs/start/[minikube]. +* Install https://kubernetes.io/docs/tasks/tools/[kubectl]. +* Start minikube. Depending on your environment, set `--driver` flag to `podman` or `docker` +[source,bash] +---- +minikube start --cpus 4 --memory 8096 --addons registry --addons metrics-server --insecure-registry "10.0.0.0/24" --insecure-registry "localhost:5000" --driver=docker +---- +* (optional) Install https://k9scli.io/[k9scli.io] +* Install the https://operatorhub.io/operator/sonataflow-operator[Sonataflow Operator] +* Install https://github.com/kiegroup/kie-tools/releases/tag/0.30.3[KN Workflow CLI] by downloading the correct distrubiton for your development environment and adding it to the PATH. + +[[proc-creating-app-with-kn-cli]] +== Creating a workflow project with Visual Studio Code and KN CLI +* Navigate to you development directory and create your project +[source,bash] +---- +kn workflow create -n my-sonataflow-project +---- +* This will create a folder with name `my-sonataflow-project` and a sample workflow `wokrflow.sw.json` +[source,bash] +---- +cd ./my-sonataflow-project +---- +* Open the folder in Visual Studo Code and examine the created `worklow.sw.json` using our extension. + +Now we can run the project. + +[[proc-running-app-with-kn-cli]] +== Running a workflow project with Visual Studio Code and KN CLI + +* Run the project. This will start a `kogito-swf-devmode-nightly` image and map your local folder to this image. +[source,bash] +---- +kn workflow run +---- +* You can now work on your project. Any changes will be picked up by the hot reload feature. +* Once you are done developing your project navigate to terminal that is running `kn workflow run` command and hit `Ctlr+C` to stop the development environment. + +To deploy the finished project to cluster, proceed to next section. + +[[proc-deploying-app-with-kn-cli]] +== Deploying a workflow project with Visual Studio Code and KN CLI + +* Deploy to minikube +[source,bash] +---- +kn workflow deploy +---- +* Using k9scli you can examine your deployment. +* In a different Terminal, create a port mapping: +[source,bash] +---- +minikube service hello --namespace default --url +---- +* Use this URL to access your workflow instance in the Developer UI +** /q/dev/org.kie.kogito.kogito-quarkus-serverless-workflow-devui/workflowInstances + +* To stop the deployment: +[source,bash] +---- +kn worklow undeploy +---- +* You can validate your pod is terminating using k9s cli. + + +[[proc-testing-application]] +== Testing your workflow application + +To test your workflow application, you can follow the instructions in the +xref:testing-and-troubleshooting/basic-integration-tests-with-restassured.adoc[Testing your workflow application using REST Assured]. + +== Additional resources + +* xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-overview.adoc[Kogito Serverless Workflow Tools extension in Quarkus Dev UI]: View, manage, and start the workflow instances. +* xref:getting-started/getting-familiar-with-our-tooling.adoc[Getting familiar with {product_name} tooling] +* xref:service-orchestration/orchestration-of-openapi-based-services.adoc[Orchestrating the OpenAPI services] + +include::../../pages/_common-content/report-issue.adoc[] + +ifeval::["{kogito_version_redhat}" != ""] +include::../../pages/_common-content/downstream-project-setup-instructions.adoc[] +endif::[] \ No newline at end of file From 6f339a23261ba78f1a677610b7826be180deeb96 Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Mon, 31 Jul 2023 14:01:01 +0200 Subject: [PATCH 2/8] KOGITO-9455: Update the initial chapter texts to make it sound bette --- ...rkflow-service-with-kn-cli-and-vscode.adoc | 27 ++++++++++++------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc index dbe5b997b..b446e2b29 100644 --- a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -1,6 +1,6 @@ = Creating and running workflow projects using KN CLI and Visual Studio Code -This guide showcases the use of our Knative Workflow CLI and Visual Studio code to run {product_name} projects. +This guide showcases the use of our Knative Workflow CLI plugin and Visual Studio code to create & run {product_name} projects. .Prerequisites * xref:tooling/kn-plugin-workflow-overview.adoc[Knative Workflow CLI] {kn_cli_version} is installed. @@ -21,7 +21,10 @@ minikube start --cpus 4 --memory 8096 --addons registry --addons metrics-server [[proc-creating-app-with-kn-cli]] == Creating a workflow project with Visual Studio Code and KN CLI -* Navigate to you development directory and create your project + +Use the `create`` command with kn workflow to scaffold a new Sonata Flow project. + +* Navigate to you development directory and create your project. [source,bash] ---- kn workflow create -n my-sonataflow-project @@ -33,46 +36,52 @@ cd ./my-sonataflow-project ---- * Open the folder in Visual Studo Code and examine the created `worklow.sw.json` using our extension. -Now we can run the project. +Now we can run the project and execute your workflow. [[proc-running-app-with-kn-cli]] == Running a workflow project with Visual Studio Code and KN CLI +Use the `run` command with kn workflow to build and run the Sonata Flow project in local development mode. + * Run the project. This will start a `kogito-swf-devmode-nightly` image and map your local folder to this image. [source,bash] ---- kn workflow run ---- +* The Development UI wil be accesible at `localhost:8080/q/dev` * You can now work on your project. Any changes will be picked up by the hot reload feature. +* See xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-workflow-instances.adoc[Workflow instances] guide on how to run workflows via Development UI. * Once you are done developing your project navigate to terminal that is running `kn workflow run` command and hit `Ctlr+C` to stop the development environment. -To deploy the finished project to cluster, proceed to next section. +To deploy the finished project to a local cluster, proceed to next section. [[proc-deploying-app-with-kn-cli]] == Deploying a workflow project with Visual Studio Code and KN CLI +Use the `deploy` command with kn workflow to deploy the Sonata Flow project into your local cluster. + * Deploy to minikube [source,bash] ---- kn workflow deploy ---- -* Using k9scli you can examine your deployment. -* In a different Terminal, create a port mapping: +* (Optional) Using k9scli you can examine your deployment. +* In a different bash instance, create a port mapping: [source,bash] ---- minikube service hello --namespace default --url ---- -* Use this URL to access your workflow instance in the Developer UI +* Use this URL to access your workflow instances using the Developer UI ** /q/dev/org.kie.kogito.kogito-quarkus-serverless-workflow-devui/workflowInstances +* To update the image run the `deploy` again, note that this may take some time. -* To stop the deployment: +* To stop the deployment, use the `undeploy` command: [source,bash] ---- kn worklow undeploy ---- * You can validate your pod is terminating using k9s cli. - [[proc-testing-application]] == Testing your workflow application From ad0c95ce8fcd5fddca6f8d1d3cf78cd8a65271f8 Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Wed, 2 Aug 2023 13:29:19 +0200 Subject: [PATCH 3/8] Fix typos, use empty brackets for referrences --- ...rkflow-service-with-kn-cli-and-vscode.adoc | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc index b446e2b29..609908e62 100644 --- a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -1,6 +1,6 @@ = Creating and running workflow projects using KN CLI and Visual Studio Code -This guide showcases the use of our Knative Workflow CLI plugin and Visual Studio code to create & run {product_name} projects. +This guide showcases using the Knative Workflow CLI plugin and Visual Studio code to create & run {product_name} projects. .Prerequisites * xref:tooling/kn-plugin-workflow-overview.adoc[Knative Workflow CLI] {kn_cli_version} is installed. @@ -16,32 +16,32 @@ This guide showcases the use of our Knative Workflow CLI plugin and Visual Studi minikube start --cpus 4 --memory 8096 --addons registry --addons metrics-server --insecure-registry "10.0.0.0/24" --insecure-registry "localhost:5000" --driver=docker ---- * (optional) Install https://k9scli.io/[k9scli.io] -* Install the https://operatorhub.io/operator/sonataflow-operator[Sonataflow Operator] +* Install the xref:cloud/operator/install-serverless-operator[Sonataflow Operator] or * Install https://github.com/kiegroup/kie-tools/releases/tag/0.30.3[KN Workflow CLI] by downloading the correct distrubiton for your development environment and adding it to the PATH. [[proc-creating-app-with-kn-cli]] == Creating a workflow project with Visual Studio Code and KN CLI -Use the `create`` command with kn workflow to scaffold a new Sonata Flow project. +Use the `create` command with kn workflow to scaffold a new Sonata Flow project. * Navigate to you development directory and create your project. [source,bash] ---- kn workflow create -n my-sonataflow-project ---- -* This will create a folder with name `my-sonataflow-project` and a sample workflow `wokrflow.sw.json` +* This will create a folder with name `my-sonataflow-project` and a sample workflow `workflow.sw.json` [source,bash] ---- cd ./my-sonataflow-project ---- -* Open the folder in Visual Studo Code and examine the created `worklow.sw.json` using our extension. +* Open the folder in Visual Studo Code and examine the created `workflow.sw.json` using our extension. -Now we can run the project and execute your workflow. +Now you can run the project and execute the workflow. [[proc-running-app-with-kn-cli]] -== Running a workflow project with Visual Studio Code and KN CLI +== Running a Workflow project with Visual Studio Code and KN CLI -Use the `run` command with kn workflow to build and run the Sonata Flow project in local development mode. +Use the `run` command with kn workflow to build and run the {product_name} project in local development mode. * Run the project. This will start a `kogito-swf-devmode-nightly` image and map your local folder to this image. [source,bash] @@ -51,14 +51,14 @@ kn workflow run * The Development UI wil be accesible at `localhost:8080/q/dev` * You can now work on your project. Any changes will be picked up by the hot reload feature. * See xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-workflow-instances.adoc[Workflow instances] guide on how to run workflows via Development UI. -* Once you are done developing your project navigate to terminal that is running `kn workflow run` command and hit `Ctlr+C` to stop the development environment. +* Once you are done developing your project navigate to the terminal that is running the `kn workflow run` command and hit `Ctlr+C` to stop the development environment. To deploy the finished project to a local cluster, proceed to next section. [[proc-deploying-app-with-kn-cli]] == Deploying a workflow project with Visual Studio Code and KN CLI -Use the `deploy` command with kn workflow to deploy the Sonata Flow project into your local cluster. +Use the `deploy` command with kn workflow to deploy the {product_name} project into your local cluster. * Deploy to minikube [source,bash] @@ -90,9 +90,9 @@ xref:testing-and-troubleshooting/basic-integration-tests-with-restassured.adoc[T == Additional resources -* xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-overview.adoc[Kogito Serverless Workflow Tools extension in Quarkus Dev UI]: View, manage, and start the workflow instances. -* xref:getting-started/getting-familiar-with-our-tooling.adoc[Getting familiar with {product_name} tooling] -* xref:service-orchestration/orchestration-of-openapi-based-services.adoc[Orchestrating the OpenAPI services] +* xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-overview.adoc[] +* xref:getting-started/getting-familiar-with-our-tooling.adoc[] +* xref:service-orchestration/orchestration-of-openapi-based-services.adoc[] include::../../pages/_common-content/report-issue.adoc[] From d32713c2b8e5e1e5a90a5b6fbfc5206f54f8cbc5 Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Wed, 2 Aug 2023 13:31:23 +0200 Subject: [PATCH 4/8] Reference our guide for operator install --- ...eate-your-first-workflow-service-with-kn-cli-and-vscode.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc index 609908e62..a2d1c9432 100644 --- a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -16,7 +16,7 @@ This guide showcases using the Knative Workflow CLI plugin and Visual Studio cod minikube start --cpus 4 --memory 8096 --addons registry --addons metrics-server --insecure-registry "10.0.0.0/24" --insecure-registry "localhost:5000" --driver=docker ---- * (optional) Install https://k9scli.io/[k9scli.io] -* Install the xref:cloud/operator/install-serverless-operator[Sonataflow Operator] or +* xref:cloud/operator/install-serverless-operator.adoc[] * Install https://github.com/kiegroup/kie-tools/releases/tag/0.30.3[KN Workflow CLI] by downloading the correct distrubiton for your development environment and adding it to the PATH. [[proc-creating-app-with-kn-cli]] From b3a39843745112be92eea41b0941c1e8f29b61b5 Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Mon, 7 Aug 2023 08:39:15 +0200 Subject: [PATCH 5/8] KOGITO-9455: Improve Testing your application section Expplains basics fo accesing the project via REST using CURL. --- ...rkflow-service-with-kn-cli-and-vscode.adoc | 23 +++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc index a2d1c9432..16eae22ab 100644 --- a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -85,8 +85,27 @@ kn worklow undeploy [[proc-testing-application]] == Testing your workflow application -To test your workflow application, you can follow the instructions in the -xref:testing-and-troubleshooting/basic-integration-tests-with-restassured.adoc[Testing your workflow application using REST Assured]. +To test your workflow application you can use any capable REST client out there. All that is needeed is the URL of your deployed worklow project. + +.Prerequisites +* You have your workflow project deployed using <> and you have the URL where it is deployed handy. + +.Testing your workflow application +* To test your workflow project, access the Swagger UI on `/q/swagger-ui` to examine available endpoints. +* In order to execute the workflow once, run: +[source,bash] +---- +curl -X 'POST' \ + '/hello' \ + -H 'accept: */*' \ + -H 'Content-Type: application/json' \ + -d '{ + "workflowdata": {} +}' +---- +* To examine executed instance you can use the GraphQL UI by navigating to +`/q/graphl-ui` or calling additional REST queries. + == Additional resources From e1b9a0e025b84f6d8bf2072f93dca334440add53 Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Mon, 7 Aug 2023 13:46:29 +0200 Subject: [PATCH 6/8] KOGITO-9455: Fix typos, invalid page refs and improve text --- ...st-workflow-service-with-kn-cli-and-vscode.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc index 16eae22ab..ce986bc76 100644 --- a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -3,7 +3,7 @@ This guide showcases using the Knative Workflow CLI plugin and Visual Studio code to create & run {product_name} projects. .Prerequisites -* xref:tooling/kn-plugin-workflow-overview.adoc[Knative Workflow CLI] {kn_cli_version} is installed. +* xref:testing-and-troubleshooting/kn-plugin-workflow-overview.adoc[Knative Workflow CLI] {kn_cli_version} is installed. * Visual Studio Code with https://marketplace.visualstudio.com/items?itemName=redhat.vscode-extension-serverless-workflow-editor[Red Hat Serverless Workflow Editor] is installed to edit your workflows. .Preparing your environment @@ -17,12 +17,12 @@ minikube start --cpus 4 --memory 8096 --addons registry --addons metrics-server ---- * (optional) Install https://k9scli.io/[k9scli.io] * xref:cloud/operator/install-serverless-operator.adoc[] -* Install https://github.com/kiegroup/kie-tools/releases/tag/0.30.3[KN Workflow CLI] by downloading the correct distrubiton for your development environment and adding it to the PATH. +* Install https://github.com/kiegroup/kie-tools/releases/tag/0.30.3[KN Workflow CLI] by downloading the correct distribution for your development environment and adding it to the PATH. [[proc-creating-app-with-kn-cli]] == Creating a workflow project with Visual Studio Code and KN CLI -Use the `create` command with kn workflow to scaffold a new Sonata Flow project. +Use the `create` command with kn workflow to scaffold a new SonataFlow project. * Navigate to you development directory and create your project. [source,bash] @@ -43,14 +43,14 @@ Now you can run the project and execute the workflow. Use the `run` command with kn workflow to build and run the {product_name} project in local development mode. -* Run the project. This will start a `kogito-swf-devmode-nightly` image and map your local folder to this image. +* Run the project. [source,bash] ---- kn workflow run ---- * The Development UI wil be accesible at `localhost:8080/q/dev` * You can now work on your project. Any changes will be picked up by the hot reload feature. -* See xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-workflow-instances.adoc[Workflow instances] guide on how to run workflows via Development UI. +* See xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-workflow-instances-page.adoc[Workflow instances] guide on how to run workflows via Development UI. * Once you are done developing your project navigate to the terminal that is running the `kn workflow run` command and hit `Ctlr+C` to stop the development environment. To deploy the finished project to a local cluster, proceed to next section. @@ -88,7 +88,7 @@ kn worklow undeploy To test your workflow application you can use any capable REST client out there. All that is needeed is the URL of your deployed worklow project. .Prerequisites -* You have your workflow project deployed using <> and you have the URL where it is deployed handy. +* You have your workflow project deployed using <> and you have the URL where it is deployed handy. .Testing your workflow application * To test your workflow project, access the Swagger UI on `/q/swagger-ui` to examine available endpoints. @@ -104,7 +104,7 @@ curl -X 'POST' \ }' ---- * To examine executed instance you can use the GraphQL UI by navigating to -`/q/graphl-ui` or calling additional REST queries. +`/q/graphl-ui`. == Additional resources From 29b695519c4e746dbc75d44612dbbd7907f9a1aa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dominik=20Han=C3=A1k?= Date: Mon, 14 Aug 2023 08:19:20 +0200 Subject: [PATCH 7/8] Fix typo in serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Marián Macik --- ...eate-your-first-workflow-service-with-kn-cli-and-vscode.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc index ce986bc76..c45f3bf2a 100644 --- a/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc +++ b/serverlessworkflow/modules/ROOT/pages/getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc @@ -53,7 +53,7 @@ kn workflow run * See xref:testing-and-troubleshooting/quarkus-dev-ui-extension/quarkus-dev-ui-workflow-instances-page.adoc[Workflow instances] guide on how to run workflows via Development UI. * Once you are done developing your project navigate to the terminal that is running the `kn workflow run` command and hit `Ctlr+C` to stop the development environment. -To deploy the finished project to a local cluster, proceed to next section. +To deploy the finished project to a local cluster, proceed to the next section. [[proc-deploying-app-with-kn-cli]] == Deploying a workflow project with Visual Studio Code and KN CLI From c3e9de0ed558079ad172cabdf60cc7ee397667fc Mon Sep 17 00:00:00 2001 From: Dominik Hanak Date: Wed, 16 Aug 2023 09:00:07 +0200 Subject: [PATCH 8/8] KOGITO-9455: Add guide to nav.adoc and index.adoc --- serverlessworkflow/modules/ROOT/nav.adoc | 3 +-- serverlessworkflow/modules/ROOT/pages/index.adoc | 8 ++++++++ 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/serverlessworkflow/modules/ROOT/nav.adoc b/serverlessworkflow/modules/ROOT/nav.adoc index d84a392b0..706d90092 100644 --- a/serverlessworkflow/modules/ROOT/nav.adoc +++ b/serverlessworkflow/modules/ROOT/nav.adoc @@ -1,7 +1,6 @@ * xref:release_notes.adoc[Release notes] * Getting Started -// TODO: https://issues.redhat.com/browse/KOGITO-9455 -//** Creating a Workflow Project +** xref:getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc[] ** xref:getting-started/create-your-first-workflow-service.adoc[] // We will refactor this section here: https://issues.redhat.com/browse/KOGITO-9451 //** xref:getting-started/getting-familiar-with-our-tooling.adoc[Getting familiar with tooling] diff --git a/serverlessworkflow/modules/ROOT/pages/index.adoc b/serverlessworkflow/modules/ROOT/pages/index.adoc index 6b262aaaf..f9e91ae7d 100644 --- a/serverlessworkflow/modules/ROOT/pages/index.adoc +++ b/serverlessworkflow/modules/ROOT/pages/index.adoc @@ -19,6 +19,14 @@ xref:getting-started/create-your-first-workflow-service.adoc[] Learn how to create your first Quarkus Workflow Project -- +[.card] +-- +[.card-title] +xref:getting-started/create-your-first-workflow-service-with-kn-cli-and-vscode.adoc[] +[.card-description] +Learn how to create & run your first {Kogito Serverless Workflow} project. +-- + // We will refactor this section here: https://issues.redhat.com/browse/KOGITO-9451 //[.card] //--