پرش به مطلب اصلی

مدیریت فایل استوریج

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

مرور کلی

دستورهای file-storage ابزارهایی برای مدیریت دیسک‌های اشتراکی فایل فراهم می‌کند که چند ابرک می‌تواند به‌طور هم‌زمان از طریق پروتکل NFS به آن‌ها دسترسی داشته باشد. دیسک‌های فایل استوریج از طریق شبکه‌ی خصوصی در یک Availability Zone در دسترس هستند.

شناسه مستعار (Alias): fs

دستورها

۱. فهرست فایل استوریج‌ها

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

arvan iaas file-storage list

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

فلگ‌ها:

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

مثال:

$ arvan iaas file-storage list --az=ir-central1-a

خروجی:

ID                                    NAME           STATUS     SIZE (GB)  NETWORK           AZ
fs1a2b3c-5678-90ab-cdef-123456789012 shared-data available 100 private-net-01 ir-central1-a
fs2b3c4d-6789-01bc-def0-234567890123 app-storage available 200 vpc-network-02 ir-central1-a
fs3c4d5e-7890-12cd-ef01-345678901234 backup-fs available 500 private-net-01 ir-central1-b

۲. نمایش جزییات فایل استوریج

اطلاعات دقیق یک دیسک فایل استوریج مشخص را نمایش می‌دهد.

arvan iaas file-storage show <file-storage-id>

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

آرگومان‌ها:

  • file-storage-id (الزامی): شناسه‌ی دیسک فایل استوریج

مثال:

$ arvan iaas file-storage show fs1a2b3c-5678-90ab-cdef-123456789012

خروجی:

FILE STORAGE VOLUME DETAILS
---------------------------
ID: fs1a2b3c-5678-90ab-cdef-123456789012
Name: shared-data
Status: available
AZ: ir-central1-a
Size (GB): 100
Connected Private Network: private-net-01
Connected Private Network ID: net-12345678-abcd-efgh-ijkl-123456789abc

Private IPs
• 192.168.1.10 (Network ID: subnet-12345678)
• 192.168.1.11 (Network ID: subnet-12345678)

Export Location Path:
192.168.1.10:/shares/share-abc123def456

ATTACHED TO
-----------
INSTANCE_ID INSTANCE OS ACCESS_LEVEL ACCESS_RIGHT_ID PRIVATE_IP
srv-11111111 web-server-01 Linux Read-Write ar-11111111-2222-3333-4444-555555555555 192.168.1.50
srv-22222222 app-server-01 Linux Read-Only ar-22222222-3333-4444-5555-666666666666 192.168.1.51

۳. ساخت فایل استوریج

یک دیسک فایل استوریج جدید می‌سازد.

arvan iaas file-storage create <new-file-storage-name>

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

آرگومان‌ها:

  • new-file-storage-name (الزامی): نام دیسک فایل استوریج جدید

فلگ‌ها:

  • network-- و n-: شناسه‌ی شبکه‌ی خصوصی (الزامی)
  • az-- و a-: دیتاسنتر برای ساخت فایل استوریج (الزامی)
  • size-- و s-: اندازه‌ی دیسک بر حسب گیگابایت (پیش‌فرض: ۵۰)
  • force-- و f-: نادیده گرفتن تاییدیه

مثال:

$ arvan iaas file-storage create shared-storage --network=net-12345678 --az=ir-central1-a --size=150

خروجی:

CREATE NEW FILE STORAGE VOLUME
------------------------------
Name: shared-storage
Size (GB): 150
AZ: ir-central1-a
Network ID: net-12345678-abcd-efgh-ijkl-123456789abc
Network Name: private-net-01
CIDR: 192.168.1.0/24

Are you sure you want to create new file storage volume 'shared-storage' to network 'private-net-01' in AZ 'ir-central1-a? (y/n) y

New file storage volume 'shared-storage' is created under network ID 'net-12345678-abcd-efgh-ijkl-123456789abc'

۴. اتصال فایل استوریج

یک فایل استوریج را به یک ابرک متصل (Attach) می‌کند.

arvan iaas file-storage attach <file-storage-id>

شناسه مستعار: att

آرگومان‌ها:

  • file-storage-id (الزامی): شناسه‌ی دیسک فایل استوریج برای اتصال

فلگ‌ها:

  • instance-- و i-: شناسه‌ی ابرک (الزامی)
  • access-level-- و a-: سطح دسترسی ابرک (ro: فقط خواندنی، rw: خواندنی-نوشتنی، پیش‌فرض: ro)
  • force-- و f-: نادیده گرفتن تاییدیه

مثال:

$ arvan iaas file-storage attach fs1a2b3c-5678-90ab-cdef-123456789012 --instance=srv-12345678 --access-level=rw

خروجی:

ATTACH FILE STORAGE VOLUME TO SERVER
------------------------------------
Server: web-server-01 (srv-12345678)
File Storage Volume: shared-data (fs1a2b3c-5678-90ab-cdef-123456789012)
Subnet: private-net-01 (net-12345678-abcd-efgh-ijkl-123456789abc)
Size (GB): 100
Access Level: Read-Write
AZ: ir-central1-a

Are you sure you want to attach file storage volume 'shared-data' to instance(server) 'web-server-01'? (y/n) y

File Storage Volume 'shared-data' is attached to server ID 'srv-12345678'.

۵. جداسازی فایل استوریج

یک دیسک فایل استوریج را از یک ابرک جدا (Detach) می‌کند.

arvan iaas file-storage detach <file-storage-id>

شناسه مستعار: det

آرگومان‌ها:

  • file-storage-id (الزامی): شناسه‌ی دیسک فایل استوریج برای جداسازی

