پرش به مطلب اصلی
logologo
مستندات
اتاق خبربلاگتماس با ما
راهنمای فنیانجمنارجاعاتپرسش‌های رایج

مدیریت بکاپ‌

دستورهای backup ابزارهایی برای مدیریت بکاپ‌های ابرک در زیرساخت ابری شما فراهم می‌کند. شما می‌توانید بکاپ دستی ایجاد کنید، از اسلات‌های بکاپ بازیابی (Restore) انجام دهید و بکاپ را در فضای ذخیره‌سازی سازگار با S3 آپلود کنید.

شناسه‌ی مستعار (Alias): bkp

دستورها​

۱. لیست بکاپ‌ها​

لیست تمام پروفایل‌های بکاپ. از فلگ‌ها برای فیلتر کردن بر اساس ریجن یا دیتاسنتر استفاده کنید.

arvan iaas backup list

شناسه‌ی مستعار: ls

Flags:

  • region-- و r-: فیلتر بر اساس کد ریجن (اختیاری) مثال: ir-central1
  • az-- و a-: فیلتر بر اساس دیتاسنتر (اختیاری) مثال: ir-central1-a

مثال:

$ arvan iaas backup list --az ir-central1-a

خروجی:

BACKUP NAME     INSTANCE NAME   VOLUME ID                             STATUS    SLOTS  AZ
data-backup     my-server       a1b2c3d4-5678-90ab-cdef-123456789012  enabled   3/10   ir-central1-a
app-backup      app-server      b2c3d4e5-6789-01bc-def0-234567890123  enabled   5/10   ir-central1-a

Total backup profiles: 2

۲. نمایش جزییات بکاپ​

نمایش اطلاعات دقیق درباره‌ی پیکربندی یک بکاپ.

arvan iaas backup show <backup-name>

شناسه‌ی مستعار: sh

Arguments:

  • backup-name (اجباری): نام بکاپ

مثال:

$ arvan iaas backup show my-backup

خروجی:

BACKUP DETAILS
--------------
Backup Name:   my-backup
Volume ID:     a1b2c3d4-5678-90ab-cdef-123456789012
Instance ID:   x1y2z3w4-5678-90ab-cdef-123456789012
Instance Name: my-server
Status:        enabled
Slots Used:    3/10
Next Backup:   2026-02-18 00:00:00
Auto S3:       false
AZ:            ir-central1-a
Created At:    2026-01-15 10:30:00

۳. فعال‌سازی بکاپ​

فعال‌سازی بکاپ خودکار برای یک ابرک. بکاپ در همان دیتاسنتری که ابرک قرار دارد ایجاد می‌شود. هر پروفایل پشتیبان‌گیری مانند یک Job عمل می‌کند که به‌طور منظم از ابرک بکاپ تهیه کرده و هر کدام را به‌عنوان یک اسلات (Slot) ذخیره می‌کند.

شما نمی‌توانید چند پروفایل بکاپ برای یک ابرک داشته باشید، اما می‌توانید چند اسلات زیر مجموعه‌ی یک پروفایل داشته باشید.

arvan iaas backup enable

Flags:

  • name-- و n-: نام بکاپ (اختیاری)
  • instance-- و i-: شناسه‌ی ابرک (اجباری)

مثال:

$ arvan iaas backup enable --instance c11d6cb4-7a31-4192-8ed2-64c39f57d839 --name my-backup

خروجی:

Backup 'my-backup' enabled successfully for instance c11d6cb4-7a31-4192-8ed2-64c39f57d839 in ir-central1-a

نکته‌ها:

  • availability zone به‌طور خودکار از روی ابرک تشخیص داده می‌شود.
  • پشتیبان در همان AZ ابرک ساخته می‌شود.
  • اگر نامی مشخص نکنید، یک نام پیش‌فرض بر اساس نام ابرک تولید می‌شود.

۴. غیرفعال‌سازی بکاپ​

غیرفعال کردن بکاپ برای یک ابرک که منجر به توقف پشتیبان‌گیری‌های خودکار آتی می‌شود.

توجه داشته باشید که با این کار تمام اسلات‌های موجود متعلق به این پروفایل نیز حذف خواهند شد.

arvan iaas backup disable <backup-name>

Flags:

  • force-- و f-: نادیده گرفتن تایید عملیات

مثال:

$ arvan iaas backup disable my-backup --force

خروجی:

Backup 'my-backup' disabled successfully

نکته‌ها:

  • این دستور تمام اسلات‌های پشتیبان موجود را حذف می‌کند
  • این عملیات قابل بازگشت نیست

