服务调用 on Dapr 文档库

服务调用概述

Mon, 01 Jan 0001 00:00:00 +0000

通过服务调用，您的应用程序可以使用标准的gRPC或HTTP协议可靠且安全地与其他应用程序进行通信。

在许多基于微服务的应用程序中，多个服务需要能够相互通信。这种服务间通信要求应用程序开发人员处理以下问题：

服务发现。 如何找到我的不同服务？
标准化服务间的API调用。 如何在服务之间调用方法？
安全的服务间通信。 如何通过加密安全地调用其他服务并对方法应用访问控制？
缓解请求超时或失败。 如何处理重试和瞬态错误？
实现可观测性和追踪。 如何使用追踪查看带有指标的调用图以诊断生产中的问题？

服务调用API

Dapr通过提供一个类似反向代理的服务调用API来解决这些挑战，该API内置了服务发现，并利用了分布式追踪、指标、错误处理、加密等功能。

Dapr采用sidecar架构。要使用Dapr调用应用程序：

您在Dapr实例上使用invoke API。
每个应用程序与其自己的Dapr实例通信。
Dapr实例相互发现并通信。

以下概述视频和演示展示了Dapr服务调用的工作原理。

下图概述了Dapr的服务调用在两个集成Dapr的应用程序之间的工作原理。

服务A发起一个HTTP或gRPC调用，目标是服务B。调用发送到本地Dapr sidecar。
Dapr使用正在运行的名称解析组件在给定的托管平台上发现服务B的位置。
Dapr将消息转发到服务B的Dapr sidecar
- 注意：所有Dapr sidecar之间的调用都通过gRPC进行以提高性能。只有服务与Dapr sidecar之间的调用可以是HTTP或gRPC。
服务B的Dapr sidecar将请求转发到服务B上的指定端点（或方法）。服务B然后运行其业务逻辑代码。
服务B向服务A发送响应。响应发送到服务B的sidecar。
Dapr将响应转发到服务A的Dapr sidecar。
服务A接收响应。

您还可以使用服务调用API调用非Dapr HTTP端点。例如，您可能只在整个应用程序的一部分中使用Dapr，可能无法访问代码以迁移现有应用程序以使用Dapr，或者只是需要调用外部HTTP服务。阅读“如何：使用HTTP调用非Dapr端点”以获取更多信息。

功能

服务调用提供了多种功能，使您可以轻松地在应用程序之间调用方法或调用外部HTTP端点。

HTTP和gRPC服务调用

HTTP：如果您已经在应用程序中使用HTTP协议，使用Dapr HTTP头可能是最简单的入门方式。您无需更改现有的端点URL；只需添加dapr-app-id头即可开始。有关更多信息，请参阅使用HTTP调用服务。
gRPC：Dapr允许用户保留自己的proto服务并以gRPC的方式工作。这意味着您可以使用服务调用来调用现有的gRPC应用程序，而无需包含任何Dapr SDK或自定义gRPC服务。有关更多信息，请参阅Dapr和gRPC的操作教程。

服务到服务的安全性

通过Dapr Sentry服务，所有Dapr应用程序之间的调用都可以通过托管平台上的相互（mTLS）认证来实现安全，包括自动证书轮换。

有关更多信息，请阅读服务到服务的安全性文章。

包括重试的弹性

在调用失败和瞬态错误的情况下，服务调用提供了一种弹性功能，可以在回退时间段内自动重试。要了解更多信息，请参阅弹性文章。

具有可观测性的追踪和指标

默认情况下，所有应用程序之间的调用都会被追踪，并收集指标以提供应用程序的洞察和诊断。这在生产场景中特别重要，提供了服务之间调用的调用图和指标。有关更多信息，请阅读可观测性。

访问控制

通过访问策略，应用程序可以控制：

哪些应用程序被允许调用它们。
应用程序被授权做什么。

例如，您可以限制包含人员信息的敏感应用程序不被未授权的应用程序访问。结合服务到服务的安全通信，您可以提供软多租户部署。

有关更多信息，请阅读服务调用的访问控制允许列表文章。

命名空间范围

您可以将应用程序限定到命名空间以进行部署和安全，并在部署到不同命名空间的服务之间进行调用。有关更多信息，请阅读跨命名空间的服务调用文章。

使用mDNS的轮询负载均衡

Dapr通过mDNS协议提供服务调用请求的轮询负载均衡，例如在单台机器或多台联网的物理机器上。

操作指南：使用HTTP调用服务

Mon, 01 Jan 0001 00:00:00 +0000

