用途:执行 Medusa Cloud CLI(mcloud)的认证与上下文命令,包括 login、logout、whoami、use、version、signup,用于初始化 CLI、切换账号及在执行状态变更命令前验证身份与作用域。
主要能力:whoami 显示已认证用户、认证方式及当前上下文(组织、项目、环境),支持 --json;use 设置当前组织、项目、环境,后续命令可省略相应参数,支持 -o/--organization、-p/--project、-e/--environment、--clear、--json;version 打印 CLI 版本与平台信息;login 通过浏览器认证;logout 移除已存凭据;signup 创建新账号。
使用方式:建议在变更命令前验证:mcloud whoami --json | jq -e '.auth.kind != "none"'。设置完整上下文示例:mcloud use --organization <org-id> --project <project-id-or-handle> --environment <environment-handle>。清除上下文:mcloud use --clear。查看版本:mcloud version --json。非交互登录:export MCLOUD_TOKEN=<access-key> 或 mcloud login --token <token>。
限制:mcloud login、mcloud signup 以及不带参数的 mcloud use 需要 TTY,在 CI、Docker 或管道输入中会失败,应改用 MCLOUD_TOKEN 或显式传参。设置 MCLOUD_TOKEN 后,基于文件的凭据会被忽略,且 mcloud login 会被拒绝;要切换账号需先取消该变量。whoami 退出码为 0 表示已认证且有作用域,非零时应停止并提示用户。