SuperAPI AI 工具集

pscale-service-token

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:管理 PlanetScale 服务令牌(service token),用于 CI/CD 与自动化场景的身份认证,例如 GitHub Actions 等流水线。

主要能力:创建、列出、查看和删除服务令牌。常用命令:pscale service-token create --org <org>;pscale service-token list --org <org>;pscale service-token show <token-id> --org <org> --format json;pscale service-token delete <token-id> --org <org>。show 仅返回安全元数据(ID、名称、创建时间、最后使用时间),不打印令牌密钥,也不含访问授权;需要授权信息时使用 show-access。

使用方式:创建令牌后,将返回的 TOKEN_ID 与 TOKEN 分别配置为环境变量 PLANETSCALE_SERVICE_TOKEN_ID 和 PLANETSCALE_SERVICE_TOKEN,放入 CI/CD 的密钥管理(如 GitHub Secrets),再在流水线中调用 pscale 命令(如 pscale deploy-request deploy my-db my-branch)。令牌轮换流程为:列出旧令牌、创建新令牌、更新 CI/CD 密钥、删除旧令牌。

适用场景:自动化部署、CI/CD 流水线集成、令牌轮换与审计。

限制与注意:令牌按组织(org)范围管理,需确保使用正确组织;认证失败(401 Unauthorized)时检查 TOKEN_ID 与 TOKEN 是否正确、令牌是否被删除、权限是否足够,或重新创建令牌。令牌 ID 与授权详情属敏感运维元数据,切勿将令牌密钥粘贴到聊天中,应使用环境变量或密钥管理工具;不要将令牌提交到版本控制;建议定期轮换(如每 90 天)、为不同 CI/CD 系统使用独立令牌、及时删除未使用令牌。资料未提供令牌作用域限制的具体实现,仅提及未来 PlanetScale 更新可能支持。