Rozšířený příklad pro kontejnery

Ukázkový Dockerfile v Instalace buildovacích nástrojů do kontejneru vždy používá image microsoft/dotnet-framework:4.8 založenou na nejnovější imagi microsoft/windowsservercore a nejnovějším instalačním programu nástrojů Visual Studio Build Tools. Pokud tuto image publikujete do registru Dockeru, aby ji mohli stáhnout ostatní, může být tato image v pořádku pro mnoho scénářů. V praxi je ale běžnější být specifický ohledně toho, jaký základní obraz používáte, jaké binární soubory stahujete a které verze nástrojů instalujete.

Následující příklad souboru Dockerfile používá konkrétní značku verze image microsoft/dotnet-framework. Použití konkrétní značky pro základní image je běžné a usnadňuje zapamatovat si, že sestavení nebo opětovné sestavení imagí má vždy stejný základ.

Poznámka

Visual Studio nelze nainstalovat do microsoft/windowsservercore:10.0.14393.1593 nebo jakékoli image založené na ní, což má známé problémy se spuštěním instalačního programu v kontejneru. Další informace najdete v tématu Známé problémy s kontejnery.

Následující příklad stáhne nejnovější verzi buildových nástrojů. Pokud chcete použít starší verzi nástrojů sestavení, kterou můžete později nainstalovat do kontejneru, musíte nejprve vytvořit a udržovat rozložení.

Instalace skriptu

Pokud chcete shromáždit protokoly, když dojde k chybě instalace, vytvořte v pracovním adresáři dávkový skript s názvem "Install.cmd", který obsahuje následující obsah:

@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

Soubor Dockerfile

V pracovním adresáři vytvořte soubor Dockerfile s následujícím obsahem:

# 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"]

Spuštěním následujícího příkazu sestavte image v aktuálním pracovním adresáři:

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

Volitelně můžete předat argumenty FROM_IMAGE nebo CHANNEL_URL pomocí přepínače příkazového řádku --build-arg a zadat jiný základní obrázek nebo umístění interního rozložení pro zachování pevného obrázku.

Spropitné

Seznam úloh a komponent najdete v adresáři komponent nástroje Visual Studio Build Tools.

Diagnostika selhání instalace

Tento příklad stáhne konkrétní nástroje a ověří, že hashe odpovídají. Stáhne také nejnovější nástroj pro shromažďování protokolů sady Visual Studio a .NET, takže pokud dojde k selhání instalace, můžete protokoly zkopírovat do hostitelského počítače a analyzovat selhání.

> 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 dokončení posledního řádku otevřete na počítači "%TEMP%\vslogs.zip" nebo odešlete problém na webu komunity vývojářů.

Podpora nebo řešení potíží

Někdy se věci můžou pokazit. Pokud instalace sady Visual Studio selže, přečtěte si Řešení potíží s instalací a upgradem sady Visual Studio podrobné pokyny.

Tady je několik dalších možností podpory:

• V případě problémů souvisejících s instalací použijte podporu prostřednictvím instalačního chatu (pouze v angličtině).
• Nahlašte nám problémy s produktem pomocí nástroje Nahlásit problém, který se zobrazí v instalačním programu sady Visual Studio i v integrovaném vývojovém prostředí sady Visual Studio. Pokud jste administrátor IT a nemáte Visual Studio nainstalováno, můžete odeslat zpětnou vazbu administrátora IT.
• Navrhněte funkci, sledujte problémy s produktem a najděte odpovědi v vývojářské komunitě sady Visual Studio.

Související obsah

• instalace buildových nástrojů do kontejneru
• Řešení potíží s kontejnery nástrojů Windows a nástrojů sestavování
• Identifikace úloh a komponent nástroje Visual Studio Build Tools