mcpField
Z
zeabur-template-backup

zeabur-template-backup

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

关于 zeabur-template-backup

用于将在线 Zeabur 模板备份为本地 Git 仓库中的 YAML 文件,并统一目录和文件命名。流程涵盖下载、命名、提交,以及按需推送。

主要功能

  1. 01使用 curl 下载模板 YAML
  2. 02生成 kebab-case 服务名
  3. 03按标准结构保存文件
  4. 04提交并可按需推送备份

适用场景

  1. 01根据 Zeabur 模板 URL 归档模板
  2. 02将在线模板保存到本地 Git 仓库

安装

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

$npx skills add https://github.com/zeabur/agent-skills --skill zeabur-template-backup

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

详细介绍

Zeabur 模板备份

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

将在线 Zeabur 模板备份到本地 Git 仓库,并采用统一的命名方式。

适用场景

  • 用户提供 Zeabur 模板 URL(例如:https://zeabur.com/templates/85IQXQ)
  • 用户要求备份/保存 Zeabur 模板
  • 用户想要创建在线 Zeabur 模板的本地副本

仓库位置

备份仓库路径取决于你的设置。请在用户的工作区中查找 zeabur-template 目录,或询问用户要将模板保存在哪里。常见的默认路径:

~/Documents/zeabur/zeabur-template/

命名约定

{service-name}/zeabur-template-{service-name}-{TEMPLATE_CODE}.yaml

示例:

  • elasticsearch-kibana/zeabur-template-elasticsearch-kibana-85IQXQ.yaml
  • dify/zeabur-template-dify-1D4DOW.yaml
  • postiz/zeabur-template-postiz-v2.12-X2L3BE.yaml

如何下载模板 YAML

在模板 URL 后附加 .yaml,即可直接下载 Zeabur 模板:

https://zeabur.com/templates/{TEMPLATE_CODE}.yaml

示例:

  • 模板页面:https://zeabur.com/templates/1D4DOW
  • YAML 下载链接:https://zeabur.com/templates/1D4DOW.yaml

使用 curl 下载:

curl -sL https://zeabur.com/templates/{TEMPLATE_CODE}.yaml -o output.yaml

分步说明

如需参考和编辑模板 YAML,请使用 zeabur-template 技能。

1. 从 URL 中提取模板代码

URL 格式:https://zeabur.com/templates/{TEMPLATE_CODE}

示例:https://zeabur.com/templates/85IQXQ → 代码为 85IQXQ

2. 下载 YAML 并提取模板名称
# Download YAML
curl -sL https://zeabur.com/templates/{TEMPLATE_CODE}.yaml -o /tmp/template.yaml

# Extract template name from YAML metadata.name field
grep -A1 'metadata:' /tmp/template.yaml | grep 'name:' | head -1
3. 确定服务名称
  • 将模板名称转换为小写 kebab-case
  • 示例:“Elasticsearch Single Node with Kibana” → elasticsearch-kibana
  • 名称应简短且具有描述性
4. 创建目录并保存
REPO=~/Documents/zeabur/zeabur-template  # adjust to your actual path

# Create directory
mkdir -p $REPO/{service-name}

# Move YAML with naming pattern
mv /tmp/template.yaml $REPO/{service-name}/zeabur-template-{service-name}-{TEMPLATE_CODE}.yaml
5. Git 提交
cd $REPO
git add {service-name}/
git commit -m "feat({service-name}): add {Template Name} template"
6. 推送(如有请求)
git push

快速参考

步骤操作
1从 URL 中提取模板代码
2使用 curl -sL .../{CODE}.yaml 下载 YAML
3从 YAML 的 metadata.name 中读取模板名称
4确定 kebab-case 服务名称
5保存到 {service-name}/zeabur-template-{service-name}-{CODE}.yaml
6按约定格式进行 Git 提交
7按用户要求推送

常见问题

问题解决方案
curl 返回 HTML 而不是 YAML确认模板代码正确
模板名称含有特殊字符目录名使用简单的 kebab-case
文件已存在与现有文件比较,必要时更新

评论

支持 Markdown