windows-server-2019-cuda

windows-server-2019-cuda is a Windows Server 2019 machine executor image meant to be used with an nVidia GPU-enabled instance.

See the docs page for information on getting started using Windows on CircleCI.

Getting Started

To use the Windows executor and the available Windows images, it is easiest to utilize the Windows orb:

1
2
3
4
5
6
7
8
9
10
11
12
version: 2.1
orbs:
  win: circleci/windows@4.1
jobs:
  build:
    executor: win/server-2019-cuda
    steps:
      - run: Write-Host 'Hello, Windows'
workflows:
  my-workflow:
    jobs:
      - build

The above example uses the Windows orb Windows orb to easily access the Windows machine executor and image in a standardized way.

To use the image directly in the machine executor, you can use:

1
2
3
4
5
6
7
8
9
version: 2.1
jobs:
  build:
    machine:
      image: 'windows-server-2019-cuda:current'
      resource_class: windows.gpu.nvidia.medium
      shell: powershell.exe -ExecutionPolicy Bypass
    steps:
      - run: Write-Host 'Hello, Windows'

Three shells are provided and can be specified within your command. The above uses powershell.exe, but you can run bash and cmd commands with bash.exe or cmd.exe, respectfully.

How This Image Works

This image is based on Windows Server 2019 and contains various Linux and Windows utilities designed specifically for nVidia/CUDA development and everything needed to run most builds on CircleCI. Images are typically updated and released every month alongside the standard Windows flavor.

However, please note that there are some packages that may be omitted in this image due to it's specialized nature as well as differing versions.

Please visit our Discuss forums with any questions, search for common problems, or feature requests.

The past four updates in ascending order:

• February
• January
• November '21
• October '21

What's in the Box?

Windows Server 2019 Core Datacenter Edition

• Visual Studio 2019 Community Edition
  • Additional licensing terms may apply to your organisation when using this version of Visual Studio on CircleCI. Please review the Visual Studio 2019 Community Edition licensing terms before using this Visual Studio version in your Windows jobs.
  • Azure SDK for Visual Studio 2019
  • Visual Studio 2019 Build Tools
• 7zip 21.07
• AWS
  • AWS CLI
  • Python
  • Botocore
• Azure CLI
• Azure Service Fabric
  • SDK
  • Runtime
• Chocolatey
• CUDA
• Git
• Git LFS
• Go
• Gzip
• Java
• jq
• Miniconda
• Node.js
• NuGet CLI
• Nunit
• NVM (Node Version Manager)
• OpenJDK
• PsExec64
• Python
• Ruby
• .NET Framework 5
• .NET
  • SDK
  • .NET Core SDK
• Shells:
  • Powershell
  • GNU bash
  • cmd
• Text editors
  • nano
  • vim
• WinAppDriver
• Windows 10 SDK

Tagging Scheme

current - This image tag points to the latest, production ready Windows image. This image should be used by projects that want a decent level of stability but would like to get occasional software updates. It is typically updated once a month.

edge - This image tag points to the latest version of the Windows image and is built from the HEAD of the main branch. This tag is intended to be used as a testing version of the image with the most recent changes and not guaranteed to be stable