用途:管理 PlanetScale CLI(pscale)的认证,包括登录、登出、查看认证状态和切换账号,适用于首次配置 pscale、CI/CD 自动化以及认证故障排查。
主要能力与用法: 交互式登录(默认,打开浏览器走 OAuth):pscale auth login;自动化友好模式:pscale auth login --format json。登出:pscale auth logout。查看当前认证状态:pscale org show。
服务令牌(CI/CD): export PLANETSCALE_SERVICE_TOKEN_ID=<token-id> export PLANETSCALE_SERVICE_TOKEN=<token> pscale database list --org <org> 令牌创建参见 pscale-service-token 技能。
API 令牌方式:pscale database list --org <org> --api-token <token>,建议通过环境变量或密钥管理器注入,避免写入 shell 历史或提交到仓库。
典型流程:首次配置为登录、用 pscale org show 验证、再用 pscale database list --org <org> 确认访问;切换账号为先登出再登录;CI/CD 中创建服务令牌后设置上述两个环境变量并测试。
限制与注意:JSON 模式若提示需要用户操作,只转达所需操作或 URL,不要打印或存储凭据。CLI 在运行时解析内置 OAuth 客户端值,帮助输出中不显示,不要抓取或复现这些凭据;--client-id 与 --client-secret 仅作为高级覆盖,仅在用户明确提供可信自定义 OAuth 客户端时使用,并通过安全机制传递密钥。pscale 不支持无头浏览器认证,非交互环境请改用服务令牌。
故障排查:登录失败或浏览器不打开时检查网络与防火墙是否允许 https://auth.planetscale.com;出现 401/403 可执行 pscale auth logout && pscale auth login 刷新会话,并用 pscale org show 验证组织访问;多账号或组织错误可用 pscale org show、pscale org switch <org-name>、pscale org list 处理;服务令牌失败时确认两个环境变量均已设置、令牌未撤销且权限足够,可用 --debug 查看认证细节。
相关技能:pscale-service-token、pscale-org、pscale-database。完整命令参考见 references/commands.md。