doppler
Setup
macOS:
CODEBLOCK0
Or install from https://docs.doppler.com/docs/install-cli for other platforms.
Verify installation:
CODEBLOCK1
Always use --json flag when calling commands programmatically.
Authentication
CODEBLOCK2
Resources
Setup
| Command | Description |
|---|
| INLINECODE1 | Configure Doppler for current directory |
| INLINECODE2 |
Configure with specific project and config |
Secrets
| Command | Description |
|---|
| INLINECODE3 | List all secrets in current config |
| INLINECODE4 |
Get a specific secret value |
|
doppler secrets get KEY --plain | Get plain text value (no formatting) |
|
doppler secrets set KEY=value | Set a secret |
|
doppler secrets set KEY1=val1 KEY2=val2 | Set multiple secrets |
|
doppler secrets delete KEY | Delete a secret |
|
doppler secrets download --no-file --format env | Download secrets as .env format |
|
doppler secrets download --no-file --format json | Download secrets as JSON |
Run
| Command | Description |
|---|
| INLINECODE11 | Run a command with secrets injected as env vars |
| INLINECODE12 |
Run npm start with secrets injected |
|
doppler run --command "echo \$KEY" | Run shell command with secrets |
Projects
| Command | Description |
|---|
| INLINECODE14 | List all projects |
| INLINECODE15 |
Create a new project |
|
doppler projects delete <name> | Delete a project |
|
doppler projects get <name> | Get project details |
Configs
| Command | Description |
|---|
| INLINECODE18 | List all configs in current project |
| INLINECODE19 |
Create a new config |
|
doppler configs delete --config <name> --yes | Delete a config |
|
doppler configs clone --config <source> --name <target> | Clone a config |
Environments
| Command | Description |
|---|
| INLINECODE22 | List all environments |
| INLINECODE23 |
Create an environment |
|
doppler environments delete <slug> | Delete an environment |
Activity
| Command | Description |
|---|
| INLINECODE25 | View recent activity log |
| INLINECODE26 |
View last 20 activity entries |
Global Flags
| Flag | Description |
|---|
| INLINECODE27 | Output result as JSON |
| INLINECODE28 |
Specify project |
|
--config <name> | Specify config |
|
--token <token> | Use service token for auth |
|
--no-color | Disable colored output |
doppler
安装
macOS:
bash
brew install dopplerhq/cli/doppler
或从 https://docs.doppler.com/docs/install-cli 安装其他平台版本。
验证安装:
bash
doppler --version
以编程方式调用命令时,始终使用 --json 标志。
身份验证
bash
doppler login
资源
设置
| 命令 | 描述 |
|---|
| doppler setup | 为当前目录配置 Doppler |
| doppler setup --project <名称> --config <配置> |
使用指定项目和配置进行设置 |
密钥
| 命令 | 描述 |
|---|
| doppler secrets | 列出当前配置中的所有密钥 |
| doppler secrets get KEY |
获取特定密钥的值 |
| doppler secrets get KEY --plain | 获取纯文本值(无格式) |
| doppler secrets set KEY=value | 设置一个密钥 |
| doppler secrets set KEY1=val1 KEY2=val2 | 设置多个密钥 |
| doppler secrets delete KEY | 删除一个密钥 |
| doppler secrets download --no-file --format env | 以 .env 格式下载密钥 |
| doppler secrets download --no-file --format json | 以 JSON 格式下载密钥 |
运行
| 命令 | 描述 |
|---|
| doppler run -- <命令> | 运行命令,密钥作为环境变量注入 |
| doppler run -- npm start |
运行 npm start,密钥自动注入 |
| doppler run --command echo \$KEY | 运行包含密钥的 shell 命令 |
项目
| 命令 | 描述 |
|---|
| doppler projects | 列出所有项目 |
| doppler projects create <名称> |
创建新项目 |
| doppler projects delete <名称> | 删除项目 |
| doppler projects get <名称> | 获取项目详情 |
配置
| 命令 | 描述 |
|---|
| doppler configs | 列出当前项目中的所有配置 |
| doppler configs create --name <名称> --environment <环境> |
创建新配置 |
| doppler configs delete --config <名称> --yes | 删除配置 |
| doppler configs clone --config <源> --name <目标> | 克隆配置 |
环境
| 命令 | 描述 |
|---|
| doppler environments | 列出所有环境 |
| doppler environments create --name <名称> --slug <标识> |
创建环境 |
| doppler environments delete <标识> | 删除环境 |
活动
| 命令 | 描述 |
|---|
| doppler activity | 查看最近活动日志 |
| doppler activity --number 20 |
查看最近 20 条活动记录 |
全局标志
| 标志 | 描述 |
|---|
| --json | 以 JSON 格式输出结果 |
| --project <名称> |
指定项目 |
| --config <名称> | 指定配置 |
| --token <令牌> | 使用服务令牌进行身份验证 |
| --no-color | 禁用彩色输出 |