Merge branch 'develop' into update-from-template-github_com_xdev-software_standard-maven-template_master-merged

Author: xdev-gh-bot

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -15,9 +15,9 @@ body:
     attributes:
       label: "Checklist"
       options:
-        - label: "I am able to reproduce the bug with the [latest version](https://github.com/xdev-software/template-placeholder/releases/latest)"
+        - label: "I am able to reproduce the bug with the [latest version](https://github.com/xdev-software/tci/releases/latest)"
           required: true
-        - label: "I made sure that there are *no existing issues* - [open](https://github.com/xdev-software/template-placeholder/issues) or [closed](https://github.com/xdev-software/template-placeholder/issues?q=is%3Aissue+is%3Aclosed) - which I could contribute my information to."
+        - label: "I made sure that there are *no existing issues* - [open](https://github.com/xdev-software/tci/issues) or [closed](https://github.com/xdev-software/tci/issues?q=is%3Aissue+is%3Aclosed) - which I could contribute my information to."
           required: true
         - label: "I have taken the time to fill in all the required details. I understand that the bug report will be dismissed otherwise."
           required: true

.github/ISSUE_TEMPLATE/enhancement.yml

@@ -13,7 +13,7 @@ body:
     attributes:
       label: "Checklist"
       options:
-        - label: "I made sure that there are *no existing issues* - [open](https://github.com/xdev-software/template-placeholder/issues) or [closed](https://github.com/xdev-software/template-placeholder/issues?q=is%3Aissue+is%3Aclosed) - which I could contribute my information to."
+        - label: "I made sure that there are *no existing issues* - [open](https://github.com/xdev-software/tci/issues) or [closed](https://github.com/xdev-software/tci/issues?q=is%3Aissue+is%3Aclosed) - which I could contribute my information to."
           required: true
         - label: "I have taken the time to fill in all the required details. I understand that the feature request will be dismissed otherwise."
           required: true

.github/ISSUE_TEMPLATE/question.yml

@@ -12,7 +12,7 @@ body:
     attributes:
       label: "Checklist"
       options:
-        - label: "I made sure that there are *no existing issues* - [open](https://github.com/xdev-software/template-placeholder/issues) or [closed](https://github.com/xdev-software/template-placeholder/issues?q=is%3Aissue+is%3Aclosed) - which I could contribute my information to."
+        - label: "I made sure that there are *no existing issues* - [open](https://github.com/xdev-software/tci/issues) or [closed](https://github.com/xdev-software/tci/issues?q=is%3Aissue+is%3Aclosed) - which I could contribute my information to."
           required: true
         - label: "I have taken the time to fill in all the required details. I understand that the question will be dismissed otherwise."
           required: true

.github/actions/docker-image-cache/README.md

