如何使用多应用运行模板文件

解构多应用运行模板文件及其属性

注意

Kubernetes 的多应用运行目前是预览功能。

Multi-App Run模板文件是一个YAML文件，您可以使用它同时运行多个应用程序。 在本指南中，您将学习如何：

• 使用多应用程序模板
• 查看已启动的应用程序
• 停止多应用程序模板
• 结构化多应用程序模板文件

使用多应用程序模板

您可以以以下两种方式之一使用多应用程序模板文件：

通过提供目录路径执行

当您提供一个目录路径时，CLI将尝试在该目录中默认命名为dapr.yaml的多应用运行模板文件。 如果文件未找到，CLI 将返回一个错误。

执行以下命令行工具命令来读取默认命名为 dapr.yaml 的多应用运行模板文件：

• Self-hosted
• Kubernetes

# the template file needs to be called `dapr.yaml` by default if a directory path is given
dapr run -f <dir_path>

dapr run -f -k <dir_path>

通过提供文件路径执行

如果多应用运行模板文件的名称不是dapr.yaml，那么您可以提供相对或绝对文件路径给命令：

• Self-hosted
• Kubernetes

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

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

查看已启动的应用程序

一旦多应用程序模板运行起来，您可以使用以下命令查看已启动的应用程序：

dapr list

停止多应用程序模板

随时使用以下任一命令停止多应用运行模板：

• Self-hosted
• Kubernetes

# the template file needs to be called `dapr.yaml` by default if a directory path is given
dapr stop -f <dir_path>

或者:

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

# the template file needs to be called `dapr.yaml` by default if a directory path is given
dapr stop -f -k

或者:

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

模板文件结构

多应用运行模板文件可以包括以下属性。 下面是一个示例模板，显示了配置了一些属性的两个应用程序。

• Self-hosted
• Kubernetes

version: 1
common: # optional section for variables shared across apps
  resourcesPath: ./app/components # any dapr resources to be shared across apps
  env:  # any environment variable shared across apps
    DEBUG: true
apps:
  - appID: webapp # optional
    appDirPath: .dapr/webapp/ # REQUIRED
    resourcesPath: .dapr/resources # deprecated
    resourcesPaths: .dapr/resources # comma separated resources paths. (optional) can be left to default value by convention.
    appChannelAddress: 127.0.0.1 # network address where the app listens on. (optional) can be left to default value by convention.
    configFilePath: .dapr/config.yaml # (optional) can be default by convention too, ignore if file is not found.
    appProtocol: http
    appPort: 8080
    appHealthCheckPath: "/healthz"
    command: ["python3", "app.py"]
    appLogDestination: file # (optional), can be file, console or fileAndConsole. default is fileAndConsole.
    daprdLogDestination: file # (optional), can be file, console or fileAndConsole. default is file.
  - appID: backend # optional
    appDirPath: .dapr/backend/ # REQUIRED
    appProtocol: grpc
    appPort: 3000
    unixDomainSocket: "/tmp/test-socket"
    env:
      DEBUG: false
    command: ["./backend"]

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

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

version: 1
common: # optional section for variables shared across apps
  env:  # any environment variable shared across apps
    DEBUG: true
apps:
  - appID: webapp # optional
    appDirPath: .dapr/webapp/ # REQUIRED
    appChannelAddress: 127.0.0.1 # network address where the app listens on. (optional) can be left to default value by convention.
    appProtocol: http
    appPort: 8080
    appHealthCheckPath: "/healthz"
    appLogDestination: file # (optional), can be file, console or fileAndConsole. default is fileAndConsole.
    daprdLogDestination: file # (optional), can be file, console or fileAndConsole. default is file.
    containerImage: ghcr.io/dapr/samples/hello-k8s-node:latest # (optional) URI of the container image to be used when deploying to Kubernetes dev/test environment.
    createService: true # (optional) Create a Kubernetes service for the application when deploying to dev/test environment.
  - appID: backend # optional
    appDirPath: .dapr/backend/ # REQUIRED
    appProtocol: grpc
    appPort: 3000
    unixDomainSocket: "/tmp/test-socket"
    env:
      DEBUG: false

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

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

模板属性

• Self-hosted
• Kubernetes

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

下一步

观看此视频以了解多应用运行的概述:

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

下一步

观看此视频以了解 Kubernetes 中的多应用程序运行概述: