关于 Doppler CLI
Doppler CLI 是一个命令行工具,可从 Doppler 密钥管理服务中获取密钥并将其注入本地命令执行、应用程序启动和 CI/CD 工作流。支持多项目和多配置管理,简化开发和部署环节的环境变量处理。
主要功能
- 01从 Doppler 服务获取密钥并注入命令执行环境
- 02在本地开发中选择不同项目和配置
- 03为 CI/CD 管道提供认证和密钥管理
适用场景
- 01开发本地应用时安全访问 API 密钥和数据库凭据
- 02在持续部署流程中自动注入环境特定的密钥
- 03跨多个开发环境管理和切换不同的配置集
安装
选择你的系统或包管理器,复制命令到终端运行。
安装完成后运行doppler --version确认安装成功。
命令示例
常用命令按使用顺序排列。
详细介绍
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,并确保所有位置都已更新。