مقدمه

JetBackup یکی از ابزارهای محبوب تهیه و مدیریت Backup در سرورهای میزبانی وب است که امکان ذخیره بکاپ‌ها روی مقصدهای مختلف از جمله S3-Compatible Object Storage را فراهم می‌کند.

با اتصال JetBackup به S3 Storage می‌توانید بکاپ‌های سرور را به یک فضای ذخیره‌سازی جدا از سرور اصلی منتقل کنید. این موضوع باعث می‌شود در صورت خرابی دیسک، حذف اطلاعات، مشکل سخت‌افزاری یا از دسترس خارج شدن سرور اصلی، نسخه‌ای از اطلاعات روی Storage دیگری در اختیار داشته باشید.

JetBackup از سرویس‌های مختلف S3-Compatible مانند موارد زیر پشتیبانی می‌کند:

• Amazon S3
• JetBackup Storage
• Cloudflare R2
• DigitalOcean Spaces
• Wasabi
• Google Cloud Storage
• IBM Cloud Object Storage
• Oracle Cloud Object Storage
• Scaleway Object Storage
• Vultr Object Storage
• برخی S3-Compatible Storageهای دیگر از طریق Custom Vendor

در این مقاله، نحوه اتصال یک S3 Storage به JetBackup 5 را به‌صورت مرحله‌به‌مرحله بررسی می‌کنیم.

پیش‌نیازها

برای اتصال S3 Storage به JetBackup به موارد زیر نیاز دارید:

• نصب بودن JetBackup 5
• دسترسی Administrator یا Root به JetBackup
• یک سرویس S3-Compatible
• یک Bucket
• Access Key
• Secret Key
• Region سرویس
• Endpoint در صورت استفاده از Custom S3 Storage
• دسترسی شبکه سرور به S3 Storage

اطلاعات موردنیاز S3

قبل از شروع بهتر است اطلاعات زیر را از سرویس‌دهنده Object Storage دریافت کنید:

Bucket Name
Access Key
Secret Key
Region
Endpoint

برای مثال:

Bucket: server-backups
Access Key: YOUR_ACCESS_KEY
Secret Key: YOUR_SECRET_KEY
Region: eu-central-1
Endpoint: S3_ENDPOINT

نکته امنیتی: Access Key و Secret Key اطلاعات حساس هستند. آن‌ها را داخل Ticket عمومی، مقاله، Screenshot یا فایل‌های قابل دسترس کاربران قرار ندهید.

بررسی S3 Destination Plugin در JetBackup

JetBackup برای استفاده از S3 نیاز دارد Plugin مربوط به Destination فعال باشد.

وارد پنل JetBackup شوید و بخش:

Plugins

را بررسی کنید.

Plugin مربوط به:

S3 Compatible

باید نصب و فعال باشد.

JetBackup نیز در مستندات رسمی توصیه می‌کند قبل از ساخت Destination از نصب و فعال بودن Plugin مناسب S3 مطمئن شوید.

ساخت Bucket در S3 Storage

قبل از اضافه کردن Destination در JetBackup، ابتدا باید یک Bucket در سرویس S3 خود ایجاد کنید.

برای مثال:

server-backups

یا:

jetbackup-storage

نام Bucket باید مطابق قوانین سرویس S3 انتخاب شود.

تنظیمات مهم Bucket

در یک تنظیم معمولی JetBackup، بهتر است تنظیمات زیر را بدون دلیل فعال نکنید:

Bucket Versioning
Object Lifecycle

JetBackup اعلام می‌کند فعال بودن Bucket Versioning یا Object Lifecycle بدون استفاده صحیح از Object Lock پشتیبانی نمی‌شود و می‌تواند باعث مشکلات Backup، افزایش هزینه Storage یا حتی Backup ناقص شود.

بنابراین برای یک پیاده‌سازی معمولی:

Versioning: Disabled
Lifecycle: Disabled

در نظر گرفته شود.

Object Lock چیست؟

JetBackup از Object Lock برای ساخت Immutable Backup نیز پشتیبانی می‌کند.

در این حالت Backupها تا پایان مدت Retention قابل حذف یا تغییر نیستند.

