运行 CLI 命令参考

关于运行 CLI 命令的详细信息

描述

运行 Dapr，并且可以选择同时运行您的应用程序。完整的 daprd 参数、CLI 参数和 Kubernetes 注释的对比列表可以在这里找到。

支持的平台

用法

dapr run [flags] [command]

标志

名称环境变量默认值描述
--app-id, -aAPP_ID您的应用程序的 ID，用于服务发现。不能包含点。
--app-max-concurrencyunlimited应用程序的并发级别；默认是无限制
--app-port, -pAPP_PORT您的应用程序正在监听的端口
--app-protocol, -PhttpDapr 用于与应用程序通信的协议。有效值为：http、grpc、https（带 TLS 的 HTTP）、grpcs（带 TLS 的 gRPC）、h2c（HTTP/2 明文）
--resources-path, -dLinux/Mac: $HOME/.dapr/components
Windows: %USERPROFILE%\.dapr\components		资源目录的路径。如果您已将资源组织到多个文件夹中（例如，一个文件夹中的组件，另一个文件夹中的弹性策略），您可以定义多个资源路径。请参见下面的示例。
--app-channel-address127.0.0.1应用程序监听的网络地址
--runtime-pathDapr 运行时安装路径
--config, -cLinux/Mac: $HOME/.dapr/config.yaml
Windows: %USERPROFILE%\.dapr\config.yaml		Dapr 配置文件
--dapr-grpc-port, -GDAPR_GRPC_PORT50001Dapr 监听的 gRPC 端口
--dapr-internal-grpc-port, -I50002Dapr 内部 API 监听的 gRPC 端口。用于开发期间解决 mDNS 缓存导致的服务调用失败问题，或配置防火墙后面的 Dapr sidecar。可以是大于 1024 的任何值，并且每个应用程序必须不同。
--dapr-http-port, -HDAPR_HTTP_PORT3500Dapr 监听的 HTTP 端口
--enable-profilingfalse通过 HTTP 端点启用 “pprof” 性能分析
--help, -h打印帮助信息
--run-file, -fLinux/MacOS: $HOME/.dapr/dapr.yaml使用多应用程序运行模板文件同时运行多个应用程序。目前处于alpha阶段，仅在 Linux/MacOS 上可用
--image使用自定义 Docker 镜像。格式为 Docker Hub 的 repository/image，或自定义注册表的 example.com/repository/image。
--log-levelinfo日志详细程度。有效值为：debug、info、warn、error、fatal 或 panic
--enable-api-loggingfalse启用从应用程序到 Dapr 的所有 API 调用的日志记录
--metrics-portDAPR_METRICS_PORT9090Dapr 发送其指标信息的端口
--profile-port7777配置文件服务器监听的端口
--placement-host-addressLinux/Mac: $HOME/.dapr/components
Windows: %USERPROFILE%\.dapr\components		在 Docker 网络中的任何容器中运行。使用 <hostname> 或 <hostname>:<port>。如果省略端口，默认值为：
  • Linux/MacOS: 50005
  • Windows: 6050
--scheduler-host-addressLinux/Mac: $HOME/.dapr/components
Windows: %USERPROFILE%\.dapr\components		在 Docker 网络中的任何容器中运行。使用 <hostname> 或 <hostname>:<port>。如果省略端口，默认值为：
  • Linux/MacOS: 50006
  • Windows: 6060
--enable-app-health-checkfalse使用 app-protocol 定义的协议启用应用程序的健康检查
--app-health-check-path用于健康检查的路径；仅限 HTTP
--app-health-probe-interval以秒为单位探测应用程序健康状况的间隔
--app-health-probe-timeout应用程序健康探测的超时时间，以毫秒为单位
--app-health-threshold应用程序被视为不健康的连续失败次数
--unix-domain-socket, -uUnix 域套接字目录挂载的路径。如果指定，与 Dapr sidecar 的通信使用 Unix 域套接字，与使用 TCP 端口相比，具有更低的延迟和更高的吞吐量。在 Windows 上不可用。
--dapr-http-max-request-size4请求体的最大大小，以 MB 为单位。
--dapr-http-read-buffer-size4HTTP 读取缓冲区的最大大小，以 KB 为单位。这也限制了 HTTP 头的最大大小。默认值为 4 KB
--kubernetes, -k在 Kubernetes 上运行 Dapr，并用于 Kubernetes 上的多应用程序运行模板文件。
--components-path, -dLinux/Mac: $HOME/.dapr/components
Windows: %USERPROFILE%\.dapr\components		已弃用，建议使用 --resources-path

示例

# 运行一个 .NET 应用程序
dapr run --app-id myapp --app-port 5000 -- dotnet run

# 使用 Unix 域套接字运行一个 .Net 应用程序
dapr run --app-id myapp --app-port 5000 --unix-domain-socket /tmp -- dotnet run

# 运行一个 Java 应用程序
dapr run --app-id myapp -- java -jar myapp.jar

# 运行一个监听端口 3000 的 NodeJs 应用程序
dapr run --app-id myapp --app-port 3000 -- node myapp.js

# 运行一个 Python 应用程序
dapr run --app-id myapp -- python myapp.py

# 仅运行 sidecar
dapr run --app-id myapp

# 运行一个用 Go 编写的 gRPC 应用程序（监听端口 3000）
dapr run --app-id myapp --app-port 5000 --app-protocol grpc -- go run main.go

# 运行一个启用 API 日志记录的监听端口 3000 的 NodeJs 应用程序
dapr run --app-id myapp --app-port 3000 --enable-api-logging  -- node myapp.js

# 传递多个资源路径
dapr run --app-id myapp --resources-path path1 --resources-path path2

# 运行多应用程序运行模板文件
dapr run -f dapr.yaml

# 在 Kubernetes 上运行多应用程序运行模板文件
dapr run -k -f dapr.yaml