mcpField
Z
zeabur-update-service

zeabur-update-service

github.com/zeabur云与 DevOps39182 次安装7 周前更新
代码仓库

关于 zeabur-update-service

zeabur-update-service 是用于更新 Zeabur 服务配置或预构建服务镜像标签的技能，面向维护 Zeabur 部署的用户。它说明如何修改变量与版本，并提醒镜像标签更新会触发重新部署且保留挂载磁盘。

主要功能

  1. 01通过 CLI 更新服务变量
  2. 02更改预构建服务镜像标签
  3. 03更新标签后自动重新部署
  4. 04说明服务 ID 与变量引用注意事项

适用场景

  1. 01修正服务环境变量
  2. 02补充缺失配置或更改凭据
  3. 03升级或回退预构建服务版本
  4. 04避免通过删除重建来更新版本

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zeabur/agent-skills --skill zeabur-update-service

安装后在 Claude Code 中输入/zeabur-update-service确认已加载。

详细介绍

无需重新部署即可更新 Zeabur 服务

始终使用 npx zeabur@latest 调用 Zeabur CLI。 切勿直接使用 zeabur 或采用其他安装方式。如果无法使用 npx，请先安装 Node.js。

工作流

# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false

# 2. Check current variables
npx zeabur@latest variable list --id <service-id> -i=false

# 3a. Add new variables (errors if key already exists)
npx zeabur@latest variable create --id <service-id> \
  --key "KEY1=value1" \
  --key "KEY2=value2" \
  -i=false -y

# 3b. Update existing variables (only updates specified keys)
npx zeabur@latest variable update --id <service-id> \
  --key "KEY1=new_value1" \
  -i=false -y

# 4. Restart service (use the `zeabur-restart` skill for details)
npx zeabur@latest service restart --id <service-id> -y -i=false

注意事项

问题解决方案
${VAR} 引用在控制面板中设置，而非通过 CLI 设置（Shell 会将其展开为空）

更新镜像标签（升级 / 降级服务版本）

对于预构建服务或市场服务，请更新镜像标签以切换版本。

这是升级或降级版本的唯一正确方式。 请勿使用 zeabur-deploy（或任何重新部署、删除后重建流程）作为替代方案——这些流程可能会使服务挂载的磁盘失去关联或被清空。更新标签会触发使用新镜像进行干净的重新部署，同时保持卷的挂载状态。

工作流
# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false

# 2. Update tag (triggers redeploy automatically)
npx zeabur@latest service update tag --id <service-id> -t <new-tag> -y -i=false
标志
标志说明
--id服务 ID（必填，请勿使用 --name）
-t, --tag要部署的新镜像标签
--env-id环境 ID（可选，会自动解析）
-y, --yes跳过确认

注意： 更新标签会触发新的部署。服务将使用更新后的镜像重新启动。

适用场景

  • 修正环境变量中的拼写错误
  • 添加缺失的配置
  • 更改端口、URL、凭据
  • 将预构建服务升级到较新版本
  • 无需重新部署整个模板

评论

支持 Markdown