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

Kubernetes 生产环境配置指南

在生产环境中将 Dapr 部署到 Kubernetes 集群的建议和做法

集群能力要求

对于生产环境部署的 Kubernetes 集群,建议你运行一个至少由3个工作节点组成的集群,以支持高可用的控制平面安装。 使用以下面的资源设置起步。 要求会根据集群大小和其他因素而有所不同,因此需要进行单独测试,以找到适合你的环境的值:

Deployment CPU Memory
Operator Limit: 1, Request: 100m Limit: 200Mi, Request: 100Mi
Sidecar Injector Limit: 1, Request: 100m Limit: 200Mi, Request: 30Mi
Sentry Limit: 1, Request: 100m Limit: 200Mi, Request: 30Mi
Placement Limit: 1, Request: 250m Limit: 150Mi, Request: 75Mi
Dashboard Limit: 200m, Request: 50m Limit: 200Mi, Request: 20Mi

Helm

使用 Helm 安装 Dapr 时,没有默认限制/请求值。 每个组件都有一个 resources 选项(例如,dapr_dashboard.resources),你可以用它来调整 Dapr 控制平面以适应你的环境。 Helm chart readme有详细的信息和示例。 在本机/开发环境安装的时候,你可以跳过配置 resources 选项。

可选组件

下面的 Dapr 控制平面 deployment 是可选的:

  • Placement-用于Dapr Actors
  • Sentry - 用于服务间调用的 mTLS
  • Dashboard - 用于集群的操作视图

Sidecar 资源设置

要为 Dapr sidecar 设置资源分配,请参阅此处。 与资源约束相关的具体注解如下:

  • dapr.io/sidecar-cpu-limit
  • dapr.io/sidecar-memory-limit
  • dapr.io/sidecar-cpu-request
  • dapr.io/sidecar-memory-request

如果没有设置,Dapr sidecar 将在没有资源配置的情况下运行,这可能会引起问题。 在生产环境下安装时,强烈建议调整这些配置。

有关在 Kubernetes 中配置资源的详细信息,请参见 将内存资源分配给容器和 Pods将 CPU 资源分配给容器和 Pods

在生产环境中,Dapr sidecar 的设置示例:

CPU Memory
Limit: 300m, Request: 100m Limit: 1000Mi, Request: 250Mi

上面的CPU和内存限制是出于Dapr存在大量的I/O密集型操作的考虑。 强烈建议你使用监控工具对 sidecar (和应用) 容器进行基准监控,并根据基准来调整这些设置。

高可用模式

当在生产环境中部署 Dapr 时,建议使用控制平面的高可用 (HA) 配置进行部署,将会在 dapr-system 命名空间中为每个控制平面 pod 创建3个副本。 此配置允许 Dapr 控制平面保留 3 个正在运行的实例,并在节点故障和其他中断后继续存在。

对于新部署的 Dapr ,高可用模式可以通过 Dapr CLIHelm charts 来设置。

对于已部署的 Dapr,启用高可用模式需要执行额外的步骤。 更多详细信息,请参阅 本段

用Helm部署Dapr

访问使用 Helm 部署 Dapr 的完整指南

参数文件

建议不要在命令行上指定参数,而是创建一个值文件。 应将此文件签入源代码管理,以便您可以跟踪其更改。

关于您可以在 值文件中设置的所有可用选项的完整列表(或使用 --set 命令行选项),请参阅 https://github.com/dapr/dapr/blob/master/charts/dapr/README.md

你也可以不使用 helm installhelm upgrade,如下图所示,你可以运行 helm upgrade --install - 这将动态地决定是安装还是升级。

# add/update the helm repo
helm repo add dapr https://dapr.github.io/helm-charts/
helm repo update

# See which chart versions are available
helm search repo dapr --devel --versions

# create a values file to store variables
touch values.yml
cat << EOF >> values.yml
global:
  ha:
    enabled: true
EOF

# run install/upgrade
helm install dapr dapr/dapr \
  --version=<Dapr chart version> \
  --namespace dapr-system \
  --create-namespace \
  --values values.yml \
  --wait

