Skip to content

Commit 7e92444

Browse files
Add base image configuration info to windows/README.md
1 parent dc22daa commit 7e92444

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

windows/README.md

+7-4
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
# Windows build environment for rust crates
22

33
This repository contains the source of a Docker container the Rust project uses
4-
to build third-party crates on Windows. It is based on **Windows Server Core,
5-
version 1803**, and contains all the native dependencies used by the Rust
6-
crates we know of.
4+
to build third-party crates on Windows. It is based on **Windows Server Core**,
5+
and contains all the native dependencies used by the Rust crates we know of.
76

87
## Dependencies
98

@@ -16,6 +15,10 @@ This image must be run on a Windows host with both containerization and Hyper-V
1615
enabled (Windows 10 Pro or Windows Server >=2016). If you wish to run `crater`
1716
on an Azure VM, this requires a virtual machine image tagged with "v3".
1817

18+
The version of the base image can be configured by passing `--build-arg
19+
BASE_IMAGE_VER=${YOUR_DESIRED_VERSION_NUMBER}` to `docker build`. It defaults
20+
to `:1803` (note the leading colon) which specifies Windows Server Core,
21+
version 1803.
1922

2023
Hyper-V can be enabled in [the GUI][hyperv] or in `Powershell` with:
2124

@@ -29,7 +32,7 @@ A reboot is required for this to take effect.
2932

3033

3134
The Docker host must have a [build number][build] equal to that of the image
32-
you wish to run (presently `mcr.microsoft.com/windows/servercore:1803`).
35+
you wish to run (by default `mcr.microsoft.com/windows/servercore:1803`).
3336

3437
[Docker Desktop][] is required to run native Windows containers; this image
3538
will not work with Docker Toolbox. Once installed, ensure that Docker Desktop

0 commit comments

Comments
 (0)