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

安装 Dapr CLI

安装 Dapr CLI 作为运行 Dapr 相关任务的主要工具

您将使用 Dapr CLI 作为各种 Dapr 相关任务的主要工具。 您可以使用它来：

  • 使用 Dapr sidecar 运行应用程序。
  • 查看sidecar日志。
  • 列出正在运行的服务。
  • 运行 Dapr 仪表板。

Dapr CLI 同时支持 自托管 和 Kubernetes 环境。

第 1 步：安装 Dapr CLI


从终端安装

将最新的 Linux Dapr CLI 安装到 /usr/local/bin：

wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | /bin/bash

安装时不使用 sudo

如果您无法访问 sudo 命令或您的用户名不在 sudoers 文件中，您可以通过 DAPR_INSTALL_DIR 环境变量来安装 Dapr 到另一个目录。

wget -q https://raw.githubusercontent.com/dapr/cli/master/install/install.sh -O - | DAPR_INSTALL_DIR="$HOME/dapr" /bin/bash

从命令提示安装

将最新的 windows Dapr cli 安装到 C:\dapr 并将此目录添加到 User PATH 环境变量中：

powershell -Command "iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1 | iex"

安装时没有管理权限

如果您没有管理员权限，您可以通过 DAPR_INSTALL_DIR 环境变量安装 Dapr 到备用目录。

$script=iwr -useb https://raw.githubusercontent.com/dapr/cli/master/install/install.ps1; $block=[ScriptBlock]::Create($script); invoke-command -ScriptBlock $block -ArgumentList "", "$HOME/dapr"

从终端安装

将最新的 Darwin Dapr CLI 安装到 /usr/local/bin：

curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | /bin/bash

对于 ARM64 Mac：

ARM64 Macs 支持作为预览功能提供。 当从终端安装时，一旦有原生ARM64二进制文件就会下载。 对于较旧的版本，将下载 AMD64 二进制文件，这些二进制文件必须在启用 Rosetta2 模拟器的情况下运行。

要安装 Rosetta 模拟器：

softwareupdate --install-rosetta

从 Homebrew 安装

Install via Homebrew:

brew install dapr/tap/dapr-cli

对于 ARM64 Mac：

ARM64 架构的 Mac 系统只支持 Homebrew 3.0 和更高版本。 请更新 Homebrew 到 3.0.0 或更高版本，然后运行下面的命令：

arch -arm64 brew install dapr/tap/dapr-cli

安装时不使用 sudo

如果您无法访问 sudo 命令或您的用户名不在 sudoers 文件中，您可以通过 DAPR_INSTALL_DIR 环境变量来安装 Dapr 到另一个目录。

curl -fsSL https://raw.githubusercontent.com/dapr/cli/master/install/install.sh | DAPR_INSTALL_DIR="$HOME/dapr" /bin/bash

每次发行的Dapr CLI包括各种操作系统和架构。 您可以手动下载并安装这些二进制版本。

  1. 从最新的 Dapr Releases 中下载所需的 Dapr CLI.
  2. 解压缩 (例如，dapr_linux_amd64.tar.gz, dapr_windows_amd64.zip).
  3. 将其移动到你想要的位置。
    • 对于 Linux/MacOS，我们建议 /usr/local/bin。
    • 对于Windows，创建一个目录并将其添加到系统PATH。 例如:
      • 创建一个名为 C:\dapr的目录。
      • 通过编辑系统环境变量，将新创建的目录添加到用户 PATH。

步骤 2：验证安装

通过重新启动您的终端/命令提示和运行以下操作来验证CLI：

dapr

输出:

         __
    ____/ /___ _____  _____
   / __  / __ '/ __ \/ ___/
  / /_/ / /_/ / /_/ / /
  \__,_/\__,_/ .___/_/
              /_/

===============================
Distributed Application Runtime

Usage:
  dapr [command]

Available Commands:
  completion     Generates shell completion scripts
  components     List all Dapr components. Supported platforms: Kubernetes
  configurations List all Dapr configurations. Supported platforms: Kubernetes
  dashboard      Start Dapr dashboard. Supported platforms: Kubernetes and self-hosted
  help           Help about any command
  init           Install Dapr on supported hosting platforms. Supported platforms: Kubernetes and self-hosted
  invoke         Invoke a method on a given Dapr application. Supported platforms: Self-hosted
  list           List all Dapr instances. Supported platforms: Kubernetes and self-hosted
  logs           Get Dapr sidecar logs for an application. Supported platforms: Kubernetes
  mtls           Check if mTLS is enabled. Supported platforms: Kubernetes
  publish        Publish a pub-sub event. Supported platforms: Self-hosted
  run            Run Dapr and (optionally) your application side by side. Supported platforms: Self-hosted
  status         Show the health status of Dapr services. Supported platforms: Kubernetes
  stop           Stop Dapr instances and their associated apps.   Supported platforms: Self-hosted
  uninstall      Uninstall Dapr runtime. Supported platforms: Kubernetes and self-hosted
  upgrade        Upgrades a Dapr control plane installation in a cluster. Supported platforms: Kubernetes

Flags:
  -h, --help      help for dapr
  -v, --version   version for dapr

Use "dapr [command] --help" for more information about a command.
下一步: 初始化 Dapr >>