اگر قصد استفاده از Object Lock دارید، Bucket باید به شکل سازگار با JetBackup ساخته شود.

JetBackup برای Immutable Backup نیازمند:

Object Lock
Compliance Mode
Default Retention Rule

است.

حالت:

Governance Mode

برای این قابلیت در JetBackup پشتیبانی نمی‌شود.

اگر در حال راه‌اندازی یک S3 Destination معمولی هستید، Object Lock را بدون برنامه مشخص فعال نکنید.

ساخت Access Key و Secret Key

در پنل S3 Provider یک Credential جدید ایجاد کنید.

معمولاً دو مقدار دریافت خواهید کرد:

Access Key
Secret Key

برای مثال:

Access Key:
XXXXXXXXXXXXXXXXXXXX

Secret Key:
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

این Credential باید دسترسی لازم به Bucket موردنظر را داشته باشد.

JetBackup برای ایجاد S3 Destination به Access Key و Secret Key نیاز دارد.

محدود کردن دسترسی S3 Credential

بهتر است Credential ساخته‌شده فقط به Bucket مربوط به Backup دسترسی داشته باشد.

برای مثال اگر Bucket شما:

server-backups

است، نیازی نیست Access Key به تمام Bucketهای حساب S3 دسترسی Administrator داشته باشد.

Credential باید حداقل عملیات موردنیاز JetBackup برای:

Upload
Download
List
Delete
Read

را روی Bucket مربوطه انجام دهد.

اگر از Object Lock استفاده می‌کنید، Permissionهای لازم برای مدیریت Retention نیز باید در اختیار JetBackup باشد.

ورود به بخش Destinations در JetBackup

وارد JetBackup شوید.

سپس وارد بخش:

Destinations

شوید.

یک Destination جدید ایجاد کنید.

نوع Destination را روی:

S3 Compatible

قرار دهید.

انتخاب Destination Name

در قسمت:

Destination Name

یک نام مشخص برای Storage وارد کنید.

برای مثال:

S3 Backup Storage

یا:

Remote S3 Backup

این نام صرفاً برای شناسایی Destination داخل JetBackup استفاده می‌شود.

تنظیم Read Only

گزینه:

Read Only

برای Destinationهایی است که JetBackup نباید روی آن‌ها Backup جدید بنویسد.

برای یک S3 Destination معمولی که قرار است Backupها روی آن ذخیره شوند:

Read Only: No

قرار دهید.

Read Only بیشتر زمانی استفاده می‌شود که قصد Restore یا Download از یک Destination موجود را دارید.

انتخاب Vendor

در قسمت:

Vendor

سرویس‌دهنده S3 خود را انتخاب کنید.

برای مثال:

Amazon S3
Wasabi
Cloudflare
DigitalOcean
Vultr

JetBackup تعدادی از S3 Providerهای شناخته‌شده را مستقیماً پشتیبانی می‌کند.

استفاده از Custom Vendor

اگر سرویس S3 شما در لیست JetBackup قرار ندارد، می‌توانید گزینه:

Custom Vendor

را انتخاب کنید.

در این حالت باید Endpoint سرویس S3 را نیز مشخص کنید.

JetBackup برای Custom Vendor از Endpointهای S3-Compatible استفاده می‌کند و سرویس موردنظر باید واقعاً با پروتکل S3 سازگار باشد.

تنظیم Endpoint

اگر از Custom Vendor استفاده می‌کنید، قسمت:

Endpoint

نمایش داده می‌شود.

Endpoint را باید از سرویس‌دهنده Object Storage دریافت کنید.

فرمت Endpoint می‌تواند بسته به Provider متفاوت باشد.

JetBackup امکان استفاده از متغیر:

{region}

را نیز در Endpoint فراهم می‌کند.

برای مثال ساختار Endpoint می‌تواند به شکل زیر باشد:

s3.{region}.example.com

اگر Region برابر:

eu-central-1

باشد، JetBackup مقدار Region را هنگام اتصال جایگزین می‌کند.

در برخی ساختارهای S3 می‌توان از:

{bucket}

