校对:soup
官方CLI为 信封管理器 - 发展小组的安全环境变量管理.
安装
# npm
npm install -g @envmanager-cli/cli
# Homebrew (macOS/Linux)
brew install shintaii/tap/envmanager
快速启动
# Login to EnvManager
envmanager login
# Pull environment variables
envmanager pull
# Push local changes
envmanager push
# Compare local vs remote
envmanager diff
图标
| 命令 | 说明 |
|---|---|
login | 使用 EnvManager 认证 |
logout | 清除存储的证书 |
whoami | 显示当前用户信息 |
pull | 下载变量到.env 文件 |
push | 从.env 文件上传变量 |
set | 直接设置一个或多个变量( N)KEY=VALUE(中文(简体) ) |
diff | 比较本地变量和远程变量 |
list | 列出项目、环境和变量 |
run | 运行带有注入变量的命令( 数值从未打印) |
service | 管理服务service create <name>(中文(简体) ) |
config | 管理 CLI 配置 |
dev | 开发期间实时同步 |
template | 管理.env 模板 |
validate | 对照计划进行验证 |
completion | 生成 shell 补全脚本 |
debug | 收集诊断信息以排除故障 |
贝壳补全
启用命令、 选项以及您实际工程/ 环境名称的标签补全 .
家畜用户
如果你通过Homebrew安装并拥有 已配置 shell 补全自动工作.
npm 用户
在您的外壳配置中添加其中之一 :
巴许 (单位:千美元)~/.bashrc 或者说 ~/.bash_profile:
eval "$(envmanager completion bash)"
日语 (单位:千美元)~/.zshrc:
eval "$(envmanager completion zsh)"
鱼数字 :
envmanager completion fish > ~/.config/fish/completions/envmanager.fish
然后重新启动你的外壳或运行 source ~/.bashrc (或等同为一.
使用友好身份标识
项目和环境有友好的ID(例如: #1, (中文(简体) ), #2),比UUID更容易使用.
# List projects to see their IDs
envmanager list projects
# #1 my-api (My Organization)
# #2 my-webapp (My Organization)
# Use friendly ID instead of UUID
envmanager pull --project 1 --environment development
# Also works with names
envmanager pull --project my-api --environment production
默认环境
何时 -e 编号 : --environment ,默认为 development。您可以在 envmanager.json数字 :
{
"environment": "staging"
}
多个组织
如果你属于多个组织,CLI在可能时会从您的项目中自动发现组织. 使用 --org 明确说明:
envmanager pull --org "My Company" --project 1 --environment staging
单组织用户不需要 --org - 是自动选择的.
CI/CD 使用量
设定 ENVMANAGER_API_KEY 非交互式认证的环境变量 :
# GitHub Actions example
- name: Pull env vars
env:
ENVMANAGER_API_KEY: ${{ secrets.ENVMANAGER_API_KEY }}
run: envmanager pull --org "My Company" --project 1 --env production
注:当使用 API 密钥时, --org 必须与创建的 API 密钥的组织匹配.
遥测
CLI 收集 : 匿名用途分析 这样我们就能分辨出是否具有
实际为人服务(例如: pull 安装后成功)。 我们发送
命令名称、成功/失败、错误类别、计数和持续时间.
我们从不发送 变量名称、值、文件内容、文件路径,或 组织/项目/环境名称.
当您将 CLI 指向自主机或本地 API 时, 它会自动被禁用 终点 选择退出 :
envmanager config telemetry off # persist the choice
envmanager config telemetry status # check current state
# or via environment variables
export ENVMANAGER_TELEMETRY=0
export DO_NOT_TRACK=1 # honored too
文档
备有文件全文 dev/docs/cli (英语)
支助
许可证
专有-参见LICENSE文件. 此软件需要激活EnvManager订阅.