فلگ‌ها:

  • access-right-id-- و a-: شناسه‌ی Access Right که ابرک متصل را مشخص می‌کند (الزامی)
  • force-- و f-: نادیده گرفتن تاییدیه

مثال:

$ arvan iaas file-storage detach fs1a2b3c-5678-90ab-cdef-123456789012 --access-right-id=ar-11111111-2222-3333-4444-555555555555

خروجی:

DETACH FILE STORAGE VOLUME FROM SERVER
--------------------------------------
Server: web-server-01 (srv-12345678)
File Storage Volume: shared-data (fs1a2b3c-5678-90ab-cdef-123456789012)
Subnet: private-net-01 (net-12345678-abcd-efgh-ijkl-123456789abc)
Size (GB): 100
Access Level: Read-Write
AZ: ir-central1-a
Make sure all read/write operations have been completed. Otherwise و it can cause data loss.

Are you sure you want to detach file storage volume 'shared-data' from instance(server) 'web-server-01'? (y/n) y

File Storage Volume 'shared-data' is detached from server 'web-server-01'.

۶. تغییر نام فایل استوریج

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

arvan iaas file-storage rename <file-storage-id> <new-name>

شناسه مستعار: rn

آرگومان‌ها:

  • file-storage-id (الزامی): شناسه‌ی دیسک فایل استوریج برای تغییر نام
  • new-name (الزامی): نام جدید دیسک فایل استوریج

فلگ‌ها:

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

مثال:

$ arvan iaas file-storage rename fs1a2b3c-5678-90ab-cdef-123456789012 production-storage

خروجی:

RENAME FILE STORAGE VOLUME
--------------------------
Current Name: shared-data
New Name: production-storage
Current Size (GB): 100
AZ: ir-central1-a
Network Name: private-net-01

Are you sure you want to rename file storage volume 'shared-data' to 'production-storage'? (y/n) y

file storage volume 'shared-data' is renamed.

۷. تغییر اندازه‌ی فایل استوریج

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

arvan iaas file-storage resize <file-storage-id> <new-volume-size>

شناسه مستعار: in

آرگومان‌ها:

  • file-storage-id (الزامی): شناسه‌ی دیسک فایل استوریج برای تغییر اندازه
  • new-volume-size (الزامی): اندازه‌ی جدید بر حسب گیگابایت (باید بیش‌تر از اندازه‌ی فعلی باشد)

فلگ‌ها:

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

  • مثال:

$ arvan iaas file-storage resize fs1a2b3c-5678-90ab-cdef-123456789012 200

خروجی:

INCREASE FILE STORAGE VOLUME SIZE
---------------------------------
Name: shared-data
Current Size (GB): 100
New Size (GB): 200
AZ: ir-central1-a
Network Name: private-net-01

Are you sure you want to increase the size of file storage volume 'shared-data'? (y/n) y

file storage volume 'shared-data' is resized.

توجه داشته باشید که اندازه‌ی دیسک‌های فایل استوریج فقط قابل افزایش است و نمی‌توان آن را کاهش داد.

۸. حذف فایل استوریج

یک دیسک فایل استوریج را حذف می‌کند.

arvan iaas file-storage delete <file-storage-id>

شناسه مستعار: del

آرگومان‌ها:

  • file-storage-id (الزامی): شناسه‌ی دیسک فایل استوریج برای حذف

فلگ‌ها:

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

مثال:

$ arvan iaas file-storage delete fs1a2b3c-5678-90ab-cdef-123456789012

خروجی:

DELETE NEW FILE STORAGE VOLUME
------------------------------
Name: shared-data
Size (GB): 100
AZ: ir-central1-a
Network ID: net-12345678-abcd-efgh-ijkl-123456789abc
Network Name: private-net-01

Private IPs
• 192.168.1.10 (Network ID: subnet-12345678)
• 192.168.1.11 (Network ID: subnet-12345678)

Are you sure you want to delete file storage volume 'shared-data'? (y/n) y

file storage volume 'shared-data' is deleted.

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

جدول دستورها

دستورشناسه مستعارتوضیحآرگومان‌ها
file-storage listlsفهرست تمام دیسک‌های فایل استوریجندارد
file-storage showshنمایش جزییات یک دیسک فایل استوریج<file-storage-id>
file-storage createcrساخت یک دیسک فایل استوریج جدید<new-file-storage-name>
file-storage attachattاتصال فایل استوریج به ابرک<file-storage-id>
file-storage detachdetجداسازی فایل استوریج از ابرک<file-storage-id>
file-storage renamernتغییر نام دیسک فایل استوریج<file-storage-id> <new-name>
file-storage resizeinافزایش اندازه‌ی دیسک فایل استوریج<file-storage-id> <new-volume-size>
file-storage deletedelحذف دیسک فایل استوریج<file-storage-id>

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

  • اتصال شبکه: دیسک‌های فایل استوریج فقط توسط ابرک‌هایی که به همان شبکه‌ی خصوصی در همان Availability Zone متصل هستند قابل دسترسی هستند.
  • پروتکل NFS: فایل استوریج از پروتکل NFS برای دسترسی اشتراکی استفاده می‌کند.
  • دسترسی چند ابرکی: چندین ابرک می‌توانند به‌طور هم‌زمان به یک دیسک فایل استوریج دسترسی داشته باشند.
  • سطوح دسترسی:
    • ro (فقط خواندنی): ابرک فقط می‌تواند داده‌ها را بخواند
    • rw (خواندنی-نوشتنی): ابرک می‌تواند داده‌ها را بخواند و بنویسد
  • محدودیت اندازه: فقط امکان افزایش اندازه‌ی دیسک‌های فایل استوریج وجود دارد.