نیز در Endpoint استفاده کرد.

تنظیم Bucket

در قسمت:

Bucket

نام Bucket ساخته‌شده را وارد کنید.

برای مثال:

server-backups

فقط نام Bucket را وارد کنید و نه یک URL کامل.

وارد کردن Access Key

در قسمت:

Access Key

Access Key ساخته‌شده در S3 Provider را وارد کنید.

برای مثال:

ABCDEFGHIJKLMNOPQRST

وارد کردن Secret Key

در قسمت:

Secret Key

Secret Key مربوط به Access Key را وارد کنید.

برای مثال:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Secret Key باید دقیقاً همان مقداری باشد که Provider هنگام ایجاد Credential ارائه کرده است.

انتخاب Region

در قسمت:

Region

Region مربوط به Bucket را انتخاب کنید.

برای مثال:

us-east-1

یا:

eu-central-1

Region باید با Region واقعی Bucket مطابقت داشته باشد.

JetBackup پیشنهاد می‌کند در صورت امکان Region نزدیک به سرور انتخاب شود تا Latency و زمان انتقال Backup کاهش پیدا کند.

تنظیم Backup Directory

در قسمت:

Backup Directory

مسیر موردنظر داخل Bucket را تعیین کنید.

برای مثال:

/jetbackup

یا:

/server1

JetBackup اعلام می‌کند Backup Directory باید با / شروع شود.

برای مثال صحیح:

/server1

و نمونه نامناسب:

server1

مسیر Backup Directory باید برای همان Destination یکتا باشد. همچنین JetBackup برای این قسمت تنها حروف انگلیسی، اعداد و / را مجاز می‌داند.

مثال تنظیم کامل S3 Destination

فرض کنید اطلاعات S3 ما به شکل زیر است:

Destination Name: Remote S3 Backup

Vendor:
Custom Vendor

Bucket:
server-backups

Region:
eu-central-1

Endpoint:
s3.{region}.example.com

Access Key:
YOUR_ACCESS_KEY

Secret Key:
YOUR_SECRET_KEY

Backup Directory:
/server1

Verify SSL:
Yes

این اطلاعات را در JetBackup وارد کنید.

فعال بودن Verify SSL

گزینه:

Verify SSL

به‌صورت پیش‌فرض باید:

Yes

باشد.

JetBackup نیز مقدار پیش‌فرض این گزینه را فعال در نظر می‌گیرد.

غیرفعال کردن Verify SSL فقط در شرایط خاص و برای عیب‌یابی موقت توصیه می‌شود.

در محیط Production بهتر است:

Verify SSL: Yes

باشد.

HTTP Retries

گزینه:

HTTP Retries

مشخص می‌کند اگر عملیات HTTP مربوط به Upload، Download یا Delete با خطا مواجه شد، JetBackup چند بار دوباره تلاش کند.

مقدار پیش‌فرض JetBackup:

3

است.

برای شروع معمولاً نیازی به تغییر آن نیست.

Large Files Upload Chunk Size

JetBackup فایل‌های بزرگ را با Multipart Upload به S3 منتقل می‌کند.

گزینه:

Large Files Upload Chunk Size

اندازه Chunk فایل‌های بزرگ را تعیین می‌کند.

مقدار پیش‌فرض در مستندات فعلی JetBackup:

5120 MB

است.

اگر هنگام Upload فایل‌های بزرگ خطا دریافت می‌کنید، کاهش این مقدار می‌تواند یکی از روش‌های عیب‌یابی باشد.

Keep Alive Timeout

گزینه:

Keep Alive Timeout

مشخص می‌کند Connection بدون فعالیت چه مدت باز باقی بماند.

مقدار پیش‌فرض JetBackup:

60 Seconds

است.

در حالت عادی نیازی به تغییر آن نیست.

Maximum Concurrent Threads

این گزینه تعداد Threadهایی را که JetBackup می‌تواند برای عملیات S3 مانند:

Upload
Download
Get
Delete

استفاده کند مشخص می‌کند.

افزایش بیش از حد Threadها ممکن است باعث Rate Limit شدن توسط S3 Provider شود.

