名称解析提供者组件规范 on Dapr 文档库

HashiCorp Consul

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

配置格式

在 Dapr 配置中设置 HashiCorp Consul。

在配置中，添加 nameResolution 规范，并将 component 字段设为 "consul"。

如果您使用 Dapr sidecar 将服务注册到 Consul，需要以下配置：

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
 name: appconfig
spec:
 nameResolution:
 component: "consul"
 configuration:
 selfRegister: true

如果 Consul 服务注册由 Dapr 外部管理，您需要确保 Dapr 到 Dapr 的内部 gRPC 端口已添加到服务元数据中的 DAPR_PORT（此键是可配置的），并且 Consul 服务 ID 与 Dapr 应用 ID 匹配。在这种情况下，可以省略上述配置中的 selfRegister。

行为

在 init 时，Consul 组件会验证与配置的（或默认的）代理的连接，或者在配置时注册服务。名称解析接口不支持“关闭时”模式，因此在使用 Dapr 将服务注册到 Consul 时请注意，它不会注销服务。

该组件通过过滤健康服务来解析目标应用，并在元数据中查找 DAPR_PORT（键是可配置的）以获取 Dapr sidecar 端口。Consul 使用 service.meta 而不是 service.port，以避免干扰现有的 Consul 配置。

Kubernetes DNS

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

配置格式

一般情况下，Kubernetes 模式下的 Kubernetes DNS 名称解析由 Dapr 自动配置。除非需要对 Kubernetes 名称解析组件进行特定的覆盖，否则无需额外配置即可使用 Kubernetes DNS 作为名称解析提供者。

如果需要进行覆盖，可以在 Dapr 配置 CRD 中，添加一个 nameResolution 规范，并将 component 字段设置为 "kubernetes"。其他配置字段可以根据需要在 configuration 映射中设置，如下所示。

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
 name: appconfig
spec:
 nameResolution:
 component: "kubernetes"
 configuration:
 clusterDomain: "cluster.local" # 与 template 字段互斥
 template: "{{.ID}}-{{.Data.region}}.internal:{{.Port}}" # 与 clusterDomain 字段互斥

行为

该组件通过 Kubernetes 集群的 DNS 提供者来解析目标应用。您可以在 Kubernetes 文档中了解更多信息。

规范配置字段

配置规范固定为 Consul API 的 v1.3.0 版本

字段	必需	类型	详情	示例
clusterDomain	N	`string`	用于解析地址的集群域。此字段与 `template` 字段互斥。	`cluster.local`
template	N	`string`	使用 text/template 解析地址时的模板字符串。模板将由 ResolveRequest 结构中的字段填充。此字段与 `clusterDomain` 字段互斥。	`{{.ID}}-{{.Data.region}}.{{.Namespace}}.internal:{{.Port}}`

mDNS

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

配置格式

在Dapr的自托管模式中，mDNS会自动配置。使用mDNS作为名称解析提供程序无需进行任何配置。

行为

该组件通过主机系统的mDNS服务来解析目标应用程序。您可以在这里了解更多关于mDNS的信息。

故障排除

在某些云提供商的虚拟网络中，例如Microsoft Azure，mDNS可能不可用。请使用其他提供程序，例如HashiCorp Consul。

在某些企业管理的系统上，如果配置了网络过滤器或代理，macOS上的mDNS可能会被禁用。如果mDNS被禁用且您无法在本地使用服务调用，请与您的IT部门确认。

规格配置字段

不适用，因为在自托管模式下运行时，mDNS由Dapr自动配置。

SQLite

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

SQLite名称解析组件可以作为mDNS的替代方案，适用于在单节点环境中运行Dapr以及本地开发场景。集群中的Dapr sidecar会将其信息存储在本地机器上的SQLite数据库中。

注意

该组件经过优化，适用于所有Dapr实例运行在同一台物理机器上的场景，数据库通过同一个本地挂载的磁盘进行访问。
通过网络（包括SMB/NFS）使用SQLite名称解析器访问数据库文件可能会导致数据损坏，因此不支持。

配置格式

名称解析通过Dapr配置进行设置。

在配置YAML中，将spec.nameResolution.component属性设置为"sqlite"，然后在spec.nameResolution.configuration字典中传递配置选项。

以下是一个基本的配置示例：

apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
 name: appconfig
spec:
 nameResolution:
 component: "sqlite"
 version: "v1"
 configuration:
 connectionString: "/home/user/.dapr/nr.db"

规格配置字段

使用SQLite名称解析组件时，spec.nameResolution.configuration字典包含以下选项：

字段	必需	类型	详情	示例
`connectionString`	Y	`string`	SQLite数据库的连接字符串。通常，这是磁盘上文件的路径，可以是相对路径或绝对路径。	`"nr.db"`（相对于工作目录），`"/home/user/.dapr/nr.db"`
`updateInterval`	N	Go duration (作为`string`)	活跃的Dapr sidecar在数据库中更新其状态的间隔，用作健康检查。较小的间隔减少了应用程序离线时返回过时数据的可能性，但增加了数据库的负载。必须至少比`timeout`大1秒。带有秒数分数的值会被截断（例如，`1500ms`变为`1s`）。默认值：`5s`	`"2s"`
`timeout`	N	Go duration (作为`string`)。必须至少为1秒。	数据库操作的超时时间。整数被解释为秒数。默认值为`1s`	`"2s"`，`2`
`tableName`	N	`string`	存储数据的表的名称。如果表不存在，Dapr会创建该表。默认值为`hosts`。	`"hosts"`
`metadataTableName`	N	`string`	Dapr用于存储组件元数据的表的名称。如果表不存在，Dapr会创建该表。默认值为`metadata`。	`"metadata"`
`cleanupInterval`	N	Go duration (作为`string`)	从数据库中删除过时记录的间隔。默认值：`1h`（1小时）	`"10m"`
`busyTimeout`	N	Go duration (作为`string`)	在SQLite数据库当前忙于处理另一个请求时等待的间隔，然后返回“数据库忙”错误。这是一个高级设置。 `busyTimeout`控制SQLite中的锁定工作方式。对于SQLite，写入是独占的，因此每次任何应用程序写入时，数据库都会被锁定。如果另一个应用程序尝试写入，它会等待最多`busyTimeout`时间，然后返回“数据库忙”错误。然而，`timeout`设置控制整个操作的超时时间。例如，如果查询“挂起”，在数据库获取锁之后（即在忙超时清除之后），则`timeout`生效。默认值：`800ms`（800毫秒）	`"100ms"`
`disableWAL`	N	`bool`	如果设置为true，则禁用SQLite数据库的预写日志记录。这仅适用于高级场景	`true`，`false`

名称解析提供者组件规范 on Dapr 文档库

HashiCorp Consul

配置格式

行为

Kubernetes DNS

配置格式

行为

规范配置字段

相关链接

mDNS

配置格式

行为

故障排除

规格配置字段

相关链接

SQLite

注意

配置格式

规格配置字段

相关链接