关于 zeabur-template-backup
用于将在线 Zeabur 模板备份为本地 Git 仓库中的 YAML 文件,并统一目录和文件命名。流程涵盖下载、命名、提交,以及按需推送。
主要功能
- 01使用 curl 下载模板 YAML
- 02生成 kebab-case 服务名
- 03按标准结构保存文件
- 04提交并可按需推送备份
适用场景
- 01根据 Zeabur 模板 URL 归档模板
- 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.yamldify/zeabur-template-dify-1D4DOW.yamlpostiz/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