# verify the installation
kubectl get pods --namespace dapr-system

该命令将为 dapr-system 命名空间中每个控制平面 service 创建3个副本。

用 Helm 升级 Dapr

Dapr 支持零停机升级, 升级包括以下步骤: 升级包括以下步骤:

  1. 升级CLI版本(可选但推荐)
  2. 更新 Dapr 控制平面
  3. 更新数据平面(Dapr sidecars)

升级CLI

要升级 Dapr CLI,下载 CLI 的最新版本,并确保它在您的当前路径中。

更新 Dapr 控制平面

请参阅 在 Kubernetes 集群上升级 Dapr 的步骤

更新数据平面(sidecar)

最后一步是更新正在运行 Dapr 的 pod,以接替新版本的 Dapr 运行时。 要完成这一步,只需对有 dapr.io/enabled 注解的任何 deployment 发送 rollout restart 命令即可。

kubectl rollout restart deploy/<Application deployment name>

要查看所有已启用 Dapr 的 deployment 列表,您可以使用 Dapr Dashboard 或使用 Dapr CLI 运行以下命令。

dapr list -k

APP ID     APP PORT  AGE  CREATED
nodeapp    3000      16h  2020-07-29 17:16.22

在现有 Dapr 部署中启用高可用

在现有 Dapr 部署中启用高可用模式需要两步:

  1. 删除已有的 placement 有状态集合:

    kubectl delete statefulset.apps/dapr-placement-server -n dapr-system
    
  2. 执行升级命令:

    helm upgrade dapr ./charts/dapr -n dapr-system --set global.ha.enabled=true
    

您删除 Placement 状态集是因为在高可用模式下,Placement 服务为 Leader 选举添加 Raft。 然而,Kubernetes 仅允许在状态集中更新有限的字段,从而导致 Placement 服务更新失败。

删除现有的 Placement 状态集是安全的。 代理将重新连接并重新注册新创建的 Placement 服务,该服务会将表持久化在 Raft 中。

建议的安全配置

当正确配置时,Dapr 可确保安全通信, 它还可以通过一些内置的功能使你的应用更加安全。 它还可以通过一些内置的功能使你的应用更加安全。

建议生产环境的部署涵盖以下设置:

  1. 启用相互验证 (mTLS)。 请注意,Dapr 默认开启 mTLS。 有关如何携带自定义证书的详细信息,请参见 这里

  2. 启用 Dapr to App API 验证。 这是你的应用程序和 Dapr sidecar 之间的通信。 这能确保 Dapr 知道它正在与授权的应用程序通信。 有关详细信息,请参阅在 Dapr 中启用 API 令牌身份验证

  3. 启用 Dapr to App API 验证。 这是你的应用程序和 Dapr sidecar 之间的通信。 这能确保 Dapr 知道它正在与授权的应用程序通信。 请参阅 使用令牌认证对来自 Dapr 的请求进行认证 了解详情

  4. 所有的组件 YAML 都应该把密钥数据配置在密钥存储中,而不是硬编码在 YAML 文件中。 请参阅 此处,了解如何在 Dapr 组件中使用秘密。

  5. Dapr 控制平面安装在一个专用的命名空间上,如dapr-system

  6. Dapr还支持框定应用程序的组件范围。 这不是必要的,可以根据您的安全需求启用。 请参阅 此处 以获取更多信息。

追踪和度量配置

Dapr 默认启用追踪和度量。 建议在生产环境中为您的应用程序和 Dapr 控制平面设置分布式追踪和度量。

如果你已经有了自己的可观察测性支持组件,你可以禁用 Dapr 的追踪和度量。

追踪

要为 Dapr 配置追踪后端,请访问这个链接。

度量

对于度量,Dapr 在9090端口上暴露了一个 Prometheus 端点,可以被 Prometheus 收集。

要为 Dapr 配置 Prometheus、Grafana 和其他监控工具,请访问 这个链接。

最佳实践

观看此视频,深入了解使用 Kubernetes 中在生产环境中运行 Dapr 的最佳实践