From 4779a5aa8e95e3dde640179cda2b2211aa852df1 Mon Sep 17 00:00:00 2001
From: Martin Basti <mbasti@redhat.com>
Date: Thu, 25 Jul 2024 21:17:12 +0200
Subject: [PATCH] Readme: prefetch-deps: example of usage of configfile

Add example how config file should be used

Signed-off-by: Martin Basti <mbasti@redhat.com>
---
 .../prefetch-dependencies-oci-ta/0.1/README.md | 18 ++++++++++++++++++
 .../0.1/prefetch-dependencies-oci-ta.yaml      | 18 ++++++++++++++++++
 .../0.1/recipe.yaml                            | 18 ++++++++++++++++++
 task/prefetch-dependencies/0.1/README.md       | 17 +++++++++++++++++
 .../0.1/prefetch-dependencies.yaml             | 18 ++++++++++++++++++
 5 files changed, 89 insertions(+)

diff --git a/task/prefetch-dependencies-oci-ta/0.1/README.md b/task/prefetch-dependencies-oci-ta/0.1/README.md
index fa66e7c565..48065f95ea 100644
--- a/task/prefetch-dependencies-oci-ta/0.1/README.md
+++ b/task/prefetch-dependencies-oci-ta/0.1/README.md
@@ -5,6 +5,24 @@ application source code are stored as a trusted artifact in the provided OCI rep
 For additional info on Cachi2, see docs at
 https://github.com/containerbuildsystem/cachi2#basic-usage.
 
+## Configuration
+
+Config file must be passed as a YAML string. For all available config options please check
+[available configuration parameters] page.
+
+Example of setting timeouts:
+
+```yaml
+params:
+  - name: config-file-content
+    value: |
+      ---
+      requests_timeout: 300
+      subprocess_timeout: 3600
+```
+
+[available configuration parameters]: https://github.com/containerbuildsystem/cachi2?tab=readme-ov-file#available-configuration-parameters
+
 ## Parameters
 |name|description|default value|required|
 |---|---|---|---|
diff --git a/task/prefetch-dependencies-oci-ta/0.1/prefetch-dependencies-oci-ta.yaml b/task/prefetch-dependencies-oci-ta/0.1/prefetch-dependencies-oci-ta.yaml
index b849e81c4c..cab5a26405 100644
--- a/task/prefetch-dependencies-oci-ta/0.1/prefetch-dependencies-oci-ta.yaml
+++ b/task/prefetch-dependencies-oci-ta/0.1/prefetch-dependencies-oci-ta.yaml
@@ -14,6 +14,24 @@ spec:
     application source code are stored as a trusted artifact in the provided OCI repository.
     For additional info on Cachi2, see docs at
     https://github.com/containerbuildsystem/cachi2#basic-usage.
+
+    ## Configuration
+
+    Config file must be passed as a YAML string. For all available config options please check
+    [available configuration parameters] page.
+
+    Example of setting timeouts:
+
+    ```yaml
+    params:
+      - name: config-file-content
+        value: |
+          ---
+          requests_timeout: 300
+          subprocess_timeout: 3600
+    ```
+
+    [available configuration parameters]: https://github.com/containerbuildsystem/cachi2?tab=readme-ov-file#available-configuration-parameters
   params:
     - name: SOURCE_ARTIFACT
       description: The Trusted Artifact URI pointing to the artifact with
diff --git a/task/prefetch-dependencies-oci-ta/0.1/recipe.yaml b/task/prefetch-dependencies-oci-ta/0.1/recipe.yaml
index 7856c82c41..52123a9469 100644
--- a/task/prefetch-dependencies-oci-ta/0.1/recipe.yaml
+++ b/task/prefetch-dependencies-oci-ta/0.1/recipe.yaml
@@ -27,6 +27,24 @@ description: |-
     application source code are stored as a trusted artifact in the provided OCI repository.
     For additional info on Cachi2, see docs at
     https://github.com/containerbuildsystem/cachi2#basic-usage.
+
+    ## Configuration
+
+    Config file must be passed as a YAML string. For all available config options please check
+    [available configuration parameters] page.
+
+    Example of setting timeouts:
+
+    ```yaml
+    params:
+      - name: config-file-content
+        value: |
+          ---
+          requests_timeout: 300
+          subprocess_timeout: 3600
+    ```
+
+    [available configuration parameters]: https://github.com/containerbuildsystem/cachi2?tab=readme-ov-file#available-configuration-parameters
 preferStepTemplate: true
 removeWorkspaces:
   - source
diff --git a/task/prefetch-dependencies/0.1/README.md b/task/prefetch-dependencies/0.1/README.md
index 71748965b9..7d03f7d3b3 100644
--- a/task/prefetch-dependencies/0.1/README.md
+++ b/task/prefetch-dependencies/0.1/README.md
@@ -3,6 +3,23 @@
 Task that uses Cachi2 to prefetch build dependencies.
 See docs at https://github.com/containerbuildsystem/cachi2#basic-usage.
 
+## Configuration
+
+Config file must be passed as a YAML string. For all available config options please check [available configuration parameters] page.
+
+Example of setting timeouts:
+
+```yaml
+params:
+    - name: config-file-content
+      value: |
+         ---
+         requests_timeout: 300
+         subprocess_timeout: 3600
+```
+
+[available configuration parameters]: https://github.com/containerbuildsystem/cachi2?tab=readme-ov-file#available-configuration-parameters
+
 ## Parameters
 |name|description|default value|required|
 |---|---|---|---|
diff --git a/task/prefetch-dependencies/0.1/prefetch-dependencies.yaml b/task/prefetch-dependencies/0.1/prefetch-dependencies.yaml
index d058fe8c96..6c2f0e3e73 100644
--- a/task/prefetch-dependencies/0.1/prefetch-dependencies.yaml
+++ b/task/prefetch-dependencies/0.1/prefetch-dependencies.yaml
@@ -11,6 +11,24 @@ spec:
   description: |-
     Task that uses Cachi2 to prefetch build dependencies.
     See docs at https://github.com/containerbuildsystem/cachi2#basic-usage.
+
+    ## Configuration
+
+    Config file must be passed as a YAML string. For all available config options please check
+    [available configuration parameters] page.
+
+    Example of setting timeouts:
+
+    ```yaml
+    params:
+      - name: config-file-content
+        value: |
+          ---
+          requests_timeout: 300
+          subprocess_timeout: 3600
+    ```
+
+    [available configuration parameters]: https://github.com/containerbuildsystem/cachi2?tab=readme-ov-file#available-configuration-parameters
   params:
   - description: Configures project packages that will have their dependencies prefetched.
     name: input