Adds shared_gallery_image_version_end_of_life_date

.github/ISSUE_TEMPLATE/announcement.yml

@@ -38,12 +38,12 @@ body:
       options:
         - label: Ubuntu 22.04
         - label: Ubuntu 24.04
-        - label: macOS 13
-        - label: macOS 13 Arm64
+        - label: Ubuntu Slim
         - label: macOS 14
         - label: macOS 14 Arm64
         - label: macOS 15
         - label: macOS 15 Arm64
+        - label: macOS 26 Arm64
         - label: Windows Server 2019
         - label: Windows Server 2022
         - label: Windows Server 2025

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -21,12 +21,12 @@ body:
       options:
         - label: Ubuntu 22.04
         - label: Ubuntu 24.04
-        - label: macOS 13
-        - label: macOS 13 Arm64
+        - label: Ubuntu Slim
         - label: macOS 14
         - label: macOS 14 Arm64
         - label: macOS 15
         - label: macOS 15 Arm64
+        - label: macOS 26 Arm64
         - label: Windows Server 2019
         - label: Windows Server 2022
         - label: Windows Server 2025

.github/ISSUE_TEMPLATE/tool-request.yml

@@ -59,12 +59,12 @@ body:
       options:
         - label: Ubuntu 22.04
         - label: Ubuntu 24.04
-        - label: macOS 13
-        - label: macOS 13 Arm64
+        - label: Ubuntu Slim
         - label: macOS 14
         - label: macOS 14 Arm64
         - label: macOS 15
         - label: macOS 15 Arm64
+        - label: macOS 26 Arm64
         - label: Windows Server 2019
         - label: Windows Server 2022
         - label: Windows Server 2025

.github/copilot-instructions.md