本文演示了如何部署服务，每个服务都有一个唯一的应用程序ID，以便其他服务可以通过HTTP进行服务调用来发现并调用它们的端点。

注意

如果您还没有尝试过，请先查看服务调用快速入门，以快速了解如何使用服务调用API。

为服务选择一个ID

Dapr允许您为应用程序分配一个全局唯一的ID。无论应用程序有多少实例，该ID都代表应用程序的状态。

dapr run --app-id checkout --app-protocol http --dapr-http-port 3500 -- python3 checkout/app.py

dapr run --app-id order-processor --app-port 8001 --app-protocol http --dapr-http-port 3501 -- python3 order-processor/app.py

如果您的应用程序使用TLS，您可以通过设置--app-protocol https来告诉Dapr通过TLS连接调用您的应用程序：

如何使用 gRPC 调用服务

Mon, 01 Jan 0001 00:00:00 +0000

本文介绍如何通过 Dapr 使用 gRPC 进行服务间通信。

通过 Dapr 的 gRPC 代理功能，您可以使用现有的基于 proto 的 gRPC 服务，并让流量通过 Dapr sidecar。这为开发人员带来了以下 Dapr 服务调用的优势：

双向认证
跟踪
指标
访问控制列表
网络级别的弹性
基于 API 令牌的认证

Dapr 支持代理所有类型的 gRPC 调用，包括一元和流式调用。

第一步：运行 gRPC 服务器

以下示例来自 “hello world” grpc-go 示例。虽然此示例使用 Go 语言，但相同的概念适用于所有支持 gRPC 的编程语言。

package main

import (
	"context"
	"log"
	"net"

	"google.golang.org/grpc"
	pb "google.golang.org/grpc/examples/helloworld/helloworld"
)

const (
	port = ":50051"
)

// server 用于实现 helloworld.GreeterServer。
type server struct {
	pb.UnimplementedGreeterServer
}

// SayHello 实现 helloworld.GreeterServer
func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
	log.Printf("Received: %v", in.GetName())
	return &pb.HelloReply{Message: "Hello " + in.GetName()}, nil
}

func main() {
	lis, err := net.Listen("tcp", port)
	if err != nil {
		log.Fatalf("failed to listen: %v", err)
	}
	s := grpc.NewServer()
	pb.RegisterGreeterServer(s, &server{})
	log.Printf("server listening at %v", lis.Addr())
	if err := s.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}

这个 Go 应用实现了 Greeter proto 服务并提供了一个 SayHello 方法。

如何：使用HTTP调用非Dapr端点

Mon, 01 Jan 0001 00:00:00 +0000

本文介绍如何通过Dapr使用HTTP调用非Dapr端点。

通过Dapr的服务调用API，您可以与使用或不使用Dapr的端点进行通信。使用Dapr调用非Dapr端点不仅提供了一致的API，还带来了以下Dapr服务调用的优势：

应用弹性策略
通过跟踪和指标实现调用的可观测性
通过访问控制实现安全性
利用中间件管道组件
服务发现
使用请求头进行身份验证

通过HTTP调用外部服务或非Dapr端点

有时您可能需要调用非Dapr的HTTP端点，例如：

您可能只在应用程序的一部分中使用Dapr，尤其是在涉及旧系统时
您可能无法访问代码以将现有应用程序迁移到Dapr
您需要调用外部的HTTP服务

通过定义HTTPEndpoint资源，您可以声明性地配置与非Dapr端点的交互方式。然后，您可以使用服务调用URL来访问非Dapr端点。或者，您可以直接在服务调用URL中使用非Dapr的完全限定域名（FQDN）端点URL。

HttpEndpoint、FQDN URL和appId的优先级

在进行服务调用时，Dapr运行时遵循以下优先级顺序：

是否为命名的HTTPEndpoint资源？
是否为带有http://或https://前缀的FQDN URL？
是否为appID？

服务调用与非Dapr HTTP端点

下图概述了Dapr在调用非Dapr端点时的工作流程。

服务A发起一个HTTP调用，目标是服务B（一个非Dapr端点）。调用被发送到本地的Dapr sidecar。
Dapr通过HTTPEndpoint或FQDN URL定位服务B的位置，然后将消息转发给服务B。
服务B向服务A的Dapr sidecar发送响应。
服务A接收响应。

使用HTTPEndpoint资源或FQDN URL调用非Dapr端点

在与Dapr应用程序或非Dapr应用程序通信时，有两种方法可以调用非Dapr端点。Dapr应用程序可以通过以下方式之一调用非Dapr端点：