۵. ایجاد بکاپ دستی​

ایجاد یک اسلات بکاپ به‌شکل دستی برای یک پروفایل موجود

arvan iaas backup create <backup-profile-name>

شناسه‌ی مستعار: cr

مثال:

$ arvan iaas backup create my-backup

خروجی:

Manual backup slot created successfully for 'my-backup'

نکته‌ها:

  • پروفایل پشتیبان‌گیری باید از قبل وجود داشته باشد. (ابتدا از enable استفاده کنید)
  • اسلات پشتیبان دستی به‌شکل آنی ساخته می‌شود.

۶. تغییر نام بکاپ​

تغییر نام پروفایل بکاپ

arvan iaas backup rename <backup-name> <new-name>

مثال:

$ arvan iaas backup rename old-name new-name

خروجی:

Backup 'old-name' renamed to 'new-name' successfully.

۷. لیست اسلات‌های بکاپ​

لیست تمام اسلات‌های متعلق به یک پروفایل خاص.

arvan iaas backup slot-list <backup-name>

مثال:

$ arvan iaas backup slot-list my-backup

خروجی:

BACKUP ID                             SLOT NAME         STATUS     TYPE       USED SIZE (GB)  CREATED AT
f85dda1a-6b6d-42ca-a322-f631a7264f71  Slot 1 - Backup 1 available  manual     0.00            2026-02-01 10:30:45
90ff7639-8f4d-4998-ad85-e4ad2e8d1db4  Slot 2 - Backup 2 available  scheduled  0.00            2026-01-30 00:00:12

Total backup slots: 2

۸. حذف اسلات بکاپ​

حذف یک اسلات خاص با استفاده از شناسه‌ی آن (Backup ID) که از خروجی slot-list به‌دست می‌آید.

arvan iaas backup slot-delete <slot-backup-id>

مثال:

# ابتدا BACKUP ID را از slot-list دریافت کنید
$ arvan iaas backup slot-list my-backup

BACKUP ID                             SLOT NAME         STATUS     TYPE
f85dda1a-6b6d-42ca-a322-f631a7264f71  Slot 1 - Backup 1 available  manual

# سپس با استفاده از BACKUP ID اسلات را حذف کنید
$ arvan iaas backup slot-delete f85dda1a-6b6d-42ca-a322-f631a7264f71 --force

خروجی:

Backup slot 'f85dda1a-6b6d-42ca-a322-f631a7264f71' deleted successfully

نکته‌ها:

  • حتمن از BACKUP ID موجود در خروجی دستور slot-list استفاده کنید.
  • حذف اسلات دایمی است و امکان بازگشت آن وجود ندارد.

۹. بازیابی بکاپ (Restore)​

بازیابی مستقیم روی ابرک فعلی پشتیبانی نمی‌شود. در حال حاضر برای بازیابی یک اسلات، باید هنگام ایجاد ابرک جدید، شناسه‌ی اسلات پشتیبان را به‌عنوان دیسک سیستم‌عامل (os volume) وارد کنید.

arvan iaas backup restore

مثال:

$ arvan iaas backup restore

خروجی:

Direct restore to an instance is not supported.
Please create a new instance using the backup slot ID as the OS volume و and then delete the old instance if you no longer need it.

Example:
  arvan iaas server create --name new-server --volume-size 50 --flavor <flavor-id> --os-volume <backup-slot-id>

نکته‌ها:

  • بازیابی مستقیم روی ابرک موجود در حال حاضر پشتیبانی نمی‌شود
  • برای بازیابی از پشتیبان، یک ابرک جدید با شناسه‌ی اسلات پشتیبان به‌عنوان دیسک OS بسازید
  • پس از تایید ابرک جدید، می‌توانید ابرک قدیمی را حذف کنید

۱۰. آپلود بکاپ در S3​

آپلود یک اسلات بکاپ در یک فضای ذخیره‌سازی سازگار با S3.

arvan iaas backup s3-upload <slot-id>

Flags:

  • region-- و r-: کد ریجن S3 (اجباری)
  • bucket-- و b-: نام Bucket در S3 (اجباری)

مثال:

$ arvan iaas backup s3-upload f85dda1a-6b6d-42ca-a322-f631a7264f71 --region ir-thr-si1 --bucket my-backups

خروجی:

Backup slot 'f85dda1a-6b6d-42ca-a322-f631a7264f71' uploaded successfully to S3 bucket 'my-backups' in region 'ir-thr-si1'

اگر آپلود دیگری برای همان پروفایل پشتیبان در جریان باشد، این دستور با خطا مواجه می‌شود