@@ -0,0 +1,7 @@
+# Composite GitHub Actions
+
+Example usage can be found in [`run-integration-tests.yml`](../../workflows/run-integration-tests.yml)
+
+## Notes
+* [Parallel execution](https://github.blog/changelog/2026-06-25-actions-steps-can-now-be-run-in-parallel/) is not yet available for composite actions
+  * Therefore `restore` and `setup-buildx` are currently split as it's recommended that they be implemented in parallel downstream

.github/actions/docker-image-cache/restore/README.md

@@ -0,0 +1,3 @@
+Restores previously downloaded images from cache so that they don't need to be pulled again
+
+Additionally it also saves what images have already been pre-installed so that these might later not be [saved](../save/) into the cache.

.github/actions/docker-image-cache/restore/action.yml

@@ -0,0 +1,54 @@
+name: 'Restore docker image cache'
+description: 'Restore and load docker image cache'
+# Based on https://github.com/actions/cache/blob/v6/restore/action.yml
+inputs:
+  key:
+    description: 'An explicit key for restoring the cache'
+    required: true
+  restore-keys:
+    description: 'An ordered multiline string listing the prefix-matched keys, that are used for restoring stale cache if no cache hit occurred for key. Note `cache-hit` returns false in this case.'
+    required: false
+  save-preinstalled-images:
+    description: 'Should pre-installed images be saved (not recommended)'
+    required: false
+outputs:
+  key:
+    description: 'Identical to the input - can be used to prevent copy pasting'
+    value: ${{ inputs.key }}
+  cache-hit:
+    description: 'A boolean value to indicate an exact match was found for the primary key'
+    value: ${{ steps.restore-docker-image-cache.outputs.cache-hit }}
+runs:
+  using: "composite"
+  steps:
+    # NOTE 2026-07-09 Parallel execution is not yet available for composite actions
+    # https://github.blog/changelog/2026-06-25-actions-steps-can-now-be-run-in-parallel/
+    - name: Restore docker image cache
+      uses: actions/cache/restore@v6
+      id: restore-docker-image-cache
+      with:
+        path: ~/.cache/docker/
+        key: ${{ inputs.key }}
+        restore-keys: ${{ inputs.restore-keys }}
+
+    - name: Load docker image cache
+      shell: bash
+      run: |
+        if [ "${{ inputs.save-preinstalled-images }}" != true ]; then
+          echo "Getting preinstalled images" && docker image ls
+          preinstalled_image_ids=$(docker images -q | sort)
+
+          echo "Storing preinstalled image ids" && echo $preinstalled_image_ids
+          mkdir -p ~/.cache/docker-preinstalled
+          printf "%s\n" "${preinstalled_image_ids[@]}" > ~/.cache/docker-preinstalled/ids-${{ github.run_id }}.txt
+        fi
+
+        if [ -f ~/.cache/docker/images.tar ]; then
+          echo "Importing cache"
+          docker load -i ~/.cache/docker/images.tar && echo "Restored docker image cache" && docker image ls || true
+
+          echo "Deleting cache file to free up disk space"
+          rm -f ~/.cache/docker/images.tar || true
+        else
+          echo "No file cache file found"
+        fi

.github/actions/docker-image-cache/save/README.md

@@ -0,0 +1,7 @@
+Saves the pulled images into the cache
+
+An image will be ignored if:
+* it was preinstalled (this information is acquired from [restore](../restore/))
+* it is labeled with
+  * `org.testcontainers.sessionId` (Testcontainers `deleteOnExit` label)
+  * `tci.image-cache.ignore`

.github/actions/docker-image-cache/save/action.yml

@@ -0,0 +1,51 @@
+name: 'Save docker image cache'
+description: 'Save the docker image cache'
+# Based on https://github.com/actions/cache/blob/v6/restore/action.yml
+inputs:
+  key:
+    description: 'An explicit key for restoring the cache'
+    required: true
+  cache-hit:
+    description: 'A boolean value to indicate an exact match was found for the primary key'
+    required: false
+runs:
+  using: "composite"
+  steps:
+    - name: Create docker image cache
+      # Cache can't be saved when it's already present
+      if: inputs.cache-hit != 'true'
+      shell: bash
+      run: |
+        echo "Images before pruning" && docker image ls
+        docker image prune -f
+        echo "Currently available images" && docker image ls
+
+        has_preinstalled_ids=false
+        if [ -f ~/.cache/docker-preinstalled/ids-${{ github.run_id }}.txt ]; then
+          echo && echo "Will NOT cache pre-installed images" && cat ~/.cache/docker-preinstalled/ids-${{ github.run_id }}.txt
+          has_preinstalled_ids=true
+        fi
+
+        echo && echo "Will NOT cache the following images"
+        docker image ls -f="label=org.testcontainers.sessionId"
+        docker image ls -f="label=tci.image-cache.ignore"
+
+        mkdir -p ~/.cache/docker
+        image_ids_to_save=$(comm -23 <(docker images -q | sort) <((docker image ls -q -f="label=org.testcontainers.sessionId"; docker image ls -q -f="label=tci.image-cache.ignore") | sort | uniq))
+        if [ "$has_preinstalled_ids" = true ]; then
+          image_ids_to_save=$(comm -23 <(echo "${image_ids_to_save[@]}") <(cat ~/.cache/docker-preinstalled/ids-${{ github.run_id }}.txt || echo ""))
+        fi
+        echo && echo "Saving image ids" && echo $image_ids_to_save
+        docker save $image_ids_to_save -o ~/.cache/docker/images.tar || true
+
+        ls -lha ~/.cache/docker
+        if [ "$has_preinstalled_ids" = true ]; then
+          rm -f ~/.cache/docker-preinstalled/ids-${{ github.run_id }}.txt || true
+        fi
+
+    - name: Save docker image cache
+      if: inputs.cache-hit != 'true'
+      uses: actions/cache/save@v6
+      with:
+        path: ~/.cache/docker/
+        key: ${{ inputs.key }}

.github/actions/docker-image-cache/setup-buildx/README.md

@@ -0,0 +1 @@
+Set's up the buildx worker and returns [required environment variables](https://docs.docker.com/build/cache/backends/gha/#authentication) for the buildx build.

.github/actions/docker-image-cache/setup-buildx/action.yml

@@ -0,0 +1,23 @@
+name: 'Setup buildx'
+description: 'Setup buildx'
+outputs:
+  ACTIONS_RUNTIME_TOKEN:
+    value: ${{ steps.actions-vars.outputs.ACTIONS_RUNTIME_TOKEN }}
+  ACTIONS_RESULTS_URL:
+    value: ${{ steps.actions-vars.outputs.ACTIONS_RESULTS_URL }}
+runs:
+  using: "composite"
+  steps:
+    # These are required for caching 
+    # https://docs.docker.com/build/cache/backends/gha/#authentication
+    - name: Get Actions Runtime credentials
+      if: runner.os != 'Windows'
+      id: actions-vars
+      uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v9.0.0
+      with:
+        script: |
+          core.setOutput('ACTIONS_RUNTIME_TOKEN', process.env['ACTIONS_RUNTIME_TOKEN'])
+          core.setOutput('ACTIONS_RESULTS_URL', process.env['ACTIONS_RESULTS_URL'])
+
+    - uses: docker/setup-buildx-action@v4
+      if: runner.os != 'Windows'