اگر خطاهای Rate Limit مشاهده کردید، کاهش:

Maximum Concurrent Threads

می‌تواند کمک‌کننده باشد.

ذخیره Destination

بعد از وارد کردن اطلاعات:

Destination Name
Vendor
Endpoint
Bucket
Region
Access Key
Secret Key
Backup Directory

تنظیمات را ذخیره کنید.

JetBackup تلاش می‌کند به S3 Destination متصل شود.

در صورت صحیح بودن اطلاعات، Destination ساخته خواهد شد.

بررسی وضعیت Destination

پس از ایجاد Destination وارد:

Destinations

شوید.

S3 Destination جدید باید در لیست نمایش داده شود.

وضعیت Destination را بررسی کنید و مطمئن شوید خطای Connection نمایش داده نمی‌شود.

ساخت Backup Job برای S3

ایجاد Destination به‌تنهایی باعث شروع Backup نمی‌شود.

وارد:

Backup Jobs

شوید.

یک Job جدید ایجاد کنید یا Job موجود را ویرایش کنید.

در قسمت Destination، S3 Storage ساخته‌شده را انتخاب کنید.

برای مثال:

Destination:
Remote S3 Backup

تعیین Schedule

برای Backup Job یک Schedule مشخص کنید.

برای مثال:

Daily

یا متناسب با سیاست Backup سازمان:

Daily
Weekly
Monthly

Retention Backup را نیز براساس نیاز خود تنظیم کنید.

اجرای اولین Backup

پس از ساخت Backup Job بهتر است اولین Backup را به‌صورت دستی اجرا کنید.

Backup Job موردنظر را انتخاب کرده و Job را اجرا کنید.

سپس وارد:

Queue

شوید.

وضعیت Backup را مشاهده کنید.

بررسی Log بکاپ

پس از پایان Backup وارد:

Logs

شوید.

Job اجراشده را بررسی کنید.

به دنبال مواردی مانند:

Success
Completed

باشید.

اگر Backup با خطا مواجه شده باشد، جزئیات آن در Log نمایش داده می‌شود.

بررسی Backup در Bucket

پس از اولین Backup می‌توانید وارد پنل S3 Provider شوید.

Bucket را باز کنید.

برای مثال:

server-backups

باید Objectهای ایجادشده توسط JetBackup را مشاهده کنید.

چرا فایل‌های Backup قابل خواندن نیستند؟

یکی از مواردی که ممکن است در نگاه اول عجیب به نظر برسد، ساختار اطلاعات ذخیره‌شده روی S3 است.

JetBackup در S3 بکاپ‌ها را مانند فایل‌های معمولی:

backup.tar.gz

ذخیره نمی‌کند.

JetBackup از ساختار Object Storage اختصاصی استفاده می‌کند.

ممکن است Objectهایی با ساختاری مشابه:

files/
snap.1/
snap.2/
export/

مشاهده کنید.

این رفتار طبیعی است.

JetBackup اطلاعات Backup و Metadata را به شکل Objectهای متعدد ذخیره می‌کند و نباید آن‌ها را به‌صورت دستی تغییر، Rename یا Delete کنید.

تست Restore

فقط موفق بودن Backup به معنی کامل بودن استراتژی Backup نیست.

بعد از ایجاد اولین Backup بهتر است یک Restore آزمایشی انجام دهید.

برای مثال:

• یک فایل آزمایشی
• یک Database آزمایشی
• یک Account آزمایشی

را Restore کنید.

این کار مشخص می‌کند که Backup واقعاً قابل بازیابی است.

بررسی مصرف Storage

به‌صورت دوره‌ای میزان مصرف Bucket را بررسی کنید.

موارد زیر می‌توانند روی هزینه Storage تأثیر داشته باشند:

• حجم Backup
• Retention
• تعداد Backupها
• Egress Traffic
• تعداد Objectها
• Minimum Storage Duration
• API Requests

برخی S3 Providerها برای حذف Object قبل از مدت مشخص نیز هزینه دریافت می‌کنند.

چرا JetBackup از S3 دانلود انجام می‌دهد؟

