The documentation you are viewing is for Dapr v1.13 which is an older version of Dapr. For up-to-date documentation, see the latest version.

This is documentation on a preview feature.

.NET

Dapr 提供 NuGet 包来帮助开发 .NET 可插拔组件。

前期准备

项目创建

创建一个可插拔组件始于一个空的ASP.NET项目。

dotnet new web --name <project name>

添加 NuGet 包

添加 Dapr .NET 可插拔组件 NuGet 包。

dotnet add package Dapr.PluggableComponents.AspNetCore

创建应用程序和服务

创建一个 Dapr 可插拔组件应用程序与创建一个 ASP.NET 应用程序类似。 在Program.cs中,用Dapr的DaprPluggableComponentsApplication等效代码替换WebApplication相关代码。

using Dapr.PluggableComponents;

var app = DaprPluggableComponentsApplication.Create();

app.RegisterService(
    "<socket name>",
    serviceBuilder =>
    {
        // Register one or more components with this service.
    });

app.Run();

这将创建一个具有单个服务的应用程序。 每个服务:

  • 对应于单个 Unix 域套接字
  • 可以托管一个或多个组件类型

实现和注册组件

在本地测试组件

可插拔组件可以通过在命令行上启动应用程序并配置一个 Dapr sidecar 来进行测试。

要启动组件,在应用程序目录中执行以下操作:

dotnet run

要配置 Dapr 使用该组件,在资源路径目录中:

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: <component name>
spec:
  type: state.<socket name>
  version: v1
  metadata:
  - name: key1
    value: value1
  - name: key2
    value: value2

任何metadata属性将在组件实例化时通过其IPluggableComponent.InitAsync()方法传递给组件。

要启动 Dapr(以及可选地使用该服务的服务):

dapr run --app-id <app id> --resources-path <resources path> ...

此时,Dapr sidecar 将已经启动并通过 Unix Domain Socket 连接到组件。 然后你可以通过组件进行交互:

  • 通过使用组件的服务(如果已启动),或者
  • 通过直接使用 Dapr 的 HTTP 或 gRPC API

创建容器

有几种方法可以为您的组件创建一个容器,以备部署。

使用 .NET SDK

.NET 7及更高版本的SDK使您能够为您的应用程序创建一个基于.NET的容器,即使是针对较早版本的.NET SDK,也无需Dockerfile。 这可能是今天为您的组件生成容器最简单的方法。

Microsoft.NET.Build.Containers NuGet包添加到组件项目中。

dotnet add package Microsoft.NET.Build.Containers

将应用程序发布为容器:

dotnet publish --os linux --arch x64 /t:PublishContainer -c Release

要获取更多配置选项,例如控制容器名称、标签和基础镜像,请参阅.NET 作为容器发布指南

使用 Dockerfile

虽然有一些工具可以为.NET应用程序生成一个Dockerfile,但.NET SDK本身并不提供该功能。 一个典型的Dockerfile可能如下所示:

FROM mcr.microsoft.com/dotnet/aspnet:<runtime> AS base
WORKDIR /app

# Creates a non-root user with an explicit UID and adds permission to access the /app folder
# For more info, please refer to https://aka.ms/vscode-docker-dotnet-configure-containers
RUN adduser -u 5678 --disabled-password --gecos "" appuser && chown -R appuser /app
USER appuser

FROM mcr.microsoft.com/dotnet/sdk:<runtime> AS build
WORKDIR /src
COPY ["<application>.csproj", "<application folder>/"]
RUN dotnet restore "<application folder>/<application>.csproj"
COPY . .
WORKDIR "/src/<application folder>"
RUN dotnet build "<application>.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "<application>.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "<application>.dll"]

构建镜像:

docker build -f Dockerfile -t <image name>:<tag> .