Adds automated build, test, and publish workflows for the Windows Dockerfile for MATLAB

Author: michaelmcdonnellmw

.github/workflows/README-windows-container.md

@@ -0,0 +1,28 @@
+# Build and Test the windows/Dockerfile
+
+> This folder is intended only for the administrators of the matlab-dockerfile repository.
+
+The workflow in this folder builds and tests the Dockerfile found in `windows`.
+
+## Triggers and Scheduled Jobs
+
+The workflow is scheduled to run every Monday at 00:00.
+
+Additionally, the workflow is triggered each time you push a change in the [`Dockerfile`](../../windows/Dockerfile) or in the [`tests` directory](../../windows/tests) to the repository.
+
+You can also trigger the workflow from the "Actions" tab.
+
+## Workflow Description
+
+This workflow consists of the following steps:
+
+1. Check-out the repository into a GitHub Actions runner.
+1. Run the `Build` target of the [`Makefile.ps1`](../../windows/Makefile.ps1) script to build the [`Dockerfile`].
+1. Run the `Test` target of the [`Makefile.ps1`](../../windows/Makefile.ps1) script to test the image built by the previous step.
+1. Log into the GitHub Container Registry (GHCR) using the GitHub Actions runner's credentials.
+1. Use the `TagImage` target of the  [`Makefile.ps1`](../../windows/Makefile.ps1) script to tag the Docker image with all relevant tags and then use the `Publish` target to push them to the registry.
+---
+
+Copyright 2025 The MathWorks, Inc. All rights reserved.
+
+---

.github/workflows/windows-container-build-test-publish.yml

