diff --git a/README.mdown b/README.mdown index 0f9cd3f..bb82f44 100644 --- a/README.mdown +++ b/README.mdown @@ -6,7 +6,7 @@ Powershell scripts are included to try and recreate these build environments dir # Requirements -A Windows 10.0.19041.804+ workstation or VM with minimum 8 GB of memory is required. +A Windows 11 10.0.22621.1413+ workstation or VM with minimum 8 GB of memory is required. The more concurrent containers you have running, the more memory and CPU cores are required. **Each container requires one core and approximately 4 GB of memory.** @@ -33,11 +33,11 @@ This will install both the Windows v142 and Windows XP v141_xp build chains into Reference these containers later with the names: -- win_build +- win_build:ltsc2022 -- rust_build +- rust_build:ltsc2022 -- winxp_build +- winxp_build:ltsc2022 # Run Containers @@ -51,7 +51,7 @@ version: '3' services: win_build: - image: win_build + image: win_build:ltsc2022 volumes: - .:C:/source/ ``` @@ -60,7 +60,7 @@ services: - `C:/source/` is assumed to be the project being build with MSVC. -To build a Windows XP project use the `image: winxp_build` container image. +To build a Windows XP project use the `image: winxp_build:ltsc2022` container image. # Build Your Windows Project @@ -80,7 +80,7 @@ version: '3' services: win_build: - image: win_build + image: win_build:ltsc2022 volumes: - .:C:/source/ entrypoint: powershell -Command Import-Module C:\\msvc\\Common7\\Tools\\Microsoft.VisualStudio.DevShell.dll; Enter-VsDevShell -VsInstallPath C:\\msvc\\ -DevCmdArguments -arch=amd64 @@ -97,7 +97,7 @@ They can be ran but should be evaluated as there is no error checking. # Troubleshooting -## error C2471: cannot update program database +## `error C2471: cannot update program database` MSBuild has trouble writing files to a mounted directory which occurs even if the out path is set in the project. It is recommended that you include a script in your project that copies the `C:\source` directory into the container prior to running the build commands. @@ -109,7 +109,7 @@ Copy-Item C:\build\bin -Destination C:\source\ -Recurse -Force Remove-Item -Recurse C:\build\ ``` -# docker-compose build not implimented +## `docker-compose build not implimented` https://docs.docker.com/compose/cli-command/#compose-v2-and-the-new-docker-compose-command @@ -120,9 +120,17 @@ Use the following command to disable. docker-compose disable-v2 ``` -# service immediately exits on `docker-compose up` +## service immediately exits on `docker-compose up` Reminder to run the container instead: ``` docker-compose run win_build ``` + +## `a Windows version 10.0.XXXXX-based image is incompatible with a 10.0.XXXXX host` + +Microsoft paid a lot of money to check each container version. +Two solutions: + +0. Update your workstation to Windows 11 10.0.22621.1413+ +0. Replace the string `ltsc2022` with `ltsc2019` across the entire project and rebuild. \ No newline at end of file