mcpField
Z
zeabur-update-service

zeabur-update-service

github.com/zeaburCloud & DevOps39182 installsUpdated 7w ago
Repository

About zeabur-update-service

zeabur-update-service is a skill for changing Zeabur service configuration or image tags for prebuilt services. It guides Zeabur operators through variable and version updates, noting that a tag change triggers redeployment while keeping the mounted disk attached.

Key features

  1. 01Update service variables through the CLI
  2. 02Change prebuilt service image tags
  3. 03Trigger redeployment by updating a tag
  4. 04Note service ID and variable-reference caveats

Use cases

  1. 01Correct service environment variables
  2. 02Add missing configuration or change credentials
  3. 03Upgrade or downgrade a prebuilt service
  4. 04Avoid deleting and recreating a service for version changes

Install

Copy the command and run it in a terminal.

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

After installing, type/zeabur-update-servicein Claude Code to confirm it loaded.

Details

From the project README

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

# 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

Caveats

IssueSolution
${VAR} referencesSet in Dashboard, not CLI (shell expands to empty)

Update Image Tag (Upgrade / Downgrade Service Version)

For prebuilt/marketplace services, update the image tag to switch versions.

This is the ONLY correct path for version upgrades or downgrades. Do NOT use zeabur-deploy (or any redeploy / delete-and-recreate flow) as a substitute — those flows can orphan or wipe the service's mounted disk. A tag update triggers a clean redeploy with the new image while the volume stays attached.

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
FlagDescription
--idService ID (required, do not use --name)
-t, --tagNew image tag to deploy
--env-idEnvironment ID (optional, resolved automatically)
-y, --yesSkip 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

Comments

Markdown supported