From b790638a731f85be15bc396bff80ea052149f50b Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:07:56 +0100 Subject: [PATCH 1/7] Create requirements_class_argo add argo req class --- .../standard/requirements/requirements_class_argo | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo diff --git a/extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo b/extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo new file mode 100644 index 00000000..f84bc0cc --- /dev/null +++ b/extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo @@ -0,0 +1,11 @@ +[[rc_cwl]] +[requirements_class] +==== +[%metadata] +label:: http://www.opengis.net/spec/ogcapi-processes-2/1.0/req/argo +obligation:: requirement +subject:: Web API +inherit:: <> +inherit:: <> +inherit:: Argo Workflow Language <> +==== From 83ff208c1371f7e2174d0a77cbc9c0024e9e26d1 Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:10:19 +0100 Subject: [PATCH 2/7] Create REC_body-argo.adoc added Argo --- .../deploy-replace-undeploy/replace/REC_body-argo.adoc | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/replace/REC_body-argo.adoc diff --git a/extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/replace/REC_body-argo.adoc b/extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/replace/REC_body-argo.adoc new file mode 100644 index 00000000..79584c5b --- /dev/null +++ b/extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/replace/REC_body-argo.adoc @@ -0,0 +1,10 @@ +[[rec_deploy-replace-undeploy_replace_body-argo]] +[recommendation] +==== +[%metadata] +label:: /rec/deploy-replace-undeploy/replace/body-argo + +part:: If a process can be described for the intended use as a <>, implementations should consider supporting the <> encoding for describing the replacement process. + +part:: The media type `application/argo` shall be used to indicate that request body contains a processes description encoded as <>. +==== From b0349c05c239fe15a5df9951848963d76df047bf Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:11:15 +0100 Subject: [PATCH 3/7] Rename requirements_class_argo to requirements_class_argo.adoc --- .../{requirements_class_argo => requirements_class_argo.adoc} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename extensions/deploy_replace_undeploy/standard/requirements/{requirements_class_argo => requirements_class_argo.adoc} (100%) diff --git a/extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo b/extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo.adoc similarity index 100% rename from extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo rename to extensions/deploy_replace_undeploy/standard/requirements/requirements_class_argo.adoc From e7b5b5c1097deb53caa3120a0019ffca9f51b2f6 Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:13:46 +0100 Subject: [PATCH 4/7] Create clause_10_argo.adoc added argo --- .../standard/sections/clause_10_argo.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 extensions/deploy_replace_undeploy/standard/sections/clause_10_argo.adoc diff --git a/extensions/deploy_replace_undeploy/standard/sections/clause_10_argo.adoc b/extensions/deploy_replace_undeploy/standard/sections/clause_10_argo.adoc new file mode 100644 index 00000000..74bbc122 --- /dev/null +++ b/extensions/deploy_replace_undeploy/standard/sections/clause_10_argo.adoc @@ -0,0 +1,16 @@ +== Requirements Class "Argo" + +[[argo-overview]] +=== Overview + +include::../requirements/requirements_class_argo.adoc[] + +A server that implements this conformance class supports the use of Argo encoding when interacting with the deploy-replace-undeploy extension from a processes API. + +In consequence, the following recommandations become requirements: + + * <> + * <> + * <> + + From 09038e840ad4ba9340e604097b18a81cd4a73a89 Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:14:19 +0100 Subject: [PATCH 5/7] Update 20-044.adoc added argo --- extensions/deploy_replace_undeploy/standard/20-044.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/extensions/deploy_replace_undeploy/standard/20-044.adoc b/extensions/deploy_replace_undeploy/standard/20-044.adoc index a10d9783..19178eb5 100644 --- a/extensions/deploy_replace_undeploy/standard/20-044.adoc +++ b/extensions/deploy_replace_undeploy/standard/20-044.adoc @@ -39,6 +39,8 @@ include::sections/clause_8_docker.adoc[] include::sections/clause_9_cwl.adoc[] +include::sections/clause_10_argo.adoc[] + include::sections/clause_10_oas.adoc[] include::sections/clause_11_media_types.adoc[] From c5ffa09c23cca19f358f1e14d39d87f0f6da922f Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:16:52 +0100 Subject: [PATCH 6/7] Create REC_ogcapppkg_execution-unit-argo.adoc added argo --- .../REC_ogcapppkg_execution-unit-argo.adoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 extensions/deploy_replace_undeploy/standard/recommendations/ogcapppkg/REC_ogcapppkg_execution-unit-argo.adoc diff --git a/extensions/deploy_replace_undeploy/standard/recommendations/ogcapppkg/REC_ogcapppkg_execution-unit-argo.adoc b/extensions/deploy_replace_undeploy/standard/recommendations/ogcapppkg/REC_ogcapppkg_execution-unit-argo.adoc new file mode 100644 index 00000000..5ba79d88 --- /dev/null +++ b/extensions/deploy_replace_undeploy/standard/recommendations/ogcapppkg/REC_ogcapppkg_execution-unit-argo.adoc @@ -0,0 +1,19 @@ +[[rec_ogcapppkg_execution-unit-argo]] +[recommendation] +==== +[%metadata] +label:: /rec/ogcapppkg/execution-unit-argo + +part:: If the execution unit is encoded in Argo then it is recommended that the contents of the execution unit be the properties: + * `type` and `href` if passed by reference + * `value` and `mediaType` if passed by value + +part:: The value of the `type` property shall be `application/argo`, when for `mediaType` it should be `application/argo+json`. + +part:: The value of the `href` property shall be a reference to the Argo encoded file. The value of the `value` property shall be the Argo encoded in json format. + +part:: If the Argo contains more than a single workflow identifier, an addition `w` query parameter may be used to target a specific workflow id to be deployed. + +part:: The server should validate the Argo at the request time. In case, the server cannot find the `w` identifier within the workflow from the Argo provided, a 400 status code is expected with the type "argo-worflow-not-exist". + +==== From 52f05efc23d395b0ea9a1e113e34d7b979ff2558 Mon Sep 17 00:00:00 2001 From: "Christophe Noel (Spacebel)" Date: Wed, 20 Dec 2023 16:19:54 +0100 Subject: [PATCH 7/7] Create REC_body-argo.adoc added argo --- .../deploy/REC_body-argo.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/deploy/REC_body-argo.adoc diff --git a/extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/deploy/REC_body-argo.adoc b/extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/deploy/REC_body-argo.adoc new file mode 100644 index 00000000..6f2358c6 --- /dev/null +++ b/extensions/deploy_replace_undeploy/standard/recommendations/deploy-replace-undeploy/deploy/REC_body-argo.adoc @@ -0,0 +1,15 @@ +[[rec_deploy-replace-undeploy_deploy_body-argo]] +[recommendation] +==== +[%metadata] +label:: /rec/deploy-replace-undeploy/deploy/body-argo + +part:: If a process can be represented for the intended use as a <>, implementations should consider supporting the <> encoding for describing the process to be deployed to the API. + +part:: The media type `application/argo` shall be used to indicate that request body contains a processes description encoded as a <>. + +part:: If the Argo contains more than one workflow, an additional `w` query parameter may be used to reference the workflow id to be deployed. + +part:: The server should validate the Argo at the request time. In case, the server cannot find the `w` identifier within the workflow from the Argo provided, a 400 status code is expected with the type "worflow-not-found". + +====