用途:为项目配置 Zeabur CLI 上下文,避免命令操作到错误项目的服务、出现上下文错误,或需要手动传 env-id。
主要能力:通过 npx zeabur 命令查找项目 ID、设置项目上下文、设置环境上下文,并验证当前上下文。设置环境上下文后,许多需要 --env-id 的命令(如服务暂停、部署日志、服务重启)会自动读取 env-id,无需每次手动传入。
使用方式:
- 查找项目 ID:npx zeabur@latest project list
- 设置项目(project 是子命令而非 flag):npx zeabur@latest context set project --id <project-id> -i=false -y
- 设置环境(交互式,若只有一个环境会自动选择):npx zeabur@latest context set env
- 验证(显示项目、环境与服务 ID):npx zeabur@latest context get -i=false
对比示例:未设置上下文时须写 npx zeabur@latest service suspend -i=false --id <id> --env-id <env-id>;设置后自动读取 env-id,写 npx zeabur@latest service suspend -i=false --id <id> 即可。
常见错误:把 project-id 当作 flag 使用,如 npx zeabur@latest context set --project-id xxx,这是错误的;正确写法是 context set project --id xxx -i=false -y。
查看上下文:npx zeabur@latest context get -i=false,输出包含 Project、Environment、Service 的 NAME 与 ID。