feat: STAC collection output parameter template TDE-1673 (#1086)

📣 Merge after linz/argo-tasks#1282 is
merged and released in Argo Tasks v5.

**Motivation**
The new tileindex-validate command behaviour requires the scale of
existing datasets to override automatic tiling, if necessary. This
requires an extra workflow task `tpl-at-stac-collection-output`.

**Modifications**
Added a new workflow `tpl-at-stac-collection-output` to read the ODR
collection and output the scale as an Argo Workflows output parameter.
Other parameters can be added later if necessary.

**Verification**
Workflow run with [Argo Tasks PR
container](linz/argo-tasks#1282).

Author: amfage

templates/argo-tasks/README.md

@@ -8,6 +8,7 @@
 - [List](##argo-tasks/list)
 - [Push to Github](##argo-tasks/push-to-github)
 - [Generate Path](##argo-tasks/generate-path)
+- [STAC collection output](##argo-tasks/stac-collection-output)
 - [STAC setup](##argo-tasks/stac-setup)
 - [STAC validate](##argo-tasks/stac-validate)
 - [Identify updated items](##argo-tasks/identify-updated-items)
@@ -226,6 +227,27 @@ arguments:
       value: '{{inputs.parameters.source}}'
 ```
 
+## argo-tasks/stac-collection-output
+
+Template to read a STAC collection from the ODR and write STAC metadata as workflow output parameters; can add more outputs as required. Currently outputs `scale`
+See (https://github.com/linz/argo-tasks#stac-collection-output)
+
+### Template Usage
+
+```yaml
+- name: get-scale
+  templateRef:
+    name: tpl-at-stac-collection-output
+    template: main
+  arguments:
+    parameters:
+      - name: odr_url
+        value: '{{workflow.parameters.odr_url}}'
+      - name: version
+        value: '{{workflow.parameters.version_argo_tasks}}'
+  when: "'{{workflow.parameters.odr_url}}' != ''"
+```
+
 ## argo-tasks/stac-setup
 
 Template to set up STAC metadata; outputs `collection-id` and `linz-slug` and optionally verifies the GSD matches any existing data.

templates/argo-tasks/stac-collection-output.yml

@@ -0,0 +1,38 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/argoproj/argo-workflows/v3.5.5/api/jsonschema/schema.json
+
+apiVersion: argoproj.io/v1alpha1
+kind: WorkflowTemplate
+metadata:
+  # Template from linz/argo-tasks
+  # see https://github.com/linz/argo-tasks#stac-collection-output
+  name: tpl-at-stac-collection-output
+spec:
+  entrypoint: main
+  templates:
+    - name: main
+      inputs:
+        parameters:
+          - name: odr_url
+            description: 'S3 path to existing dataset collection.json'
+            default: ''
+          - name: version
+            description: 'argo-tasks container version to use'
+            default: 'v5'
+
+      container:
+        image: '019359803926.dkr.ecr.ap-southeast-2.amazonaws.com/argo-tasks:{{=inputs.parameters.version}}'
+        imagePullPolicy: Always
+        env:
+          - name: AWS_ROLE_CONFIG_PATH
+            value: s3://linz-bucket-config/config.json
+        args:
+          - 'stac'
+          - 'collection-output'
+          - "{{ '--odr-url=' + inputs.parameters.odr_url }}"
+
+      outputs:
+        parameters:
+          - name: scale
+            description: Scale of the ODR dataset
+            valueFrom:
+              path: '/tmp/stac-collection-output/scale'