mcpField
D
Doppler CLI

Doppler CLI

官方Agent-ready
docs.doppler.com开发者工具400doppler6 天前更新
代码仓库访问官网

关于 Doppler CLI

Doppler CLI 是一个命令行工具,可从 Doppler 密钥管理服务中获取密钥并将其注入本地命令执行、应用程序启动和 CI/CD 工作流。支持多项目和多配置管理,简化开发和部署环节的环境变量处理。

主要功能

  1. 01从 Doppler 服务获取密钥并注入命令执行环境
  2. 02在本地开发中选择不同项目和配置
  3. 03为 CI/CD 管道提供认证和密钥管理

适用场景

  1. 01开发本地应用时安全访问 API 密钥和数据库凭据
  2. 02在持续部署流程中自动注入环境特定的密钥
  3. 03跨多个开发环境管理和切换不同的配置集

安装

选择你的系统或包管理器,复制命令到终端运行。

$
brew install dopplerhq/cli/doppler

安装完成后运行doppler --version确认安装成功。

命令示例

常用命令按使用顺序排列。

01
doppler login
02
doppler setup
03
doppler run -- npm start

详细介绍

Doppler CLI

Doppler CLI 是用于与 Doppler 密钥和配置交互的官方工具。

你可以:

  • 管理密钥、项目和环境
  • 将密钥注入环境后运行应用程序
  • 查看活动记录和审计日志

安装

Doppler CLI 可通过多种常用包管理器安装。也可以通过 shell 脚本、GitHub Action 安装,或下载为独立二进制文件。

如需了解更多信息,包括验证二进制文件签名的说明,请参阅 Install 页面。

macOS

建议使用 brew:

$ brew install dopplerhq/cli/doppler
$ doppler --version

更新方法:

$ brew upgrade doppler

如需了解不使用 brew 的安装方式,请参阅 Install 页面。

Windows

建议使用 winget:

$ winget install doppler
$ doppler --version

更新方法:

$ winget upgrade doppler

如需了解其他选项,请参阅 Install 页面。

Shell 脚本

此选项建议用于 CI 作业以及不会使用包管理器更新的其他环境。

$ (curl -Ls --tlsv1.2 --proto "=https" --retry 3 https://cli.doppler.com/install.sh || wget -t 3 -qO- https://cli.doppler.com/install.sh) | sh

如需了解更多信息,请参阅 Install 页面。

Linux

请参阅 Install 页面了解安装说明。

Docker

请参阅 Install 页面了解安装说明。

GitHub Action

你可以通过 GitHub Action 安装最新版 CLI。如需了解更多信息,请参阅 cli-action 仓库。

用法

设置只需一分钟(确实如此)。你需要授权 CLI 访问你的 Doppler 工作区,然后选择项目和配置。

$ doppler login                     # generate auth credentials
$ doppler setup                     # select your project and config
# optional
$ doppler configure --all           # view local configuration

默认情况下,doppler login 会将身份验证令牌的作用范围限定为根目录(--scope=/)。这意味着任何子目录中的项目都可以使用 Doppler CLI 访问该令牌。若要限制此范围,请在登录时指定 scope 标志:doppler login --scope=./ 或 doppler login --scope ~/projects/backend。

设置(即 doppler setup)会将所选项目和配置的作用范围限定为当前目录(--scope=./)。你也可以使用 scope 标志修改此范围。运行 doppler help 了解更多信息。

Go 版本

本项目在多个位置定义了 Go 版本。如果要更新 Go 版本,请搜索 GO_VERSION_DEF,并确保所有位置都已更新。

评论

支持 Markdown