مدیریت ایمیج‌

مدیریت ایمیج‌های سیستم‌عامل (Machine Images) در سرور ابری آروان‌کلاد.

مرور کلی

دستورهای image ابزارهایی برای مدیریت ایمیج‌هایی که برای ساخت ابرک استفاده می‌شوند، فراهم می‌کند. شما می‌توانید لیست ایمیج‌های در دسترس را مشاهده کنید، ایمیج‌های شخصی خود را آپلود کنید و یا از طریق یک URL خارجی، ایمیج جدیدی را Import کنید.

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

دستورها

۱. لیست ایمیج‌ها

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

arvan iaas image list

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

فلگ‌ها:

• region-- و r-: فیلتر بر اساس کد ریجن (مانند ir-central1)
• az-- و a-: فیلتر بر اساس دیتاسنتر (مانند ir-central1-a)
• type-- و t-: فیلتر بر اساس نوع ایمیج: private (شخصی)، arvan (آروان)، distro (توزیع‌های لینوکس)

مثال:

$ arvan iaas image list --region=ir-central1 --type=private

خروجی:

ID                                    NAME              TYPE     STATUS  AZ              DISTRO    MIN DISK  MIN RAM
a1b2c3d4-5678-90ab-cdef-123456789012  Ubuntu 22.04 LTS  distro   active  ir-central1-a   Ubuntu    10 GB     1024 MB
b2c3d4e5-6789-01bc-def0-234567890123  My Custom Image   private  active  ir-central1-a   -         25 GB     2048 MB
c3d4e5f6-7890-12cd-ef01-345678901234  CentOS 8          distro   active  ir-central1-b   CentOS    10 GB     1024 MB

۲. نمایش جزییات ایمیج

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

arvan iaas image show <image-id>

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

آرگومان‌ها:

• image-id (اجباری): شناسه‌ی ایمیج

مثال:

$ arvan iaas image show a1b2c3d4-5678-90ab-cdef-123456789012

خروجی:

IMAGE DETAILS
-------------
ID:            a1b2c3d4-5678-90ab-cdef-123456789012
Name:          Ubuntu 22.04 LTS
Status:        active
AZ:            ir-central1-a
Distribution:  Ubuntu
Min Disk (GB): 10
Min RAM (MB):  1024

۳. آپلود ایمیج

آپلود ایمیج سیستم‌عامل از یک فایل محلی (Local).

arvan iaas image upload <file-path>

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

آرگومان‌ها:

• file-path (اجباری): مسیر فایل ایمیج در سیستم شما

فلگ‌ها:

• name-- و n-: نام ایمیج آپلودشده (اجباری)
• az-- و a-: دیتاسنتر مقصد برای ذخیره‌ی ایمیج (اجباری)
• min-disk-- و d-: حداقل فضای دیسک مورد نیاز برای استفاده از این ایمیج بر حسب گیگابایت
• min-ram-- و m-: حداقل رم مورد نیاز برای استفاده از این ایمیج بر حسب مگابایت

مثال:

$ arvan iaas image upload /path/to/ubuntu-custom.qcow2 --name="My Ubuntu Image" --az=ir-central1-a --min-disk=20 --min-ram=2048

خروجی:

UPLOAD DETAILS
--------------
File:   ubuntu-custom.qcow2
Size:   2.5 GB
Name:   My Ubuntu Image
Target: ir-central1-a

Uploading image...

Upload Progress: 100%
Image uploaded successfully!

۴. ایمپورت ایمیج از URL

ایمپورت کردن ایمیج سیستم‌عامل از یک آدرس URL خارجی.

arvan iaas image import-url <url>

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

آرگومان‌ها:

• url (اجباری): آدرس مستقیم فایل ایمیج

فلگ‌ها:

• name-- و n-: نام برای ایمیج ایمپورت‌شده (اجباری)
• az-- و a-: دیتاسنتر مقصد برای ذخیره‌ی ایمیج (اجباری)
• min-disk-- و d-: حداقل فضای دیسک مورد نیاز (گیگابایت)
• min-ram-- و m-: حداقل رم مورد نیاز (مگابایت)

مثال:

$ arvan iaas image import-url https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img --name="Ubuntu Jammy" --az=ir-central1-a --min-disk=10 --min-ram=1024

خروجی:

IMPORT DETAILS
--------------
URL:           https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64.img
Name:          Ubuntu Jammy
Target AZ:     ir-central1-a
Min Disk (GB): 10
Min RAM (MB):  1024

Submitting import request...
Import request submitted successfully!

۵. حذف ایمیج

حذف یک ایمیج از حساب کاربری.

arvan iaas image delete <image-id>

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

آرگومان‌ها:

• image-id (اجباری): شناسه‌ی ایمیج مورد نظر برای حذف

فلگ‌ها:

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

مثال:

$ arvan iaas image delete a1b2c3d4-5678-90ab-cdef-123456789012

خروجی:

IMAGE TO DELETE
---------------
ID:            a1b2c3d4-5678-90ab-cdef-123456789012
Name:          My Ubuntu Image
Status:        active
AZ:            ir-central1-a
Distribution:  Ubuntu
Min Disk (GB): 20
Min RAM (MB):  2048

Are you sure you want to delete image 'My Ubuntu Image'? (y/n) y

Image deleted successfully!

جدول دستورها

دستور	شناسه‌ی مستعار	توضیح	آرگومان‌ها
image list	ls	لیست تمام ایمیج‌های در دسترس	ندارد
image show	sh	نمایش جزییات یک ایمیج خاص	<image-id>
image upload	up	آپلود ایمیج از فایل محلی	<file-path>
image import-url	imp	ایمپورت ایمیج از طریق URL	<url>
image delete	del	حذف ایمیج از حساب کاربری	<image-id>

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

• محدودیت منابع: هنگام آپلود یا ایمپورت، دقت کنید که مقادیر min-disk و min-ram را متناسب با نیاز سیستم‌عامل تنظیم کنید تا هنگام ساخت ابرک با مشکل مواجه نشوید.
• دسترسی منطقه‌ای: ایمیج‌های آپلودشده در یک دیتاسنتر (AZ) خاص ذخیره می‌شوند؛ برای استفاده در دیتاسنترهای دیگر، باید در آن‌ها نیز آپلود یا ایمپورت شوند.
• نوع ایمیج: ایمیج‌های distro توسط آروان مدیریت می‌شوند، در حالی که ایمیج‌های private متعلق به پروژه‌ی شما هستند.