容器的高级示例

将生成工具安装到容器中的示例 Dockerfile 始终使用基于最新 microsoft/windowsservercore 映像和最新 Visual Studio 生成工具安装程序的 microsoft/dotnet-framework:4.8 映像。 如果将此映像发布到 Docker 注册表以供他人进行拉取，则此映像可能适用于许多方案。 但在实际中，更常见的是明确使用的基础映像、下载的二进制文件和安装的工具版本。

下面的示例 Dockerfile 使用 microsoft/dotnet-framework 映像的特定版本标记。 对基础映像使用特定标记十分普遍，这样可轻松记住生成或重新生成映像始终具有相同基础。

注意

无法将 Visual Studio 安装到 microsoft/windowsservercore:10.0.14393.1593 或任何基于它的映像中，后者具有与在容器中启动安装程序有关的已知问题。 有关详细信息，请参阅容器的已知问题。

以下示例下载的是生成工具的最新版本。 若要使用可稍后安装到容器中的旧版生成工具，则必须先创建和维护布局。

安装脚本

若要在发生安装错误时收集日志，请在工作目录中创建名为“Install.cmd”的批处理脚本，它包含以下内容：

@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

在工作目录中，使用以下内容创建“Dockerfile”：

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

运行以下命令以在当前工作目录中生成映像：

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

使用 --build-arg 命令行开关选择性地传递某个或同时传递 FROM_IMAGE 或 CHANNEL_URL 参数，以指定不同的基础映像或内部布局的位置来保持固定的映像。

提示

有关工作负载和组件的列表，请参阅 Visual Studio 生成工具组件目录。

诊断安装失败

此示例下载特定工具并验证哈希代码是否匹配。 它还下载最新 Visual Studio 和 .NET 日志收集实用工具，以便在安装失败时，可以将日志复制到主机以分析失败。

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

最后一行完成执行之后，在计算机上打开“%TEMP%\vslogs.zip”，或在开发者社区网站上提交问题。

支持或故障排除

有时，你难免遇到一些问题。 如果 Visual Studio 安装失败，请参阅 Visual Studio 安装和升级问题疑难解答获取分步指南。

下面是另外几个支持选项：

• 对于与安装相关的问题，我们提供安装聊天（仅限英语）支持选项。
• 通过报告问题工具（会出现在 Visual Studio 安装程序和 Visual Studio IDE 中）向我们报告产品问题。 如果你是 IT 管理员，并且尚未安装 Visual Studio，可以在此处提交 IT 管理员反馈。
• 在 Visual Studio 开发人员社区中，可提出功能建议、跟踪产品问题，并能找到答案。

相关内容

• 将生成工具安装到容器
• Windows 和生成工具容器故障排除
• Visual Studio 生成工具工作负载和组件 ID