From 44877f4da5f0f4f59a4bbf7ff6da2254da71cefc Mon Sep 17 00:00:00 2001 From: Walter Medvedeo Date: Mon, 8 Jul 2024 09:06:34 +0200 Subject: [PATCH 1/2] KN workflow plugin installation --- serverlessworkflow/modules/ROOT/nav.adoc | 1 + .../operator/install-kn-workflow-cli.adoc | 90 +++++++++++++++++++ 2 files changed, 91 insertions(+) create mode 100644 serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc diff --git a/serverlessworkflow/modules/ROOT/nav.adoc b/serverlessworkflow/modules/ROOT/nav.adoc index 3fcd0031b..ef0a4c63a 100644 --- a/serverlessworkflow/modules/ROOT/nav.adoc +++ b/serverlessworkflow/modules/ROOT/nav.adoc @@ -71,6 +71,7 @@ ** xref:cloud/custom-ingress-authz.adoc[Securing Workflows] ** Operator *** xref:cloud/operator/install-serverless-operator.adoc[Installation] +*** xref:cloud/operator/install-kn-workflow-cli.adoc[Kn Workflow CLI Installation] *** xref:cloud/operator/global-configuration.adoc[Admin Configuration] *** xref:cloud/operator/developing-workflows.adoc[Development Mode] *** xref:cloud/operator/referencing-resource-files.adoc[Referencing Workflow Resources] diff --git a/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc b/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc new file mode 100644 index 000000000..0f9dac65a --- /dev/null +++ b/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc @@ -0,0 +1,90 @@ += Installing the Knative Workflow Plugin +:compat-mode!: +// Metadata: +:description: Install the operator on Kubernetes clusters +:keywords: kogito, sonataflow, workflow, serverless, operator, kubernetes, minikube, openshift, containers +// links + +*Prerequisites* + +https://75129--ocpdocs-pr.netlify.app/openshift-serverless/latest/install/installing-kn + +* You have first installed the link:https://76490--ocpdocs-pr.netlify.app/openshift-serverless/latest/install/installing-kn[Knative CLI]. + +== Installing the Knative Workflow Plugin using the artifacts image + +To install the Knative Workflow Plugin using the artifacts image you must follow this procedure: + +*Start the `kn-workflow-cli-artifacts-rhel8` image* + +[source, shell] +---- +export KN_IMAGE=registry.redhat.io/openshift-serverless-1/kn-workflow-cli-artifacts-rhel8:1.33.0 + +export KN_CONTAINER_ID=$(docker run -di $KN_IMAGE) +---- + +*Copy the Knative Workflow Plugin binary according to your environment* + +.Binaries copy for `Linux` amd64 / arm64 architectures +[source, shell] +---- +docker cp $KN_CONTAINER_ID:/usr/share/kn/linux_amd64/kn-workflow-linux-amd64.tar.gz kn-workflow-linux-amd64.tar.gz + +docker cp $KN_CONTAINER_ID:/usr/share/kn/linux_arm64/kn-workflow-linux-arm64.tar.gz kn-workflow-linux-arm64.tar.gz +---- + +.Binaries copy for `macOS` amd64 / arm64 architectures +[source, shell] +---- +docker cp $KN_CONTAINER_ID:/usr/share/kn/macos_amd64/kn-workflow-macos-amd64.tar.gz kn-workflow-macos-amd64.tar.gz + +docker cp $KN_CONTAINER_ID:/usr/share/kn/macos_arm64/kn-workflow-macos-arm64.tar.gz kn-workflow-macos-arm64.tar.gz +---- + +.Binaries copy for `Windows` amd64 architecture +[source, shell] +---- +docker cp $KN_CONTAINER_ID:/usr/share/kn/windows/kn-workflow-windows-amd64.zip kn-workflow-windows-amd64.zip +---- + +*Stop the Container* + +[source, shell] +---- +docker stop $KN_CONTAINER_ID + +docker rm $KN_CONTAINER_ID +---- + +*Extract the selected Knative Workflow Plugin binary* + +.Extract the binary example +[source,shell] +---- +tar xvzf kn-workflow-linux-amd64.tar.gz +---- + +In the ``, you'll find the `kn` executable that you must rename to `kn-workflow` + +[source,shell] +---- +mv /kn /kn-workflow +---- + +[IMPORTANT] +==== +Make sure that `` is included in your system PATH. +==== + +To verify that the installation was successful, you can execute the following command: +[source,shell] +---- +kn workflow version +---- +output: +[source,shell] +---- +1.33.0 +---- + From b233f72f4f8b2c64a8e08dfa183b9fb978f5f3ba Mon Sep 17 00:00:00 2001 From: Walter Medvedeo Date: Tue, 9 Jul 2024 12:16:57 +0200 Subject: [PATCH 2/2] Update serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc --- .../ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc b/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc index 0f9dac65a..0f1e1f423 100644 --- a/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc +++ b/serverlessworkflow/modules/ROOT/pages/cloud/operator/install-kn-workflow-cli.adoc @@ -19,7 +19,7 @@ To install the Knative Workflow Plugin using the artifacts image you must follow [source, shell] ---- -export KN_IMAGE=registry.redhat.io/openshift-serverless-1/kn-workflow-cli-artifacts-rhel8:1.33.0 +export KN_IMAGE=registry.redhat.io/openshift-serverless-1/logic-kn-workflow-cli-artifacts-rhel8:1.33.0 export KN_CONTAINER_ID=$(docker run -di $KN_IMAGE) ----