Multi-App Run 模板文件

当您执行 dapr run -k -f . 或 dapr run -k -f dapr.yaml 时，dapr.yaml Multi-App Run 模板文件中定义的应用程序将在 Kubernetes 默认命名空间中启动。

注意： 目前，Multi-App Run 模板只能在默认 Kubernetes 命名空间中启动应用程序。

Kubernetes 的必要默认服务和部署定义会在 .dapr/deploy 文件夹中为 dapr.yaml 模板中的每个应用程序生成。

如果在 dapr.yaml 模板中为某个应用程序将 createService 字段设置为 true，则会在该应用程序的 .dapr/deploy 文件夹中生成 service.yaml 文件。

否则，只为设置了 containerImage 字段的每个应用程序生成 deployment.yaml 文件。

service.yaml 和 deployment.yaml 文件用于在 Kubernetes 中的 default 命名空间中部署应用程序。此功能专门针对在 Kubernetes 中的开发/测试环境中运行多个应用程序。

您可以使用任何首选名称来命名模板文件，而不是使用默认名称。例如：

dapr run -k -f ./<your-preferred-file-name>.yaml

以下示例包括一些您可以为应用程序自定义的模板属性。在该示例中，您可以同时启动 2 个应用程序，其应用 ID 为 nodeapp 和 pythonapp。

version: 1
common:
apps:
  - appID: nodeapp
    appDirPath: ./nodeapp/
    appPort: 3000
    containerImage: ghcr.io/dapr/samples/hello-k8s-node:latest
    containerImagePullPolicy: Always
    createService: true
    env:
      APP_PORT: 3000
  - appID: pythonapp
    appDirPath: ./pythonapp/
    containerImage: ghcr.io/dapr/samples/hello-k8s-python:latest

注意：

• 如果未指定 containerImage 字段，dapr run -k -f 会产生错误。
• containerImagePullPolicy 表示始终为此应用程序下载新的容器镜像。
• createService 字段在 Kubernetes 中定义一个基本服务（ClusterIP 或 LoadBalancer），该服务针对模板中指定的 --app-port。如果未指定 createService，则应用程序无法从集群外部访问。

有关更深入的示例和模板属性的解释，请参阅 多应用模板。

日志

运行模板为每个应用程序及其关联的 daprd 进程提供两个日志目标字段：

1. appLogDestination：此字段配置应用程序的日志目标。可能的值为 console、file 和 fileAndConsole。默认值为 fileAndConsole，其中应用程序日志默认写入控制台和文件。

2. daprdLogDestination：此字段配置 daprd 进程的日志目标。可能的值为 console、file 和 fileAndConsole。默认值为 file，其中 daprd 日志默认写入文件。

日志文件格式

应用程序和 daprd 的日志捕获在单独的文件中。这些日志文件在应用程序目录（模板中的 appDirPath）下的 .dapr/logs 目录下自动创建。这些日志文件名遵循以下模式：

• <appID>_app_<timestamp>.log（app 日志的文件名格式）
• <appID>_daprd_<timestamp>.log（daprd 日志的文件名格式）

即使您决定将资源文件夹重命名为 .dapr 以外的名称，日志文件也只会写入 .dapr/logs 文件夹（在应用程序目录中创建）。

观看演示

观看 此视频了解 Kubernetes 中 Multi-App Run 的概述：

# 如果给定目录路径，模板文件需要默认命名为 `dapr.yaml`

dapr stop -f <dir_path> -k

或：

dapr stop -f ./path/to/<your-preferred-file-name>.yaml -k 

version: 1
common: # 可选部分，用于在应用程序之间共享的变量
  env:  # 任何在应用程序之间共享的环境变量
    DEBUG: true
apps:
  - appID: webapp # 可选
    appDirPath: .dapr/webapp/ # 必需
    appChannelAddress: 127.0.0.1 # 应用程序监听的网络地址。（可选）可按约定保留为默认值。
    appProtocol: http
    appPort: 8080
    appHealthCheckPath: "/healthz"
    appLogDestination: file # （可选），可以是 file、console 或 fileAndConsole。默认为 fileAndConsole。
    daprdLogDestination: file # （可选），可以是 file、console 或 fileAndConsole。默认为 file。
    containerImage: ghcr.io/dapr/samples/hello-k8s-node:latest # （可选）部署到 Kubernetes 开发/测试环境时要使用的容器镜像 URI。
    containerImagePullPolicy: IfNotPresent # （可选），如果本地不存在容器镜像则下载，否则使用本地镜像。
    createService: true # （可选）部署到开发/测试环境时为应用程序创建 Kubernetes 服务。
  - appID: backend # 可选
    appDirPath: .dapr/backend/ # 必需
    appProtocol: grpc
    appPort: 3000
    unixDomainSocket: "/tmp/test-socket"
    env:
      DEBUG: false

模板文件中所有路径适用以下规则：

• 如果路径是绝对路径，则按原样使用。
• apps 部分下的 appDirPath 应相对于模板文件路径提供。
• app 部分下的所有相对路径应相对于 appDirPath 提供。

多应用运行模板的属性与 dapr run -k CLI 标志一致，在 CLI 参考文档中列出。

后续步骤

观看此视频了解 Kubernetes 中多应用运行的概述：