Merge with master. Use error instead of raw promise rejection

Author: Sam Eagen

integ-test-promote-template.yml

@@ -72,17 +72,13 @@ jobs:
           microsoft_hosted_windows:
             poolName: Azure Pipelines
             vmImage: windows-latest
-          self_hosted_windows:
-            poolName: vmssagentpool
-            vmImage: # blank for self-hosted
       pool:
         name: $(poolName)
         vmImage: $(vmImage)
       steps:
         - checkout: none
         - task: MathWorks.matlab-azure-devops-extension-dev.InstallMATLAB.InstallMATLAB@${{ version }}
           displayName: Install MATLAB on Microsoft-hosted agents
-          condition: not(startsWith(variables['Agent.Name'], 'vmss'))
         - task: MathWorks.matlab-azure-devops-extension-dev.RunMATLABCommand.RunMATLABCommand@${{ version }}
           displayName: Run MATLAB statement
           inputs:
@@ -146,9 +142,6 @@ jobs:
           microsoft_hosted_linux:
             poolName: Azure Pipelines
             vmImage: ubuntu-22.04
-          self_hosted_windows:
-            poolName: vmssagentpool
-            vmImage: # blank for self-hosted
       pool:
         name: $(poolName)
         vmImage: $(vmImage)
@@ -158,12 +151,12 @@ jobs:
         - checkout: none
         - task: MathWorks.matlab-azure-devops-extension-dev.InstallMATLAB.InstallMATLAB@${{ version }}
           displayName: Install MATLAB on Microsoft-hosted agents
-          condition: and(eq(${{ version }}, '0'), not(startsWith(variables['Agent.Name'], 'vmss')))
+          condition: eq(${{ version }}, '0')
         - task: MathWorks.matlab-azure-devops-extension-dev.InstallMATLAB.InstallMATLAB@${{ version }}
           inputs:
             products: Simulink Simulink_Test Simulink_Coverage Parallel_Computing_Toolbox
           displayName: Install MATLAB on Microsoft-hosted agents
-          condition: and(eq(${{ version }}, '1'), not(startsWith(variables['Agent.Name'], 'vmss')))
+          condition: eq(${{ version }}, '1')
         - bash: |
             echo 'myvar = 123' > startup.m
             mkdir src
@@ -239,18 +232,19 @@ jobs:
             grep -q "runner.addPlugin(FailOnWarningsPlugin())" console.log
             rm console.log
           displayName: Verify tests ran with strict checks
-        - task: MathWorks.matlab-azure-devops-extension-dev.RunMATLABTests.RunMATLABTests@${{ version }}
-          displayName: Run MATLAB tests in parallel
-          inputs:
-            useParallel: true
-            sourceFolder: src
-          condition: not(eq(${{ version }}, '0'))
-        - bash: |
-            set -e
-            grep -q "Starting parallel pool (parpool)" console.log
-            rm console.log
-          displayName: Verify tests ran in parallel
-          condition: not(eq(${{ version }}, '0'))
+        # Disable parallel tests until PCT bug is fixed g3416906
+        # - task: MathWorks.matlab-azure-devops-extension-dev.RunMATLABTests.RunMATLABTests@${{ version }}
+        #   displayName: Run MATLAB tests in parallel
+        #   inputs:
+        #     useParallel: true
+        #     sourceFolder: src
+        #   condition: not(eq(${{ version }}, '0'))
+        # - bash: |
+        #     set -e
+        #     grep -q "Starting parallel pool (parpool)" console.log
+        #     rm console.log
+        #   displayName: Verify tests ran in parallel
+        #   condition: not(eq(${{ version }}, '0'))
         - task: MathWorks.matlab-azure-devops-extension-dev.RunMATLABTests.RunMATLABTests@${{ version }}
           displayName: Run MATLAB tests with detailed display level for event details
           inputs:

overview.md