@@ -0,0 +1,39 @@
+# GitHub Copilot Instructions for Actions Runner Images Repository
+
+## Scope and goals
+
+- This repository serves as the source for building GitHub Actions runner and Azure DevOps agent images for Windows, Ubuntu, and macOS. You can find exact versions in the [Available Images](../README.md#available-images) section of README.md. Windows and Ubuntu images build on Azure infrastructure using Packer; macOS images use Anka virtualization.
+- Emphasize best practices for contributing to open-source projects, including code style, commit messages, and pull request etiquette.
+- Prefer clarity and correctness over creativity. If information is missing, ask clarifying questions or insert TODOs instead of guessing.
+
+## Code and command instructions
+
+- Follow the code style guide in [CONTRIBUTING.md](../CONTRIBUTING.md#code-style-guide) for Bash and PowerShell scripts, including naming conventions, file structure, and indentation rules.
+- Focus on re-using helpers when writing scripts. Windows, Linux and Ubuntu scripts have helper functions available to simplify installation and validation.
+- Always confirm versions and installation paths against existing toolset files and installation scripts.
+
+## Output format
+
+- Use GitHub Flavored Markdown only. Avoid raw HTML unless necessary.
+- One H1 (`#`) per page, followed by logical, sequential headings (`##`, `###`, …).
+- Use fenced code blocks with language identifiers (` ```bash `, ` ```json `, ` ```yaml `, etc.).
+- Use blockquote callouts for notes:
+  > [!NOTE] Context or nuance  
+  > [!TIP] Helpful hint  
+  > [!WARNING] Risks or breaking changes  
+  > [!IMPORTANT] Critical requirement for functionality
+
+## Style and tone
+
+- Audience: Open-source contributors, GitHub Actions maintainers, and developers building custom runner images. Assume familiarity with CI/CD concepts, Packer, and basic infrastructure provisioning, but explain platform-specific details (Azure for Windows/Ubuntu, Anka for macOS) when relevant.
+- Voice: Second person ("you"), active voice, imperative for operational steps.
+- Be concise: short paragraphs and sentences. Prefer lists and step-by-steps, especially for operational procedures and troubleshooting.
+- Use inclusive, accessible language. Avoid idioms, sarcasm, and culturally specific references.
+- English: en-US (spelling, punctuation, and units).
+
+## Safety and integrity
+
+- Do not expose sensitive credentials (API tokens, Azure subscription IDs, etc.) in code examples.
+- Do not fabricate tool versions, installation paths, or software availability without verifying against toolset files or actual installation scripts.
+- Always call out assumptions and limitations explicitly, especially for changes affecting runner image behavior or software availability.
+- If ambiguous requests are made about image modifications, ask clarifying questions about target OS, tool versions, and compatibility requirements before proceeding.

.github/workflows/check-pinned-versions.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Validate JSON Schema
         shell: pwsh

.github/workflows/codeql-analysis.yml

@@ -40,7 +40,7 @@ jobs:
 
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL

.github/workflows/create_github_release.yml

@@ -10,13 +10,12 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
-
     - name: Create release for ${{ github.event.client_payload.ReleaseBranchName }}
-      uses: ncipollo/release-action@v1.16.0
+      uses: ncipollo/release-action@b7eabc95ff50cbeeedec83973935c8f306dfcd0b #v1.20.0
       with:
         tag: ${{ github.event.client_payload.ReleaseBranchName }}
         name: ${{ github.event.client_payload.ReleaseTitle }}
         body: ${{ github.event.client_payload.ReleaseBody }}
         prerelease: ${{ github.event.client_payload.Prerelease }}
         commit: ${{ github.event.client_payload.Commitish }}
+        allowUpdates: true

.github/workflows/create_pull_request.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 0
 
@@ -22,22 +22,36 @@ jobs:
 
     - name: Create pull request for ${{ github.event.client_payload.ReleaseBranchName }}
       id: create-pr
-      uses: actions/github-script@v7
+      uses: actions/github-script@v8
       with:
         github-token: ${{secrets.GITHUB_TOKEN}}
         script: |
-          let response = await github.rest.pulls.create({
+          const pulls = await github.rest.pulls.list({
             owner: context.repo.owner,
             repo: context.repo.repo,
-            title: "${{ github.event.client_payload.PullRequestTitle }}",
-            head: "${{ github.event.client_payload.ReleaseBranchName }}-docs",
+            head: `${context.repo.owner}:${{ github.event.client_payload.ReleaseBranchName }}-docs`,
             base: "${{ github.event.client_payload.PullRequestBase }}",
-            body: `${{ github.event.client_payload.PullRequestBody }}`
+            state: 'open'
           });
-          return response.data.number
+
+          if (pulls.data.length > 0) {
+            console.log(`Pull request already exists: ${pulls.data[0].html_url}`);
+            return pulls.data[0].number;
+          } else {
+            console.log('No existing pull request found, creating new one');
+            let response = await github.rest.pulls.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: "${{ github.event.client_payload.PullRequestTitle }}",
+              head: "${{ github.event.client_payload.ReleaseBranchName }}-docs",
+              base: "${{ github.event.client_payload.PullRequestBase }}",
+              body: `${{ github.event.client_payload.PullRequestBody }}`
+            });
+            return response.data.number;
+          }
 
     - name: Request reviewers
-      uses: actions/github-script@v7
+      uses: actions/github-script@v8
       with:
         github-token: ${{secrets.PRAPPROVAL_SECRET}}
         script: |

.github/workflows/create_sbom_report.yml

@@ -1,97 +1,112 @@
 name: Create SBOM for the release
-# Inherited variables:
-# github.event.client_payload.agentSpec - Current YAML Label
-# github.event.client_payload.ReleaseID - Current release ID
-# github.event.client_payload.imageVersion - AzDO image version "major.minor"
-# github.event.client_payload.ReleaseBranchName - Necessary to identify workflow run
-#
-# Current SYFT tool issues:
-# macOS (major): prompt privilegies that blocking process indefinetely (https://github.com/anchore/syft/issues/1367)
-run-name: Collecting SBOM for ${{ github.event.client_payload.ReleaseBranchName || 'unknown release' }}
+
+run-name: Collecting SBOM for ${{ github.event.client_payload.agentSpec || 'unknown image' }} - ${{ github.event.client_payload.imageVersion || 'unknown version' }}
+
 on:
   repository_dispatch:
     types: [generate-sbom]
+
 defaults:
   run:
     shell: pwsh
+
 jobs:
-  #Checking current release for SBOM
   sbom-check:
     outputs:
       check_status: ${{ steps.check.outputs.status }}
     runs-on: ubuntu-latest
+    env:
+      RELEASE_ID: ${{ github.event.client_payload.ReleaseID }}
     steps:
-    - name: Check release for ${{ github.event.client_payload.ReleaseBranchName }}
+    - name: Check SBOM asset for release ${{ env.RELEASE_ID }}
       id: check
       shell: pwsh
       run: |
-        $apiUrl = "https://api.github.com/repos/actions/runner-images/releases/${{ github.event.client_payload.ReleaseID }}"
+        $apiUrl = "https://api.github.com/repos/actions/runner-images/releases/$env:RELEASE_ID"
         $response = Invoke-RestMethod -Uri $apiUrl -Method Get -SkipHttpErrorCheck
         if ($response.message -ilike "Not Found") {
           echo "status=release_not_found" >> $env:GITHUB_OUTPUT
-          Write-Error "Release ${{ github.event.client_payload.ReleaseID }} wasn't found"
+          Write-Error "Release $env:RELEASE_ID wasn't found"
           exit 1
         }
         foreach ($asset in $response.assets) {
           if ($asset.name -like '*sbom*') {
             echo "status=sbom_exists" >> $env:GITHUB_OUTPUT
-            return "Release ${{ github.event.client_payload.ReleaseID }} already contains a SBOM"
+            return "Release $env:RELEASE_ID already contains a SBOM"
           }
         }
         Write-Host "Release has been found, SBOM is not attached, starting generation."
         echo "status=okay" >> $env:GITHUB_OUTPUT
-  #Generating SBOM
+
   building-sbom:
     needs: sbom-check
     if: ${{ needs.sbom-check.outputs.check_status == 'okay' }}
     runs-on: ${{ github.event.client_payload.agentSpec }}
+    env:
+      AGENT_SPEC: ${{ github.event.client_payload.agentSpec }}
+      RELEASE_ID: ${{ github.event.client_payload.ReleaseID }}
+      IMAGE_VERSION: ${{ github.event.client_payload.imageVersion }}
     steps:
-      - name: Available image version check for ${{ github.event.client_payload.ReleaseBranchName }}
+      - name: Available image version check
         run: |
-          $imageVersionComponents = $env:ImageVersion.Split('.')
-          $imageMajorVersion = $imageVersionComponents[0]
-          $imageMinorVersion = $imageVersionComponents[1]
-          if ("$imageMajorVersion.$imageMinorVersion" -ne '${{ github.event.client_payload.imageVersion }}') {
-            throw "Current runner $imageMajorVersion.$imageMinorVersion image version doesn't match ${{ github.event.client_payload.imageVersion }}."
+          $expectedVersion = $env:IMAGE_VERSION
+          $runnerVersion = $env:ImageVersion
+
+          # Split versions by dot
+          $expectedParts = $expectedVersion.Split('.')
+          $runnerParts = $runnerVersion.Split('.')
+
+          # Determine what parts to compare
+          $minLength = [Math]::Min($expectedParts.Length, $runnerParts.Length)
+          $expectedComparable = $expectedParts[0..($minLength-1)] -join '.'
+          $runnerComparable = $runnerParts[0..($minLength-1)] -join '.'
+
+          # Perform the comparison
+          if ($expectedComparable -ne $runnerComparable) {
+            throw "Version mismatch: Expected version '$expectedVersion' doesn't match runner version '$runnerVersion'"
           }
+
       - name: Install SYFT tool on Windows
         if: ${{ runner.os == 'Windows' }}
-        run: curl -sSfL https://raw.githubusercontent.com/anchore/syft/main/install.sh | sh -s -- -b D:/syft
+        run: curl -sSfL https://raw.githubusercontent.com/anchore/syft/main/install.sh | sh -s -- -b C:/syft
+
       - name: Install SYFT tool on Ubuntu 
         if: ${{ runner.os == 'Linux' }}
         run: curl -sSfL https://raw.githubusercontent.com/anchore/syft/main/install.sh | sh -s -- -b /usr/local/bin
+
       - name: Install SYFT v1.24.0 on macOS
         if: ${{ runner.os == 'macOS' }}
         run: curl -sSfL https://raw.githubusercontent.com/anchore/syft/main/install.sh | sh -s -- -b /usr/local/bin v1.24.0
 
-      #Running section.
       - name: Run SYFT on Windows
         if: ${{ runner.os == 'Windows' }}
-        run: D:/syft/syft dir:C:/ -vv -o spdx-json=sbom.json
+        run: C:/syft/syft dir:C:/ -vv -o spdx-json=sbom.json
+
       - name: Run SYFT on Ubuntu
         if: ${{ runner.os == 'Linux' }}
         run: syft dir:/ -vv -o spdx-json=sbom.json
+
       - name: Run SYFT on macOS
         if: ${{ runner.os == 'macOS' }}
+        # Skip protected folders to avoid prompt privileges that block process indefinitely (https://github.com/anchore/syft/issues/1367)
         run: sudo syft dir:/ -vv -o spdx-json=sbom.json --exclude ./Users --exclude ./System/Volumes --exclude ./private
         shell: bash
-      #Preparing artifact (raw SBOM.json is too big)
+
       - name: Compress SBOM file
         run: Compress-Archive sbom.json sbom.json.zip
-      #Upload artifact action
+
       - uses: actions/upload-artifact@v4
         with:
-          name: sbom-${{ github.event.client_payload.agentSpec }}-${{ github.event.client_payload.imageVersion }}
+          name: sbom-${{ env.AGENT_SPEC }}-${{ env.IMAGE_VERSION }}
           path: sbom.json.zip
           if-no-files-found: warn
-      #Upload release asset action
-      #Might be changed to softprops/action-gh-release after additional check
+
       - name: Upload release asset
         uses: actions/upload-release-asset@v1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
-          upload_url: "https://uploads.github.com/repos/actions/runner-images/releases/${{ github.event.client_payload.ReleaseID }}/assets{?name,label}"
+          upload_url: "https://uploads.github.com/repos/actions/runner-images/releases/${{ env.RELEASE_ID }}/assets{?name,label}"
           asset_path: ./sbom.json.zip
-          asset_name: sbom.${{ github.event.client_payload.agentSpec }}.json.zip
+          asset_name: sbom.${{ env.AGENT_SPEC }}.json.zip
           asset_content_type: application/zip

.github/workflows/docker-images.yml

@@ -0,0 +1,31 @@
+name: Test Docker Images
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'images/ubuntu-slim/**'
+      - '.github/workflows/docker-images.yml'
+  pull_request:
+    paths:
+      - 'images/ubuntu-slim/**'
+      - '.github/workflows/docker-images.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test-images:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        directory:
+          - images/ubuntu-slim
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Run test.sh
+        working-directory: ${{ matrix.directory }}
+        run: ./test.sh

.github/workflows/linter.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 

.github/workflows/merge_pull_request.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         fetch-depth: 0
 
@@ -24,7 +24,7 @@ jobs:
         sleep 30
 
     - name: Approve pull request by GitHub-Actions bot
-      uses: actions/github-script@v7
+      uses: actions/github-script@v8
       with:
         github-token: ${{secrets.PRAPPROVAL_SECRET}}
         script: |
@@ -36,7 +36,7 @@ jobs:
           });
 
     - name: Merge pull request for ${{ github.event.client_payload.ReleaseBranchName }}
-      uses: actions/github-script@v7
+      uses: actions/github-script@v8
       with:
         github-token: ${{secrets.GITHUB_TOKEN}}
         script: |

.github/workflows/powershell-tests.yml

@@ -15,7 +15,7 @@ jobs:
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Run Software Report module tests
         shell: pwsh