zeabur-template-backup

Zeabur テンプレートのバックアップ

Zeabur CLI の実行には、必ず npx zeabur@latest を使用してください。 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. サービス名を決める

• テンプレート名を小文字のケバブケースに変換します
• 例：「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	ケバブケースのサービス名を決める
5	{service-name}/zeabur-template-{service-name}-{CODE}.yaml に保存する
6	一般的な形式で Git コミットする
7	ユーザーから依頼があればプッシュする

よくある問題

問題	解決策
curl が YAML ではなく HTML を返す	テンプレートコードが正しいことを確認してください
テンプレート名に特殊文字が含まれている	ディレクトリ名にはシンプルなケバブケースを使用してください
すでに存在する	既存のファイルと比較し、必要に応じて更新してください