容器的進階範例

發行項
12/18/2024

範例 Dockerfile 在步驟將 Build Tools 安裝至容器中時，一律會使用基於最新 microsoft/windowsservercore 映像和最新 Visual Studio Build Tools 安裝程式的 microsoft/dotnet-framework:4.8 映像。如果您將此映射發佈至 Docker 登錄，供其他人提取，則此映射可能適用於許多案例。不過，實際上，更常見的是具體說明您所使用的基底映像，您下載的二進制檔案，以及您安裝的工具版本。

下列範例 Dockerfile 使用 microsoft/dotnet-framework 映射的特定版本標記。使用基底映像的特定標籤很常見，並可讓您輕鬆地記住建置或重建映像一律具有相同的基礎。

注意

您無法將 Visual Studio 安裝到 microsoft/windowsservercore:10.0.14393.1593 或任何以其為基礎的映像，已知在容器中啟動安裝程序時會有問題。如需詳細資訊，請參閱容器的已知問題。

下列範例會下載最新版的 Build Tools。如果您想要使用稍後可安裝至容器的舊版建置工具，您必須先建立並維護版面配置。

安裝腳本

若要在發生安裝錯誤時收集記錄，請在工作目錄中建立名為「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 a specific tagged image. Tags can be changed, though that is unlikely for most images.
# You could also use the immutable tag @sha256:324e9ab7262331ebb16a4100d0fb1cfb804395a766e3bb1806c62989d1fc1326
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/16/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/16/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\2019\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\\2019\\BuildTools\\Common7\\Tools\\VsDevCmd.bat", "&&", "powershell.exe", "-NoLogo", "-ExecutionPolicy", "Bypass"]

# 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 buildtools2019:16.0.28714.193 -t buildtools2019:latest -m 2GB .

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

可以選擇透過使用 --build-arg 命令行開關來傳遞 FROM_IMAGE 或 CHANNEL_URL 的自變數，或者同時傳遞這兩者，以指定不同的基底影像或內部配置的位置，從而維持固定的影像。

提示

如需工作負載和元件的清單，請參閱Visual Studio Build Tools 元件目錄。

診斷安裝失敗

此範例會下載特定工具，並驗證哈希是否相符。它也會下載最新的 Visual Studio 和 .NET 記錄收集公用程式，如此一來，如果安裝失敗發生，您可以將記錄複製到主電腦以分析失敗。

> docker build -t buildtools2019:16.0.28714.193 -t buildtools2019: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"

> 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 開發人員社群中找到答案。

共用方式為

容器的進階範例

安裝腳本

Dockerfile

診斷安裝失敗

支援或疑難解答

意見反應

其他資源

共用方式為

容器的進階範例

安裝腳本

Dockerfile

診斷安裝失敗

支援或疑難解答

相關內容

意見反應

其他資源