操作指南:启用预览功能
如何指定和启用预览功能
Dapr 中的预览功能在初次发布时被视为实验性功能。这些预览功能需要你明确选择加入才能使用。你需要在 Dapr 的 Configuration 文件中指定此选择加入。
预览功能是基于每个应用程序启用的,方法是在运行应用程序实例时进行设置。
配置属性
Configuration 规范下的 features 部分包含以下属性:
| 属性 | 类型 | 描述 |
|---|---|---|
name | string | 启用/禁用的预览功能的名称 |
enabled | bool | 指定是启用还是禁用该功能的布尔值 |
启用预览功能
预览功能在配置中指定。以下是包含多个功能的完整配置示例:
apiVersion: dapr.io/v1alpha1
kind: Configuration
metadata:
name: featureconfig
spec:
tracing:
samplingRate: "1"
zipkin:
endpointAddress: "http://zipkin.default.svc.cluster.local:9411/api/v2/spans"
features:
- name: Feature1
enabled: true
- name: Feature2
enabled: true
要在本地运行 Dapr 时启用预览功能,可以更新默认配置或使用 dapr run 指定单独的配置文件。
当你运行 dapr init 时会创建默认的 Dapr 配置,位于:
- Windows:
%USERPROFILE%\.dapr\config.yaml - Linux/macOS:
~/.dapr/config.yaml
或者,你可以通过在 dapr run 中指定 --config 标志并指向单独的 Dapr 配置文件,来更新在本地运行的所有应用程序的预览功能:
dapr run --app-id myApp --config ./previewConfig.yaml ./app
在 Kubernetes 模式下,必须通过配置组件提供配置。使用与上面相同的配置,通过 kubectl 应用它:
kubectl apply -f previewConfig.yaml
然后可以通过修改应用程序的配置,通过 dapr.io/config 元素引用该特定的配置组件,从而在任何应用程序中引用此配置组件。例如:
apiVersion: apps/v1
kind: Deployment
metadata:
name: nodeapp
labels:
app: node
spec:
replicas: 1
selector:
matchLabels:
app: node
template:
metadata:
labels:
app: node
annotations:
dapr.io/enabled: "true"
dapr.io/app-id: "nodeapp"
dapr.io/app-port: "3000"
dapr.io/config: "featureconfig"
spec:
containers:
- name: node
image: dapriosamples/hello-k8s-node:latest
ports:
- containerPort: 3000
imagePullPolicy: Always