skills/zeabur/agent-skills/zeabur-update-service

zeabur-update-service

Installation
SKILL.md

Zeabur Update Service Without Redeploy

Always use npx zeabur@latest to invoke Zeabur CLI. Never use zeabur directly or any other installation method. If npx is not available, install Node.js first.

Workflow

# 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

# 3. Add/update variables
npx zeabur@latest variable create --id <service-id> \
  --key "KEY1=value1" \
  --key "KEY2=value2" \
  -i=false -y

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

Caveats

Issue Solution
${VAR} references Set in Dashboard, not CLI (shell expands to empty)
variable update clears vars Use variable create instead

Update Image Tag (Upgrade Service Version)

For prebuilt/marketplace services, update the image tag to upgrade to a newer version.

Workflow

# 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

Flags

Flag Description
--id Service ID (required, do not use --name)
-t, --tag New image tag to deploy
--env-id Environment ID (optional, resolved automatically)
-y, --yes Skip confirmation

Note: Updating the tag triggers a new deployment. The service will restart with the updated image.

When to Use

  • Fix environment variable typos
  • Add missing config
  • Change ports, URLs, credentials
  • Upgrade a prebuilt service to a newer version
  • No need to redeploy entire template
Weekly Installs
4
GitHub Stars
20
First Seen
4 days ago
Installed on
opencode4
gemini-cli4
deepagents4
antigravity4
claude-code4
github-copilot4