پشتیبان‌گیری از دیتابیس | مستندات ابران

Backup فقط زمانی قابل اتکا است که به وضعیت ready رسیده، پیش از انقضا نگهداری یا دانلود شده و روش بازیابی آن خارج از زمان حادثه آزمایش شده باشد.

ساخت و پیکربندی

اتصال امن

لاگ و پایش

پشتیبان‌گیری

سیاست plan را بررسی کنید

فعال‌بودن backup و مدت retention به plan دیتابیس وابسته است. در Console، دیتابیس را باز کنید و در بخش Backups سیاست نمایش‌داده‌شده را بخوانید. اگر backup برای plan غیرفعال باشد، ساخت دستی هم در دسترس نیست.

پیش از تغییر plan یا حذف دیتابیس، فرض نکنید backupهای قدیمی برای همیشه باقی می‌مانند؛ مقدار expiresAt هر artifact را بررسی کنید.

۱. یک backup دستی بسازید


abrun db backup create <database>

درخواست به‌صورت asynchronous ثبت می‌شود. پاسخ اولیه موفق به معنی آماده‌بودن artifact نیست.

۲. پیشرفت را دنبال کنید


abrun db backup list <database>

شناسه backup را از فهرست بردارید و جزئیات آن را بخوانید:


abrun db backup inspect <database> <backup-id>

Status	معنی	اقدام
`queued`	درخواست منتظر اجرا است	کمی بعد دوباره بررسی کنید
`running`	artifact در حال ساخته‌شدن است	دیتابیس را حذف نکنید و منتظر بمانید
`ready`	artifact کامل و قابل دانلود است	اندازه، checksum و انقضا را بررسی کنید
`failed`	backup کامل نشده است	`errorMessage`، eventها و سلامت دیتابیس را بررسی کنید
`expired`	retention پایان یافته است	این artifact دیگر برای بازیابی در دسترس نیست
`cancelled`	عملیات پیش از تکمیل متوقف شده است	در صورت نیاز یک backup جدید بسازید

وضعیت cancelled ممکن است در رکوردها دیده شود، اما workflow عمومی لغو تا تکمیل قرارداد OpenAPI/SDK مستند نمی‌شود.

۳. artifact آماده را دانلود کنید

CLI فعلی command دانلود ندارد. در Console این مسیر را باز کنید:

وارد پروژه و دیتابیس شوید.
بخش Backups را انتخاب کنید.
کنار backup با وضعیت ready، دکمه دانلود را بزنید.

Console یک URL دانلود موقت می‌سازد. دانلود را پیش از زمان انقضای URL کامل کنید و فایل را در storage کنترل‌شده با دسترسی محدود نگه دارید.

۴. artifact را اعتبارسنجی کنید

برای backup آماده، حداقل این موارد را ثبت کنید:

backup ID و نام دیتابیس منبع
موتور و نسخه دیتابیس
completedAt و expiresAt
sizeBytes و checksum
extensionهای لازم برای PostgreSQL

Checksum را پس از انتقال مستقل بررسی کنید. نگهداری فایل بدون ثبت موتور، نسخه و extensionهای لازم می‌تواند بازیابی آینده را مبهم کند.

بازیابی و آزمون recovery

در حال حاضر restore سلف‌سرویس در CLI یا راهنمای عمومی پذیرفته‌شده وجود ندارد. Backup production را بدون یک runbook بازیابی تأییدشده کامل تلقی نکنید. برای recovery عملیاتی یا آزمون artifact با پشتیبانی هماهنگ کنید.

خطاهای رایج

ساخت backup رد می‌شود: plan و وضعیت دیتابیس را بررسی کنید.
مدت زیادی queued یا running مانده است: eventهای دیتابیس و سپس پشتیبانی را بررسی کنید؛ درخواست‌های تکراری پشت سر هم نسازید.
وضعیت failed است: errorMessage را ثبت کنید، سلامت دیتابیس را بررسی و بعد یک تلاش جدید انجام دهید.
دکمه دانلود غیرفعال است: فقط backup با وضعیت ready قابل دانلود است.
URL دانلود منقضی شده است: دوباره از Console یک URL موقت جدید بسازید.