使用命名的HTTPEndpoint资源，定义一个HTTPEndpoint资源类型。请参阅HTTPEndpoint参考中的示例。
```
localhost:3500/v1.0/invoke/<HTTPEndpoint-name>/method/<my-method>
```
例如，使用名为"palpatine"的HTTPEndpoint资源和名为"Order66"的方法：
```
curl http://localhost:3500/v1.0/invoke/palpatine/method/order66
```

使用指向非Dapr端点的FQDN URL。

localhost:3500/v1.0/invoke/<URL>/method/<my-method>

例如，使用名为https://darthsidious.starwars的FQDN资源：

curl http://localhost:3500/v1.0/invoke/https://darthsidious.starwars/method/order66

使用appId调用启用Dapr的应用程序

AppID用于通过appID和my-method调用Dapr应用程序。阅读如何：使用HTTP调用服务指南以获取更多信息。例如：

localhost:3500/v1.0/invoke/<appID>/method/<my-method>

curl http://localhost:3602/v1.0/invoke/orderprocessor/method/checkout

TLS认证

使用HTTPEndpoint资源允许您根据远程端点的认证要求使用根证书、客户端证书和私钥的任意组合。

使用根证书的示例

apiVersion: dapr.io/v1alpha1
kind: HTTPEndpoint
metadata:
 name: "external-http-endpoint-tls"
spec:
 baseUrl: https://service-invocation-external:443
 headers:
 - name: "Accept-Language"
 value: "en-US"
 clientTLS:
 rootCA:
 secretKeyRef:
 name: dapr-tls-client
 key: ca.crt

使用客户端证书和私钥的示例

apiVersion: dapr.io/v1alpha1
kind: HTTPEndpoint
metadata:
 name: "external-http-endpoint-tls"
spec:
 baseUrl: https://service-invocation-external:443
 headers:
 - name: "Accept-Language"
 value: "en-US"
 clientTLS:
 certificate:
 secretKeyRef:
 name: dapr-tls-client
 key: tls.crt
 privateKey:
 secretKeyRef:
 name: dapr-tls-key
 key: tls.key

社区电话演示

观看此视频以了解如何使用服务调用来调用非Dapr端点。

指南：跨命名空间进行服务调用

Mon, 01 Jan 0001 00:00:00 +0000

在本文中，您将学习如何在不同命名空间之间进行服务调用。默认情况下，service-invocation支持通过简单引用应用程序ID（如nodeapp）来调用同一命名空间内的服务：

localhost:3500/v1.0/invoke/nodeapp/method/neworder

service-invocation也支持跨命名空间的调用。在所有支持的平台上，Dapr应用程序ID遵循包含目标命名空间的有效FQDN格式。您可以同时指定：

应用程序ID（如nodeapp），以及
应用程序所在的命名空间（如production）。

示例 1

调用位于production命名空间中nodeapp的neworder方法：

localhost:3500/v1.0/invoke/nodeapp.production/method/neworder

在使用service-invocation调用不同命名空间中的应用程序时，您需要使用命名空间来限定它。这在Kubernetes集群中的跨命名空间调用中非常有用。

示例 2

调用位于production命名空间中myapp的ping方法：

https://localhost:3500/v1.0/invoke/myapp.production/method/ping

示例 3

使用curl命令从外部DNS地址（例如api.demo.dapr.team）调用与示例2相同的ping方法，并提供Dapr API令牌进行身份验证：

MacOS/Linux:

curl -i -d '{ "message": "hello" }' \
 -H "Content-type: application/json" \
 -H "dapr-api-token: ${API_TOKEN}" \
 https://api.demo.dapr.team/v1.0/invoke/myapp.production/method/ping

服务调用 on Dapr 文档库

服务调用概述

服务调用API

功能

HTTP和gRPC服务调用

服务到服务的安全性

包括重试的弹性

具有可观测性的追踪和指标

访问控制

命名空间范围

使用mDNS的轮询负载均衡

操作指南：使用HTTP调用服务

注意

为服务选择一个ID

如何使用 gRPC 调用服务

第一步：运行 gRPC 服务器

如何：使用HTTP调用非Dapr端点

通过HTTP调用外部服务或非Dapr端点

HttpEndpoint、FQDN URL和appId的优先级

服务调用与非Dapr HTTP端点

使用HTTPEndpoint资源或FQDN URL调用非Dapr端点

使用appId调用启用Dapr的应用程序

TLS认证

使用根证书的示例

使用客户端证书和私钥的示例

相关链接

社区电话演示

指南：跨命名空间进行服务调用