Zaawansowany przykład dla kontenerów

Przykładowy plik Dockerfile w Install Build Tools into a container zawsze używa obrazu microsoft/dotnet-framework:4.8 opartego na najnowszym obrazie microsoft/windowsservercore i najnowszym instalatorze narzędzi Visual Studio Build Tools. Jeśli opublikujesz ten obraz w rejestrze Docker , aby inni mogli go pobrać, ten obraz może być w porządku w wielu scenariuszach. Jednak w praktyce bardziej typowe jest określenie, jakiego obrazu podstawowego używasz, jakie pliki binarne pobierasz i które wersje narzędzi są instalowane.

W poniższym przykładzie plik Dockerfile używa określonego tagu wersji obrazu microsoft/dotnet-framework. Używanie określonego tagu dla obrazu podstawowego jest powszechne i ułatwia zapamiętanie, że tworzenie lub ponowne kompilowanie obrazów zawsze ma taką samą podstawę.

Notatka

Nie można zainstalować programu Visual Studio w obrazie microsoft/windowsservercore:10.0.14393.1593 ani w żadnym obrazie opartym na nim, ponieważ istnieją znane problemy z uruchamianiem instalatora w kontenerze. Aby uzyskać więcej informacji, zobacz Znane problemy dotyczące kontenerów.

Poniższy przykład pobiera najnowszą wersję narzędzi Build Tools. Jeśli chcesz użyć starszej wersji narzędzi kompilacji, którą możesz zainstalować w kontenerze później, musisz najpierw utworzyć i zachować układu.

Instalowanie skryptu

Aby zbierać dzienniki w przypadku wystąpienia błędu instalacji, utwórz skrypt wsadowy o nazwie "Install.cmd" w katalogu roboczym zawierającym następującą zawartość:

@if not defined _echo echo off
setlocal enabledelayedexpansion

call %*
if "%ERRORLEVEL%"=="3010" (
    exit /b 0
) else (
    if not "%ERRORLEVEL%"=="0" (
        set ERR=%ERRORLEVEL%
        call C:\TEMP\collect.exe -zip:C:\vslogs.zip

        exit /b !ERR!
    )
)

exit /b 0

Plik Dockerfile

W katalogu roboczym utwórz plik "Dockerfile" z następującą zawartością:

# escape=`

# Use the latest Windows Server Core 2019 image.
ARG FROM_IMAGE=mcr.microsoft.com/windows/servercore:ltsc2019
FROM ${FROM_IMAGE}

# Restore the default Windows shell for correct batch processing.
SHELL ["cmd", "/S", "/C"]

# Copy our Install script.
COPY Install.cmd C:\TEMP\

# Download collect.exe in case of an install failure.
ADD https://aka.ms/vscollect.exe C:\TEMP\collect.exe

# Use the latest release channel. For more control, specify the location of an internal layout.
ARG CHANNEL_URL=https://aka.ms/vs/17/release/channel
ADD ${CHANNEL_URL} C:\TEMP\VisualStudio.chman

RUN `
    # Download the Build Tools bootstrapper.
    curl -SL --output vs_buildtools.exe https://aka.ms/vs/17/release/vs_buildtools.exe `
    `
    # Install Build Tools with the Microsoft.VisualStudio.Workload.AzureBuildTools workload, excluding workloads and components with known issues.
    && (call C:\TEMP\Install.cmd vs_buildtools.exe --quiet --wait --norestart --nocache install `
        --installPath "%ProgramFiles(x86)%\Microsoft Visual Studio\2022\BuildTools" `
        --channelUri C:\TEMP\VisualStudio.chman `
        --installChannelUri C:\TEMP\VisualStudio.chman `
        --add Microsoft.VisualStudio.Workload.AzureBuildTools `
        --remove Microsoft.VisualStudio.Component.Windows10SDK.10240 `
        --remove Microsoft.VisualStudio.Component.Windows10SDK.10586 `
        --remove Microsoft.VisualStudio.Component.Windows10SDK.14393 `
        --remove Microsoft.VisualStudio.Component.Windows81SDK) `
    `
    # Cleanup
    && del /q vs_buildtools.exe

# Define the entry point for the Docker container.
# This entry point starts the developer command prompt and launches the PowerShell shell.
ENTRYPOINT ["C:\\Program Files (x86)\\Microsoft Visual Studio\\2022\\BuildTools\\Common7\\Tools\\VsDevCmd.bat", "&&", "powershell.exe", "-NoLogo", "-ExecutionPolicy", "Bypass"]

Uruchom następujące polecenie, aby skompilować obraz w bieżącym katalogu roboczym:

docker build -t buildtools2022:17.0 -t buildtools2022:latest -m 2GB .

Opcjonalnie przekaż argumenty FROM_IMAGE lub CHANNEL_URL przy użyciu przełącznika wiersza polecenia --build-arg, aby określić inny obraz podstawowy lub lokalizację układu wewnętrznego w celu zachowania stałego obrazu.

Napiwek

Aby uzyskać listę obciążeń i składników, zobacz katalog składników Visual Studio Build Tools.

Diagnozowanie błędów instalacji

W tym przykładzie pobierane są określone narzędzia, a następnie sprawdzane jest, czy hasze są zgodne. Pobiera również najnowsze narzędzie do zbierania dzienników dla programu Visual Studio i platformy .NET, dzięki czemu w przypadku niepowodzenia instalacji można skopiować dzienniki na maszynę hosta i przeanalizować błąd.

> docker build -t buildtools2022:17.0 -t buildtools2022:latest -m 2GB .
Sending build context to Docker daemon

...
Step 8/10 : RUN C:\TEMP\Install.cmd C:\TEMP\vs_buildtools.exe --quiet --wait --norestart --nocache ...
 ---> Running in 4b62b4ce3a3c
The command 'cmd /S /C C:\TEMP\Install.cmd C:\TEMP\vs_buildtools.exe ...' returned a non-zero code: 1603

> docker cp 4b62b4ce3a3c:C:\vslogs.zip "%TEMP%\vslogs.zip"

Po zakończeniu wykonywania ostatniego wiersza, otwórz "%TEMP%\vslogs.zip" na swoim komputerze lub zgłoś problem na stronie internetowej społeczności deweloperów .

Pomoc techniczna lub rozwiązywanie problemów

Czasami coś może pójść źle. Jeśli instalacja programu Visual Studio nie powiedzie się, zobacz Rozwiązywanie problemów z instalacją i uaktualnianiem programu Visual Studio, aby uzyskać szczegółowe wskazówki.

Oto kilka dodatkowych opcji pomocy technicznej:

• Użyj opcji obsługi czatu instalacji (tylko w języku angielskim) w przypadku problemów związanych z instalacją.
• Zgłoś problemy z produktem za pomocą narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalatorze programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś administratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać opinii administratora IT.
• Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w witrynie Visual Studio Developer Community.

Powiązana zawartość

• Instalowanie narzędzi kompilacji w kontenerze
• Rozwiązywanie problemów z kontenerami narzędzi Windows i Build Tools
• Identyfikatory zestawów i składników narzędzi programu Visual Studio Build Tools