one configure

管理部署、环境变量和镜像仓库所需的本机连接与偏好设置。

one configure 管理本机连接和偏好设置，不是工作区业务配置。密钥只保存在本机，不写入工作区或 Git。

用法

one configure
one configure add
one configure add <pair> --profile <name> [backend flags...] [--use]
one configure list [pair]
one configure current [pair]
one configure show <pair> --profile <name> [--reveal]
one configure use <pair> --profile <name>
one configure remove <pair> --profile <name>
one configure locale [auto|zh-CN|en-US]
one configure open

没有连接时，无参 one configure 进入建立连接向导；已有连接时显示简洁概览。show / use / remove 在终端可直接选择已有连接；脚本仍显式传 <pair> 和 --profile。

交互模式

本地人工配置推荐用交互式向导：

one configure
one configure add

向导先选择要连接的服务，再询问连接名称和该服务需要的字段。自动化命令中继续使用稳定服务 ID；敏感字段使用密码式输入。

脚本和 CI 不应等待交互式向导；请显式传服务 ID、连接名称（--profile）和服务参数。

支持的 pair

pair	用途
`env/infisical`	Infisical site URL + Universal Auth client id / secret
`deploy/aliyun-oss`	阿里云 OSS
`deploy/tencent-cos`	腾讯云 COS
`deploy/aws-s3`	AWS S3
`deploy/minio`	自部署 MinIO
`deploy/rustfs`	自部署 RustFS
`deploy/r2`	Cloudflare R2
`deploy/kustomize`	Kubernetes kubeconfig + context
`deploy/vercel`	Vercel API token
`deploy/cloudflare`	Cloudflare API token
`deploy/edgeone`	Tencent EdgeOne Pages API token
`container/docker`	通用 Docker registry host、namespace、username、password
`container/dockerhub`	Docker Hub username、password/token、namespace
`container/ghcr`	GitHub Container Registry username、PAT、namespace
`container/acr`	阿里云 ACR region、username、password/token、namespace

env/dotenv 不需要 profile；它用于本地 .env 工作流。S3 兼容 deploy 后端共用一组 profile 字段，但每个供应商都有自己的 backend ID。

常用示例

one configure add env/infisical --profile work \
  --client-id "$INFISICAL_CLIENT_ID" \
  --client-secret "$INFISICAL_CLIENT_SECRET" \
  --use

one configure add deploy/aws-s3 --profile web-prod \
  --region us-east-1 \
  --access-key-id "$AWS_ACCESS_KEY_ID" \
  --access-key-secret "$AWS_SECRET_ACCESS_KEY" \
  --use

one configure add deploy/kustomize --profile prod-k8s \
  --kubeconfig ~/.kube/config \
  --kubeconfig-context prod \
  --use

one configure add container/ghcr --profile ghcr \
  --namespace "$GITHUB_USER" \
  --username "$GITHUB_USER" \
  --password "$GHCR_PAT" \
  --use

profile 解析顺序

命令实际使用 profile 时按这个顺序找：

命令行 --profile <name>
profile-bindings.json 中的 Project + environment 绑定
profile-bindings.json 中的 Workspace + environment 绑定
config.json#workspaces 中的旧 Project 绑定
config.json#workspaces 中的旧 Workspace 绑定
~/.config/one/config.json 里对应 domain/backend.default

环境绑定按规范化 Workspace root、environment 和 (domain, backend) 定位，只保存 Profile 名。Dashboard UI 通过 ?env= 只提供 dev、preview、prod；核心/API 也接受其他工作流传入的安全自定义 ID。全局 Settings 中的 Profile CRUD 不按环境分区。空环境保持旧解析链。

one.manifest.json 永远不保存本机 Profile 名。one configure use ... --workspace 和 --project 作为旧绑定仍兼容；需要每个环境不同选择时使用 one serve。

同名 profile 可以存在于不同 backend 下，例如 deploy/aws-s3 和 deploy/kustomize 都可以有 prod。

存储位置

~/.config/one/
├── config.json             # Profile 非敏感字段、default、旧绑定
├── credentials.json        # 敏感字段：clientSecret、accessKeySecret、password
├── profile-bindings.json   # v1：规范化 root + environment -> Profile 名
└── cache/                  # 短期 token 缓存

三个 JSON 文件都是 mode 0600 的机器本地文件；profile-bindings.json 只含名字。它们都不会修改或升级 one.manifest.json。show 默认掩码敏感字段，只有 show --reveal 会输出明文。

输出 schema

命令	schema
`add`	`one-cli/configure-add/v1`
`list <pair>`	`one-cli/configure-list/v1`
`list`	`one-cli/configure-list-all/v1`
`current <pair>`	`one-cli/configure-current/v1`
`current`	`one-cli/configure-current-all/v1`
`show`	`one-cli/configure-show/v1`
`use`	`one-cli/configure-use/v1`
`remove`	`one-cli/configure-remove/v1`

错误恢复

错误码	处理
`PROFILE_NONE_CONFIGURED`	先跑 `one configure add <pair> --profile <name> --use`
`PROFILE_NOT_FOUND`	`one configure list <pair>` 看本机已有 profile
`PROFILE_BACKEND_INVALID`	确认 profile 所在 backend 与目标 project 的 deploy/container backend 一致
`PROFILE_FILE_INVALID`	修复错误 context 指向的文件（`config.json`、`credentials.json` 或 `profile-bindings.json`）
`PROFILE_VERSION_UNSUPPORTED`	升级 One CLI，或只重建不兼容的机器本地文件

完整码表：错误码大全。

进一步阅读

one serve — 编辑 Profile 并选择环境感知的本机绑定
one env — 使用 env/infisical profile
one deploy — 使用 deploy profile
one container — 使用 container profile