ممکن است در پنل S3 Provider مشاهده کنید JetBackup علاوه بر Upload، مقداری Download Traffic نیز دارد.

این موضوع لزوماً غیرطبیعی نیست.

JetBackup برای Backup Indexing، فایل‌های Database مربوط به Snapshotها را از Destination دریافت می‌کند و بنابراین در اجرای Backup Job می‌تواند Download Egress نیز ایجاد شود.

این نکته هنگام محاسبه هزینه یک S3 Provider با Egress پولی اهمیت دارد.

خطاهای رایج

Access Denied

اگر با خطایی مانند:

Access Denied

مواجه شدید، Permission مربوط به Access Key را بررسی کنید.

Credential باید Permission لازم برای Bucket را داشته باشد.

موارد زیر را بررسی کنید:

Access Key
Secret Key
Bucket Permissions
Bucket Policy

Invalid Access Key

Access Key اشتباه است یا Credential حذف شده است.

Access Key را مجدداً از S3 Provider بررسی کنید.

SignatureDoesNotMatch

این خطا معمولاً می‌تواند مربوط به موارد زیر باشد:

• Secret Key اشتباه
• Region اشتباه
• Endpoint اشتباه
• ناسازگاری S3 Provider
• تنظیم نادرست Request Signing

ابتدا Access Key، Secret Key، Region و Endpoint را بررسی کنید.

Bucket Not Found

اگر Bucket پیدا نمی‌شود، موارد زیر را بررسی کنید:

Bucket Name
Region
Endpoint

همچنین مطمئن شوید Credential به Bucket دسترسی دارد.

Connection Timed Out

سرور JetBackup نمی‌تواند به S3 Endpoint متصل شود.

ارتباط شبکه را بررسی کنید.

برای مثال:

ping s3.example.com

در صورت پاسخ ندادن Ping، همچنان ممکن است HTTPS فعال باشد.

بنابراین پورت 443 را بررسی کنید:

nc -zv s3.example.com 443

Could Not Resolve Host

DNS سرور نمی‌تواند Endpoint را Resolve کند.

بررسی کنید:

dig s3.example.com

یا:

nslookup s3.example.com

SSL Certificate Error

اگر Verify SSL فعال باشد و Certificate Endpoint معتبر نباشد، Connection ممکن است Fail شود.

Certificate سرویس S3 را اصلاح کنید.

غیرفعال کردن Verify SSL راه‌حل دائمی مناسبی نیست.

Connection Rate Limited

اگر Provider تعداد Requestهای JetBackup را محدود کند، ممکن است Rate Limit Error دریافت کنید.

در این حالت:

Maximum Concurrent Threads

را کاهش دهید.

Upload فایل‌های بزرگ Fail می‌شود

اگر فقط فایل‌های بزرگ هنگام Upload مشکل دارند، تنظیم:

Large Files Upload Chunk Size

را بررسی کنید.

JetBackup پیشنهاد می‌کند در صورت Fail شدن Upload فایل‌های بزرگ، Chunk Size را کاهش دهید.

Backup Storage به‌سرعت پر می‌شود

موارد زیر را بررسی کنید:

Retention
Bucket Versioning
Lifecycle Rules
Old Backups
Object Lock

فعال بودن Versioning نامناسب می‌تواند باعث نگهداری نسخه‌های اضافی Objectها و افزایش Storage Usage شود.

بررسی ارتباط شبکه با S3

ابتدا DNS را بررسی کنید:

dig s3.example.com

سپس HTTPS:

curl -I https://s3.example.com

همچنین پورت 443:

nc -zv s3.example.com 443

اگر Connection برقرار نباشد، Firewall یا Routing سرور را بررسی کنید.

بررسی Firewall سرور

برای UFW:

sudo ufw status

برای firewalld:

sudo firewall-cmd --list-all

برای بررسی Route:

ip route

و برای تست اینترنت:

ping -c 4 8.8.8.8

S3 Storage یا Local Backup؟

برای یک استراتژی Backup مناسب، بهتر است تنها به Backup روی همان سرور اصلی اکتفا نکنید.

مهم‌ترین تنظیمات S3 در JetBackup

بهترین روش‌ها