۱۱. لیست ارایه‌دهندگان S3​

لیست تمام ارائه‌دهندگان S3 سازگار برای ذخیره‌سازی/آرشیو اسلات‌های پشتیبان.

arvan iaas backup s3-provider-list

مثال:

$ arvan iaas backup s3-provider-list

خروجی:

ID           NAME                DEFAULT
arvancloud   ArvanCloud Storage  Yes
aws-s3       AWS S3              No

۱۲. نمایش جزییات ارایه‌دهنده S3​

نمایش اطلاعات دقیق شامل ریجن‌ها و Bucketهای در دسترس برای یک ارایه‌دهنده.

arvan iaas backup s3-provider-show <provider-id>

مثال:

$ arvan iaas backup s3-provider-show arvancloud

خروجی:

S3 PROVIDER DETAILS
-------------------
ID: arvancloud

AVAILABLE REGIONS AND BUCKETS
------------------------------
REGION NAME       CODE        BUCKETS
Tehran            ir-thr-si1  3 (my-backups و ...)
Tabriz            ir-tbz-dc1  2 (backup-storage و ...)

Tehran (ir-thr-si1) Buckets:
BUCKET NAME
my-backups
production-backups
archive-storage

۱۳. دریافت تعداد بکاپ‌ها​

دریافت تعداد کل بکاپ‌ها در تمامی ریجن‌ها و دیتاسنترها.

arvan iaas backup counts

مثال:

$ arvan iaas backup counts

خروجی:

BACKUP COUNTS
-------------
Total: 25

COUNTS BY AVAILABILITY ZONE
---------------------------
ir-central1-a  15
ir-central1-b  10

سناریوهای رایج​

فعال‌سازی Backup و ایجاد اسلات دستی​

# 1. Enable backup on an instance (AZ is auto-detected)
arvan iaas backup enable --instance c11d6cb4-7a31-4192-8ed2-64c39f57d839 --name my-app-backup

# 2. Create a manual backup slot immediately
arvan iaas backup create my-app-backup

# 3. List backup slots to verify
arvan iaas backup slot-list my-app-backup

حذف اسلات Backup​

# 1. List slots to get the backup ID
arvan iaas backup slot-list my-app-backup

# Output shows:
# BACKUP ID                             SLOT NAME         STATUS
# f85dda1a-6b6d-42ca-a322-f631a7264f71  Slot 1 - Backup 1 available

# 2. Delete using the backup ID
arvan iaas backup slot-delete f85dda1a-6b6d-42ca-a322-f631a7264f71 --force

آپلود در S3​

# 1. List S3 providers
arvan iaas backup s3-provider-list

# 2. View provider details and available regions
arvan iaas backup s3-provider-show arvancloud

# 3. Get the slot ID from backup slots
arvan iaas backup slot-list my-app-backup

# 4. Upload the slot to S3
arvan iaas backup s3-upload f85dda1a-6b6d-42ca-a322-f631a7264f71 --region ir-thr-si1 --bucket my-backups

مدیریت چند Backup​

# List all backups
arvan iaas backup list

# View backup counts by region
arvan iaas backup counts

# Disable a backup when no longer needed
arvan iaas backup disable old-app-backup --force

نکته‌های تکمیلی​

  • AZ Auto-Detection: منطقه‌ی دسترس‌پذیری (AZ) به‌طور خودکار هنگام فعال‌سازی از روی ابرک شناسایی می‌شود.
  • Backup Slots: هر پروفایل Backup نسخه‌ها را به‌شکل اسلات ذخیره می‌کند.
  • Backup Profiles: برای هر ابرک تنها یک پروفایل Backup مجاز است، اما اسلات‌های متعددی در آن پروفایل قابل تعریف است.
  • Manual Backups: ایجاد اسلات‌های دستی همواره با دستور create امکان‌پذیر است.
  • Slot Deletion: برای حذف حتمن از BACKUP ID خروجی slot-list استفاده کنید.
  • Irreversible Actions: حذف اسلات یا غیرفعال کردن Backup غیرقابل بازگشت است.
  • Restore Limitation: بازیابی مستقیم پشتیبانی نمی‌شود و باید ابرک جدیدی از روی اسلات ساخته شود.
  • S3 Integration: آپلود در S3 امکان نگه‌داری نسخه‌ها خارج از محیط اصلی برای Disaster Recovery را فراهم می‌کند.
  • Automation: از فلگ force-- برای نادیده گرفتن تایید در اسکریپت‌های خودکار استفاده کنید.