.NET 8 Microsoft Orleans应用Docker运行报错求助

问题描述 #

我有一个基于.NET 8的Microsoft Orleans应用，项目文件myApp.csproj内容如下：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
</Project>

对应的Dockerfile配置：

# Stage 1: Build the application
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build-env

# Set the working directory
WORKDIR /app

# Copy the project files and restore dependencies
COPY *.csproj ./
RUN dotnet restore

# Copy the remaining source files and build the application
COPY . ./
RUN dotnet publish -c Release -o out

# Stage 2: Build the runtime image
FROM mcr.microsoft.com/dotnet/runtime:8.0

# Set the working directory
WORKDIR /app

# Copy the build output from the build stage
COPY --from=build-env /app/out .

# Expose the gRPC port
EXPOSE 6565

# Define the entry point for the application
ENTRYPOINT ["dotnet", "myApp.dll"]

执行以下命令构建并运行容器时：

docker build -t myApp:latest .
docker run -d -p 6565:6565 --name myApp myApp:latest

出现错误：

You must install or update .NET to run this application.

App: /app/myApp.dll
Architecture: x64
Framework: 'Microsoft.NETCore.App', version '8.0.0' (x64)
.NET location: /usr/share/dotnet/

The following frameworks were found:
  6.0.31 at [/usr/share/dotnet/shared/Microsoft.NETCore.App]

尝试切换端口后问题依旧。

原因分析 #

• 项目使用Microsoft.NET.Sdk.Web SDK，属于ASP.NET Core应用（Orleans gRPC依赖ASP.NET Core运行时），但Dockerfile第二阶段使用的是基础.NET Runtime镜像，该镜像不包含ASP.NET Core运行时环境，无法适配Web类型应用。
• 可能存在Docker镜像缓存问题，导致拉取的runtime:8.0镜像实际为旧版本或错误版本。

解决方案 #

1. 替换runtime镜像为aspnet镜像 #

修改Dockerfile第二阶段的基础镜像为mcr.microsoft.com/dotnet/aspnet:8.0，该镜像包含完整的ASP.NET Core运行时，适配Web SDK构建的应用：

# Stage 2: Build the runtime image
FROM mcr.microsoft.com/dotnet/aspnet:8.0

# Set the working directory
WORKDIR /app

# Copy the build output from the build stage
COPY --from=build-env /app/out .

# Expose the gRPC port
EXPOSE 6565

# Define the entry point for the application
ENTRYPOINT ["dotnet", "myApp.dll"]

2. 清理Docker缓存并重新构建 #

为避免缓存导致的旧镜像问题，执行以下命令强制重新拉取镜像并构建：

docker build --no-cache -t myApp:latest .
docker stop myApp && docker rm myApp
docker run -d -p 6565:6565 --name myApp myApp:latest

3. 可选：使用自包含发布 #

如果希望彻底避免运行时依赖问题，可以修改发布命令为自包含模式，将.NET运行时打包到镜像中：
在Dockerfile的dotnet publish命令中添加--self-contained true -r linux-x64参数：

RUN dotnet publish -c Release -o out --self-contained true -r linux-x64

此时第二阶段可以使用更轻量的基础镜像（如debian:bookworm-slim），进一步减小镜像体积。

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