Add integration tests with minimal toy spread project

.github/workflows/integration-test.yaml

@@ -0,0 +1,20 @@
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: Canonical Ltd.
+name: Integration Tests
+on:
+    push:
+        branches: ["main"]
+    pull_request:
+jobs:
+    toy-test:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+              with:
+                fetch-depth: 0
+            - name: Run toy integration test
+              uses: ./
+              with:
+                garden-system: ubuntu-cloud-24.04
+                spread-subdir: tests/toy

.gitignore

@@ -1,2 +1,4 @@
 # SPDX-License-Identifier: Apache-2.0
 # SPDX-FileCopyrightText: Canonical Ltd.
+.image-garden/*
+!.image-garden/README.md

action.yaml

@@ -84,7 +84,7 @@ runs:
             path: |
                 ${{ inputs.spread-subdir }}/.image-garden
                 !${{ inputs.spread-subdir }}/.image-garden/*.log
-            key: image-garden-img-${{ inputs.garden-system }}-${{ hashFiles('.image-garden.mk') }}
+            key: image-garden-img-${{ inputs.garden-system }}-${{ hashFiles(format('{0}/.image-garden.mk', inputs.spread-subdir)) }}
         - name: Restore mtime of .image-garden.mk
           if: hashFiles('.image-garden.mk') != ''
           shell: bash

tests/toy/.image-garden.mk

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: Canonical Ltd.

tests/toy/.image-garden/README.md

@@ -0,0 +1,13 @@
+<!--
+SPDX-License-Identifier: Apache-2.0
+SPDX-FileCopyrightText: Canonical Ltd.
+-->
+
+# Image Garden State Directory
+
+This directory is used by `image-garden` to store large temporary files.
+It should be ignored in `.gitignore` apart from this `README.md` file
+itself.
+
+Consult documentation of [spread](https://github.com/canonical/spread) and
+[image-garden](https://gitlab.com/zygoon/image-garden).

tests/toy/spread.yaml

@@ -0,0 +1,27 @@
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: Canonical Ltd.
+project: toy
+path: /root/toy
+exclude:
+    - .image-garden/
+    - .git
+backends:
+    garden:
+        type: adhoc
+        allocate: |
+            if [ -n "${SPREAD_HOST_PATH-}" ]; then
+                PATH="$SPREAD_HOST_PATH"
+            fi
+            exec image-garden allocate "$SPREAD_SYSTEM"."$(uname -m)"
+        discard: |
+            if [ -n "${SPREAD_HOST_PATH-}" ]; then
+                PATH="$SPREAD_HOST_PATH"
+            fi
+            exec image-garden discard "$SPREAD_SYSTEM_ADDRESS"
+        systems:
+            - ubuntu-cloud-24.04:
+                username: root
+                password: root
+suites:
+    tests/:
+        summary: Toy integration tests

tests/toy/tests/success/task.yaml

@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: Canonical Ltd.
+summary: Simple success test that prints hello world
+execute: |
+    echo "hello world"
+    echo "Integration test successful!"