windows-server-2022-cuda
is a Windows Server 2022 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.
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@5.1.0
jobs:
build:
executor: win/server-2022-cuda
steps:
- run: Write-Host 'Hello, Windows Server 2022'
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-2022-cuda:current'
resource_class: windows.gpu.nvidia.medium
shell: powershell.exe -ExecutionPolicy Bypass
steps:
- run: Write-Host 'Hello, Windows Server 2022'
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
, respectively.
This image is based on Windows Server 2022 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 its 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:
Windows Server 2022 Datacenter Edition includes:
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 quarterly.
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.