• S3 Storage را روی زیرساختی جدا از سرور اصلی نگهداری کنید.
• از Access Key اختصاصی JetBackup استفاده کنید.
• Access Key را فقط به Bucket موردنیاز محدود کنید.
• Secret Key را در اختیار کاربران غیرضروری قرار ندهید.
• Verify SSL را فعال نگه دارید.
• Region نزدیک به سرور انتخاب کنید.
• اولین Backup را به‌صورت دستی تست کنید.
• حتماً Restore آزمایشی انجام دهید.
• Logهای Backup را بررسی کنید.
• مصرف Storage و Egress را مانیتور کنید.
• Retention Policy را متناسب با ظرفیت Storage تنظیم کنید.
• از تغییر دستی Objectهای JetBackup در Bucket خودداری کنید.
• Versioning و Lifecycle را بدون بررسی سازگاری JetBackup فعال نکنید.
• برای Backupهای حساس استفاده از Object Lock را بررسی کنید.

اشتباهات رایج

• وارد کردن Region اشتباه
• وارد کردن Endpoint اشتباه
• استفاده از Secret Key اشتباه
• استفاده از Credential با Permission ناکافی
• فعال کردن Bucket Versioning بدون طراحی صحیح
• فعال کردن Lifecycle Rule بدون هماهنگی با JetBackup
• حذف دستی Objectهای JetBackup
• استفاده از یک Backup Directory مشترک برای چند Destination
• انتخاب Storage بسیار دور از Location سرور
• نادیده گرفتن هزینه Egress
• تست نکردن Restore
• نگهداری تمام Backupها فقط روی سرور اصلی

چک‌لیست

پس از مطالعه این مقاله باید بتوانید:

• یک Bucket برای JetBackup ایجاد کنید.
• Access Key و Secret Key ایجاد کنید.
• S3 Plugin را در JetBackup بررسی کنید.
• S3 Compatible Destination ایجاد کنید.
• Custom S3 Endpoint تنظیم کنید.
• Bucket و Region را تنظیم کنید.
• Backup Directory ایجاد کنید.
• Verify SSL را تنظیم کنید.
• Backup Job را به S3 متصل کنید.
• اولین Backup را اجرا کنید.
• Logهای Backup را بررسی کنید.
• مشکلات Permission و Connection را عیب‌یابی کنید.
• Backup را Restore و صحت آن را آزمایش کنید.

مطالعات بیشتر و منابع رسمی

برای مطالعه مستندات رسمی JetBackup می‌توانید از منابع زیر استفاده کنید:

• JetBackup – S3 Compatible Destination
• JetBackup – Destinations
• JetBackup – Immutable Backups
• JetBackup – Destination API

جمع‌بندی

اتصال S3 Storage به JetBackup یکی از روش‌های مناسب برای انتقال Backupها از سرور اصلی به یک فضای ذخیره‌سازی مستقل است. برای راه‌اندازی آن ابتدا باید در سرویس S3 یک Bucket و Credential شامل Access Key و Secret Key ایجاد کنید و سپس در JetBackup یک S3 Compatible Destination بسازید.

در هنگام پیکربندی باید اطلاعاتی مانند Bucket، Region، Endpoint، Access Key، Secret Key و Backup Directory با دقت وارد شوند. پس از ایجاد Destination نیز باید آن را به Backup Job متصل کرده و حداقل یک Backup و Restore آزمایشی انجام دهید.

مهم‌تر از صرفاً ایجاد Backup، اطمینان از قابل بازیابی بودن Backup است. بنابراین بررسی Logها، اجرای Restore آزمایشی، کنترل Retention و مانیتورینگ ظرفیت Storage باید بخشی از فرآیند دائمی مدیریت JetBackup باشد.

همچنین نباید Objectهای ایجادشده توسط JetBackup را مستقیماً در Bucket تغییر یا حذف کنید، زیرا JetBackup برای S3 از ساختار Object Storage و Metadata اختصاصی خود استفاده می‌کند و تغییر دستی این اطلاعات می‌تواند فرآیند Restore یا Integrity Backup را با مشکل مواجه کند.