Exemplo avançado para contentores

O Dockerfile de exemplo em Install Build Tools into a container sempre usa a imagem microsoft/dotnet-framework:4.8 com base na imagem mais recente do microsoft/windowsservercore e no instalador mais recente do Visual Studio Build Tools. Se publicares esta imagem num registo Docker para que outras pessoas a possam puxar, esta imagem pode ser aceitável para muitos cenários. No entanto, na prática, é mais comum ser específico sobre qual imagem base você usa, quais binários você baixa e quais versões de ferramenta você instala.

O exemplo a seguir de Dockerfile usa uma tag de versão específica da imagem "microsoft/dotnet-framework". Usar uma tag específica para uma imagem base é comum e facilita lembrar que a criação ou reconstrução de imagens sempre tem a mesma base.

O exemplo a seguir baixa a versão mais recente do Build Tools. Se tu quiseres usar uma versão anterior das Ferramentas de Compilação que possas instalar num contentor mais tarde, tens de primeiro criar e manter um layout.

Instalar script

Para coletar logs quando ocorrer um erro de instalação, crie um script em lote chamado "Install.cmd" no diretório de trabalho que inclua o seguinte conteúdo:

@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

No diretório de trabalho, crie o "Dockerfile" com o seguinte conteúdo:

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

Execute o seguinte comando para criar a imagem no diretório de trabalho atual:

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

Opcionalmente, passe um ou ambos os argumentos FROM_IMAGE ou CHANNEL_URL usando a opção de linha de comando --build-arg para especificar uma imagem base diferente ou o local de um layout interno para manter uma imagem fixa.

Diagnosticar falhas de instalação

Este exemplo baixa ferramentas específicas e valida se os hashes correspondem. Ele também baixa o utilitário de coleta de logs mais recente do Visual Studio e do .NET para que, se ocorrer uma falha de instalação, você possa copiar os logs para sua máquina host para analisar a falha.

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

Depois de a última linha ser executada, abra "%TEMP%\vslogs.zip" no seu computador ou submeta um problema no site da Developer Community.

Suporte ou solução de problemas

Por vezes, as coisas podem correr mal. Se a instalação do Visual Studio falhar, consulte Solucionar problemas de instalação e atualização do Visual Studio para obter orientação passo a passo.

Aqui estão mais algumas opções de suporte:

• Use a opção de suporte do chat de instalação (somente em inglês) para problemas relacionados à instalação.
• Comunique-nos problemas de produto usando a ferramenta Report a Problem que aparece no Visual Studio Installer e no IDE do Visual Studio. Se você for um administrador de TI e não tiver o Visual Studio instalado, poderá enviar comentários do administrador de TI.
• Sugira um recurso, acompanhe problemas do produto e encontre respostas no da Comunidade de Desenvolvedores do Visual Studio .

Conteúdo relacionado

• Instalar ferramentas de compilação em um contêiner
• Solução de problemas de contêineres do Windows e das Ferramentas de Compilação
• Conjunto de trabalho do Visual Studio Build Tools e IDs de componentes