.NET Aspire项目AppHost部署Docker容器遇发布目录缺失问题

问题描述 #

尝试将.NET Aspire项目部署到Docker容器，使用docker init生成Dockerfile和docker-compose文件后，运行docker compose up --build提示未安装Aspire workload；添加安装命令后，dotnet publish未生成输出目录，后续镜像构建阶段复制/app路径时提示找不到该目录，检查所有目录均无此输出文件夹。

相关文件 #

Dockerfile #

# syntax=docker/dockerfile:1

# Comments are provided throughout this file to help you get started.
# If you need more help, visit the Dockerfile reference guide at
# https://docs.docker.com/go/dockerfile-reference/

# Want to help us make this template better? Share your feedback here: https://forms.gle/ybq9Krt8jtBL3iCk7

################################################################################

# Learn about building .NET container images:
# https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md

# Create a stage for building the application.
FROM --platform=$BUILDPLATFORM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build

COPY . /source

WORKDIR /source/Catalog.AppHost

# This is the architecture you’re building for, which is passed in by the builder.
# Placing it here allows the previous steps to be cached across architectures.
ARG TARGETARCH

# Build the application.
# Leverage a cache mount to /root/.nuget/packages so that subsequent builds don't have to re-download packages.
# If TARGETARCH is "amd64", replace it with "x64" - "x64" is .NET's canonical name for this and "amd64" doesn't
#   work in .NET 6.0.
RUN dotnet workload install aspire && \
    dotnet restore
RUN --mount=type=cache,id=nuget,target=/root/.nuget/packages \
    dotnet publish -a ${TARGETARCH/amd64/x64} -c Debug --use-current-runtime --self-contained false -o /app && \
    ls -al && ls ../ -al && ls ../../ -al

# If you need to enable globalization and time zones:
# https://github.com/dotnet/dotnet-docker/blob/main/samples/enable-globalization.md
################################################################################
# Create a new stage for running the application that contains the minimal
# runtime dependencies for the application. This often uses a different base
# image from the build stage where the necessary files are copied from the build
# stage.
#
# The example below uses an aspnet alpine image as the foundation for running the app.
# It will also use whatever happens to be the most recent version of that tag when you
# build your Dockerfile. If reproducability is important, consider using a more specific
# version (e.g., aspnet:7.0.10-alpine-3.18),
# or SHA (e.g., mcr.microsoft.com/dotnet/aspnet@sha256:f3d99f54d504a21d38e4cc2f13ff47d67235efeeb85c109d3d1ff1808b38d034).
FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine AS final
WORKDIR /app

# Copy everything needed to run the app from the "build" stage.
COPY --from=build /app .

# Switch to a non-privileged user (defined in the base image) that the app will run under.
# See https://docs.docker.com/go/dockerfile-user-best-practices/
# and https://github.com/dotnet/dotnet-docker/discussions/4764
USER $APP_UID

ENTRYPOINT ["dotnet", "Catalog.AppHost.dll"]

docker-compose.yml #

services:
  server:
    build:
      context: .
      target: final
    ports:
      - 8080:8080

错误信息 #

docker compose up --build
[+] Building 4.1s (16/16) FINISHED                                                                                                            docker:desktop-linux
 => [server internal] load build definition from Dockerfile                                                                                                   0.0s
 => => transferring dockerfile: 2.80kB                                                                                                                        0.0s
 => [server] resolve image config for docker-image://docker.io/docker/dockerfile:1                                                                            1.0s
 => [server auth] docker/dockerfile:pull token for registry-1.docker.io                                                                                       0.0s
 => CACHED [server] docker-image://docker.io/docker/dockerfile:1@sha256:fe40cf4e92cd0c467be2cfc30657a680ae2398318afd50b0c80585784c604f28                      0.0s
 => [server internal] load metadata for mcr.microsoft.com/dotnet/sdk:8.0-alpine                                                                               0.4s
 => [server internal] load metadata for mcr.microsoft.com/dotnet/aspnet:8.0-alpine                                                                            0.4s
 => [server internal] load .dockerignore                                                                                                                      0.0s
 => => transferring context: 647B                                                                                                                             0.0s
 => [server internal] load build context                                                                                                                      0.0s
 => => transferring context: 2.73kB                                                                                                                           0.0s
 => [server build 1/5] FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine@sha256:6e8997576d16a6d7b4e6ba7ac0956d3ae46cb7a376581c40eabd20fbc5c28b8d                   0.0s
 => [server final 1/3] FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine@sha256:e22d879fb9a0fba3b2a6b15c88f005192c239e189061534c86643347b4630140                0.0s
 => CACHED [server build 2/5] COPY . /source                                                                                                                  0.0s
 => CACHED [server build 3/5] WORKDIR /source/Catalog.AppHost                                                                                                 0.0s
 => CACHED [server build 4/5] RUN dotnet workload install aspire &&     dotnet restore                                                                        0.0s
 => [server build 5/5] RUN --mount=type=cache,id=nuget,target=/root/.nuget/packages     dotnet publish -a x64 -c Testing --use-current-runtime --self-contai  2.1s
 => CACHED [server final 2/3] WORKDIR /app                                                                                                                    0.0s
 => ERROR [server final 3/3] COPY --from=build /app .                                                                                                         0.0s
------
 > [server final 3/3] COPY --from=build /app .:
------
failed to solve: failed to compute cache key: failed to calculate checksum of ref b9d56e54-9eee-48c5-b9a6-71b47c1d6335::lymdtg8e61phx9dtukafwjrl7: "/app": not found

问题根源 #

核心错误：Aspire的AppHost项目是本地开发阶段的服务编排入口，本身不包含可独立运行的业务服务逻辑，因此无法通过dotnet publish生成有效的输出目录。docker init生成的配置默认针对普通.NET项目，不适用于Aspire的特殊架构。

解决方案 #

方案1：改用Aspire官方Docker编排工具（推荐） #

Aspire提供了专门的Docker部署命令，可自动生成正确的镜像构建和编排配置，无需手动修改Dockerfile：

1. 确保本地已安装Aspire workload：

   dotnet workload install aspire
   

2. 切换到Aspire项目根目录（包含AspireAppHost.csproj的父目录），运行：

   dotnet aspire docker compose up --build
   

   该命令会自动处理所有业务服务的镜像构建、容器编排，绕过AppHost部署的问题。

方案2：手动调整Dockerfile部署业务服务 #

若坚持手动配置，需将Dockerfile的目标改为实际的业务服务项目（而非AppHost）：

1. 修改Dockerfile中的工作目录，指向你的业务服务项目（例如Catalog.Service）：

   WORKDIR /source/Catalog.Service
   

2. 简化dotnet publish命令，确保参数正确：

   RUN --mount=type=cache,id=nuget,target=/root/.nuget/packages \
       dotnet publish -c Release -o /app --no-restore
   

3. 调整ENTRYPOINT为业务服务的DLL：

   ENTRYPOINT ["dotnet", "Catalog.Service.dll"]
   

4. 重新运行docker compose up --build。

额外检查项 #

• 确认.dockerignore文件未误排除.csproj、Directory.Packages.props等必要文件，否则镜像中缺少项目配置会导致publish失败。
• Alpine镜像中安装Aspire workload时需确保网络通畅，若遇到网络问题，可切换到非Alpine的SDK镜像（如mcr.microsoft.com/dotnet/sdk:8.0）。

内容的提问来源于stack exchange，提问作者Sebastian Duta