updated documentation

master
JoYo 2023-03-27 14:31:49 -04:00
parent 5ab3d021bc
commit a9b377c5ac
1 changed files with 18 additions and 10 deletions

View File

@ -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.