@@ -0,0 +1,67 @@
+# Copyright 2025 The MathWorks, Inc.
+
+name: Build, Test and Publish the Windows Dockerfile
+
+# Trigger this workflow either manually or when a new change is pushed to the
+# repo (except .md files)
+on:
+  workflow_dispatch:
+  push:
+    # Trigger the workflow is the Dockerfile or any file under tests/ is modified
+    paths:
+      - "windows/*"
+      - "windows/tests/*"
+      - ".github/workflows/windows-container-build-test-publish.yml"
+      - "!**.md"
+  schedule:
+    # Run at 00:00 on every Monday (1st Day of the Week)
+    - cron: "0 0 * * 1"
+
+env:
+  IMAGE_BASE_NAME: ghcr.io/${{ github.repository }}/matlab-windows
+  ALT_PATH: windows
+
+jobs:
+  windows-container-build-test-push-image:
+    runs-on: windows-2022
+    strategy:
+      fail-fast: false
+      matrix:
+        matlab-release:
+          - R2025a
+          - R2024b
+          - R2024a
+          - R2023b
+          - R2023a
+          - R2022b
+          - R2022a
+          - R2021b
+          - R2021a
+
+    defaults:
+      run:
+        working-directory: ./${{ env.ALT_PATH }}
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Build the Docker image
+        run: |
+          ./Makefile.ps1 Build -ImageName "${{ env.IMAGE_BASE_NAME }}" -Release "${{ matrix.matlab-release }}" -ProductList "MATLAB"
+
+      - name: Test container
+        run: |
+          ./Makefile.ps1 Test -ImageName ${{ env.IMAGE_BASE_NAME }} -Release ${{ matrix.matlab-release }} -Token ${{ secrets.MATLAB_BATCH_TOKEN_EXPIRES_03_2026 }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Push the image to ghcr.io
+        run: |
+          ./Makefile.ps1 TagImage -ImageName ${{ env.IMAGE_BASE_NAME }} -Release ${{ matrix.matlab-release }}
+          ./Makefile.ps1 Publish -ImageName ${{ env.IMAGE_BASE_NAME }} -Release ${{ matrix.matlab-release }}

windows/Makefile.ps1

@@ -2,39 +2,63 @@
 # This script allows you to run build and test targets of a GitHub actions pipeline in an identical manner on your local machine.
 # This ensures that the build and test actions are easily reproducible outside of a CI/CD pipeline.
 param(
-    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [Parameter(Mandatory=$False, Position=0, ValueFromRemainingArguments=$false)]
+    [System.String]
+    $Target = "BuildAndTest",
+
+    [Parameter(Mandatory=$False, ValueFromPipeline=$false)]
+    [System.String]
+    $ImageName = "matlab-on-windows",
+
+    [Parameter(Mandatory=$False, ValueFromPipeline=$false)]
     [System.String]
     $Release = "R2025a",
 
-    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [Parameter(Mandatory=$False, ValueFromPipeline=$false)]
     [System.String]
     $ProductList = "MATLAB Text_Analytics_Toolbox Simulink_Coder Embedded_Coder MATLAB_Support_for_MinGW-w64_C/C++/Fortran_Compiler Requirements_Toolbox",
 
-    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
+    [Parameter(Mandatory=$False, ValueFromPipeline=$false)]
     [System.String]
-    $Token = "",
-    
-    [Parameter(Mandatory=$False, Position=1, ValueFromPipeline=$false)]
-    [System.String]
-    $Target = "BuildAndTest"
+    $Token = ""
 )
 
-$script:ImageName="mathworks/matlab-on-windows"
-$script:Version="0.5.1"
+$script:Version="0.6.0"
+
+function defaultTag {
+    return (Get-Culture).TextInfo.ToTitleCase(${Release})
+}
+
+function additionalTags {
+    return @(${Release}.ToLower())
+}
 
 function Build {
-        $Tag = ${Release}.ToLower() + "_" + ${Version}
-        & docker build --build-arg MATLAB_RELEASE=${Release} --build-arg MATLAB_PRODUCT_LIST="${ProductList}" -t "${ImageName}:${Tag}" .
+    $Tag = defaultTag
+    & docker build --isolation=hyperv --build-arg MATLAB_RELEASE=${Release} --build-arg MATLAB_PRODUCT_LIST="${ProductList}" -t "${ImageName}:${Tag}" .
 }
 
 function Test {
-        if (${Token} -eq "") {
-            Write-Error "Token argument must be supplied to test command"
-            throw "input error"
-        }
-        $Tag = ${Release}.ToLower() + "_" + ${Version}
+    if (${Token} -eq "") {
+        Write-Error "Token argument must be supplied to test command"
+        throw "input error"
+    }
+    $Tag = defaultTag
 	$container = New-PesterContainer -Path .\test\Test-MATLABWindowsContainer.tests.ps1 -Data @{ Release = ${Release}; ImageName = "${ImageName}:${Tag}"; Token = ${Token} }
-        & Invoke-Pester -Container $container -Output Detailed
+    & Invoke-Pester -Container $container -Output Detailed
+}
+
+function TagImage {
+    $DefaultTag = defaultTag
+    $AdditionalTags = additionalTags
+
+    foreach ($Tag in $AdditionalTags) {
+        & docker tag "${ImageName}:${DefaultTag}" "${ImageName}:${Tag}"
+    }
+}
+
+function Publish {
+    docker push --all-tags ${ImageName}
 }
 
 function BuildAndTest {
@@ -46,5 +70,7 @@ switch (${Target}) {
     'Build' { Build }
     'Test' { Test }
     'BuildAndTest' { BuildAndTest }
+    'TagImage' { TagImage }
+    'Publish' {Publish}
     default { BuildAndTest }
 }

windows/test/Test-MATLABWindowsContainer.tests.ps1

@@ -1,5 +1,6 @@
 # Copyright 2025 The MathWorks, Inc.
 # Requires v5.0 of pester 
+
 param (
     [Parameter(Mandatory)]
     [string] $ImageName,
@@ -13,25 +14,25 @@ param (
 
 Describe "MATLAB Docker Container Tests" {
     It "Runs rand() and returns expected output" {
-        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'rand()'"
+        $result = docker run --isolation=hyperv -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'rand()'"
         $LASTEXITCODE | Should -Be 0
         $result -join "`n" | Should -Match "0.8147"
     }
 
     It "Runs ver and includes release string" {
-        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'ver'"
+        $result = docker run --isolation=hyperv -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'ver'"
         $LASTEXITCODE | Should -Be 0
         $result -join "`n" | Should -Match $Release
     }
 
     It "Runs peaks and returns expected expression" {
-        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'peaks'"
+        $result = docker run --isolation=hyperv -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" "'peaks'"
         $LASTEXITCODE | Should -Be 0
         $result -join "`n" | Should -Match "z =  3\*\(1-x\)\.\^2\.\*exp\(-\(x\.\^2\) - \(y\+1\)\.\^2\)"
     }
 
     It "Creates a plot and confirms file existence" {
-        $result = docker run -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" '\"figure; annotation(''ellipse'',  [.2 .2 .2 .2]); saveas(gcf, ''plot.png''); isfile(''plot.png'')\"'
+        $result = docker run --isolation=hyperv -e "MLM_LICENSE_TOKEN=$Token" --rm "$ImageName" "matlab-batch.exe" '"figure; annotation(''ellipse'',  [.2 .2 .2 .2]); saveas(gcf, ''plot.png''); isfile(''plot.png'')"'
         $LASTEXITCODE | Should -Be 0
         $result -join "`n" | Should -BeLike "*ans =*logical*1*"
     }