Zaawansowany przykład dla kontenerów

Przykładowy plik Dockerfile w temacie Instalowanie narzędzi kompilacji w kontenerze zawsze używa obrazu microsoft/dotnet-framework:4.8 na podstawie najnowszego obrazu microsoft/windowsservercore i najnowszego instalatora narzędzi Visual Studio Build Tools. Jeśli opublikujesz ten obraz w rejestrze platformy Docker, aby inne osoby mogły ściągnąć, 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ę.

Uwaga

Nie można zainstalować programu Visual Studio w pliku microsoft/windowsservercore:10.0.14393.1593 lub na jego podstawie żadnego obrazu, który ma 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żna zainstalować w kontenerze później, musisz najpierw utworzyć i zachować układ.

Instalowanie skryptu

Aby zbierać dzienniki po wystąpieniu 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

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ż oba argumenty lub FROM_IMAGECHANNEL_URL albo za pomocą --build-arg przełącznika wiersza polecenia, 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 narzędzi Visual Studio Build Tools.

Diagnozowanie błędów instalacji

W tym przykładzie są pobierane określone narzędzia i sprawdza, czy skróty są zgodne. Pobiera również najnowsze narzędzie zbierania dzienników programu Visual Studio i platformy .NET, aby w przypadku wystąpienia błędu instalacji można skopiować dzienniki na maszynę hosta, aby 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 plik "%TEMP%\vslogs.zip" na swojej maszynie lub prześlij problem w witrynie 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:

• Oferujemy opcję obsługi czatu instalacyjnego (tylko w języku angielskim) w przypadku problemów związanych z instalacją.
• Zgłoś problemy z produktami za pośrednictwem narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalator programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś Administracja istratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać tutaj opinię Administracja IT.
• Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w społeczności deweloperów programu Visual Studio.

Powiązana zawartość

• Instalowanie narzędzi do kompilacji w kontenerze
• Rozwiązywanie problemów z kontenerami windows i narzędzi kompilacji
• Identyfikatory obciążeń i składników narzędzi Visual Studio Build Tools