@@ -125,8 +125,25 @@ steps:
     MLM_LICENSE_TOKEN: $(myToken)
 ```
 
+### Use Virtual Display on Linux Agent
+Microsoft-hosted Linux® agents do not provide a display. To run MATLAB code that requires a display, such as tests that interact with an app UI, first set up a virtual display on the agent by starting an Xvfb display server. For example, set up a virtual server to run the tests for an app created in MATLAB.
+
+```YAML
+pool:
+  vmImage: ubuntu-latest
+steps:
+  - script: |
+      sudo apt-get install -y xvfb
+      Xvfb :99 &
+      echo "##vso[task.setVariable variable=DISPLAY]:99"
+    displayName: Start virtual display server
+    condition: eq(variables['Agent.OS'],'Linux') 
+  - task: InstallMATLAB@1
+  - task: RunMATLABTests@1
+```
+
 ### Build Across Multiple Platforms
-The **Install MATLAB** task supports the Linux®, Windows®, and macOS platforms. Use a `matrix` job strategy to run a build using the MATLAB build tool on all the supported platforms. This pipeline runs three jobs.
+The **Install MATLAB** task supports the Linux, Windows®, and macOS platforms. Use a `matrix` job strategy to run a build using the MATLAB build tool on all the supported platforms. This pipeline runs three jobs.
 
 ```YAML
 strategy:
@@ -159,7 +176,7 @@ Specify the **Install MATLAB** task in your YAML pipeline as `InstallMATLAB@1`.
 Input       | Description 
 ------------| ------------
 `release`   | <p>(Optional) MATLAB release to install. You can specify R2021a or a later release. By default, the value of `release` is `latest`, which corresponds to the latest release of MATLAB.</p><p><ul><li>To install the latest update of a release, specify only the release name, for example, `R2023b`.</li><li>To install a specific update release, specify the release name with an update number suffix, for example, `R2023bU4`.</li><li>To install a release without updates, specify the release name with an update 0 or general release suffix, for example, `R2023bU0` or `R2023bGR`.</li></ul></p><p>**Example**: `release: R2023b`<br/>**Example**: `release: latest`<br/>**Example**: `release: R2023bU4`</p>
-`products`  | <p>(Optional) Products to install in addition to MATLAB, specified as a list of product names separated by spaces. You can specify `products` to set up most MathWorks products and support packages. The action uses [MATLAB Package Manager](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md) (`mpm`) to set up products.</p><p>For a list of supported products, open the input file for your preferred release from the [`mpm-input-files`](https://github.com/mathworks-ref-arch/matlab-dockerfile/tree/main/mpm-input-files) folder on GitHub&reg;. Specify products using the format shown in the input file, excluding the `#product.` prefix. For example, to set up Deep Learning Toolbox&trade; in addition to MATLAB, specify `products: Deep_Learning_Toolbox`.</p><p>For an example of how to use the `products` input, see [Run Tests in Parallel](#run-tests-in-parallel).</p><p>**Example**: `products: Simulink`<br/>**Example:** `products: Simulink Deep_Learning_Toolbox`</p>
+`products`  | <p>(Optional) Products to install in addition to MATLAB, specified as a list of product names separated by spaces. You can specify `products` to install most MathWorks products and support packages. The task uses [MATLAB Package Manager](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md) (`mpm`) to install products.</p><p>For a list of supported products, open the input file for your preferred release from the [`mpm-input-files`](https://github.com/mathworks-ref-arch/matlab-dockerfile/tree/main/mpm-input-files) folder on GitHub&reg;. Specify products using the format shown in the input file, excluding the `#product.` prefix. For example, to install Deep Learning Toolbox&trade; in addition to MATLAB, specify `products: Deep_Learning_Toolbox`.</p><p>For an example of how to use the `products` input, see [Run Tests in Parallel](#run-tests-in-parallel).</p><p>**Example**: `products: Simulink`<br/>**Example:** `products: Simulink Deep_Learning_Toolbox`</p>
 
 #### Licensing
 Product licensing for your pipeline depends on your project visibility as well as the type of products to install: