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

مدیریت ابرک

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

مرور کلی​

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

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

دستورها​

۱. نمایش لیست ابرک‌ها​

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

arvan iaas server list

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

فلگ‌ها:

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

مثال:

$ arvan iaas server list --region=ir-central1

خروجی:

ID            NAME           STATUS  AZ              FLAVOR        IMAGE            IP
srv-12345678  web-server-01  ACTIVE  ir-central1-a   g1-2-4        Ubuntu 22.04     185.10.200.15
srv-23456789  db-server-01   ACTIVE  ir-central1-a   g1-4-8        CentOS 8         185.10.200.16
srv-34567890  app-server-02  SHUTOFF ir-central1-b   g1-1-2        Debian 11        -

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

نمایش اطلاعات کامل یک ابرک مشخص.

arvan iaas server show <server-id>

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

آرگومان‌ها:

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

مثال:

$ arvan iaas server show srv-12345678

خروجی:

SERVER DETAILS
--------------
ID:         srv-12345678
Name:       web-server-01
Status:     ACTIVE
AZ:         ir-central1-a
Flavor:     g1-2-4 (2 vCPUs و 4 GB RAM)
Image:      Ubuntu 22.04 LTS
Created:    Jan 10 2025 08:30:00 UTC


NETWORK INTERFACES
------------------
NETWORK         IP              TYPE    MAC                PORT_ID                              PORT_SECURITY  SECURITY_GROUPS  PTR
public-network  185.10.200.15   Public  fa:16:3e:aa:bb:cc  port-abc123                          Enabled        default          web.example.com
private-net-01  10.0.1.10       Private fa:16:3e:dd:ee:ff  port-def456                          Enabled        default          -


VOLUMES
-------
DEVICE    VOLUME ID                              SIZE
/dev/vda  vol-1a2b3c4d-5678-90ab-cdef-12345678   50 GB
/dev/vdb  vol-2b3c4d5e-6789-01bc-def0-23456789   100 GB

نکات:

  • در جدول Interfaceهای شبکه، رکوردهای PTR (reverse DNS) برای آی‌پی‌های عمومی نمایش داده می‌شود.
  • وضعیت امنیت پورت و گروه‌های فایروالی برای هر Interface شبکه نمایش داده می‌شود.
  • زمان ساخت ابرک به‌همراه منطقه‌ی زمانی نمایش داده می‌شود.

۳. ساخت ابرک​

ساخت یک ابرک جدید.

arvan iaas server create

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

فلگ‌ها:

  • name-- و n-: نام ابرک جدید (اجباری)
  • flavor-- و f-: شناسه‌ی بسته (اجباری)
  • image-id-- و i-: شناسه‌ی ایمیج (اجباری مگر هنگام استفاده از snapshot-id--)
  • az-- و a-: دیتاسنتر (AZ) برای ساخت ابرک (اجباری)
  • security-groups--: شناسه‌ی گروه‌های فایروالی (می‌توان چند بار مشخص کرد)
  • disk-size-- و d-: اندازه‌ی دیسک بر حسب گیگابایت
  • ssh-key-- و k-: نام کلید SSH
  • networks--: شناسه‌ی شبکه‌ها (می‌توان چند بار مشخص کرد)
  • ha--: فعال‌سازی قابلیت دسترس‌پذیری بالا
  • ipv4--: فعال‌سازی IPv4 (پیش‌فرض: فعال)
  • ipv6--: فعال‌سازی IPv6
  • snapshot-id-- و s-: شناسه‌ی اسنپ‌شات برای ساخت ابرک از روی آن
  • backup-slot-id-- و b-: شناسه‌ی اسلات بکاپ برای ساخت ابرک از روی آن
  • volume-attachment--: دیسک‌های غیر root برای اتصال به ابرک (می‌توان چند بار مشخص کرد)
  • backup-name--: نام پروفایل بکاپ (فقط هنگام استفاده از enable-backup--؛ پیش‌فرض: نام ابرک)
  • enable-backup--: فعال‌سازی بکاپ خودکار
  • force--: نادیده گرفتن تاییدیه‌

مثال:

$ arvan iaas server create \
  --name=web-server-02 \
  --flavor=g3-16-2-0 \
  --image-id=793cdb82-c731-4aeb-808d-19da98525a02 \
  --az=ir-central1-a \
  --disk-size=25 \
  --ssh-key=Alo \
  --security-groups=97986294-f54a-46d8-a5d8-c953dfbe747d \
  --ipv4

خروجی:

SERVER CREATED
--------------
ID:      6924881f-ab13-4fcd-8d42-f41daf413db8
Name:    cli-test-server
Flavor:  g3-16-2-0
Image:   793cdb82-c731-4aeb-808d-19da98525a02
AZ:      ir-central1-a

نکات:

  • حداقل یک گروه فایروالی برای ساخت ابرک الزامی است.
  • برای اطمینان از فضای کافی، مقدار disk-size-- را مشخص کنید (حداقل ۲۵ گیگابایت پیشنهاد می‌شود).
  • برای بررسی نیازمندی‌های ایمیج از <arvan iaas image show <image-id استفاده کنید.
  • برای مشاهده‌ی بسته‌های موجود از <arvan iaas flavor list --az <zone استفاده کنید.
  • برای مشاهده‌ی گروه‌های فایروالی موجود از <arvan iaas security-group list --az <zone استفاده کنید.
  • برای مشاهده‌ی کلیدهای SSH موجود از <arvan iaas ssh-key list --az <zone استفاده کنید.

۴. روشن کردن ابرک​

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

arvan iaas server poweron <server-id>

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

آرگومان‌ها:

  • server-id (اجباری): شناسه‌ی ابرکی که می‌خواهید روشن شود

مثال:

$ arvan iaas server poweron srv-12345678

خروجی:

SERVER POWER ON
---------------
ID:     srv-12345678
Name:   web-server-01
Status: Starting

Server is powering on...

۵. خاموش کردن ابرک​

خاموش کردن یک ابرک در حال اجرا.

arvan iaas server poweroff <server-id>

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

آرگومان‌ها:

  • server-id (اجباری): شناسه‌ی ابرکی که می‌خواهید خاموش شود

مثال:

$ arvan iaas server poweroff srv-12345678

خروجی:

SERVER POWER OFF
----------------
ID:     srv-12345678
Name:   web-server-01
Status: Stopping

Server is powering off...

۶. ری‌استارت ابرک​

ری‌استارت کردن یک ابرک در حال اجرا.

arvan iaas server reboot <server-id>

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

آرگومان‌ها:

  • server-id (اجباری): شناسه‌ی ابرکی که می‌خواهید ریستارت شود

مثال:

$ arvan iaas server reboot srv-12345678

خروجی:

SERVER REBOOT
-------------
ID:     srv-12345678
Name:   web-server-01
Status: Rebooting

Server is rebooting...

۷. تغییر نام ابرک​

تغییر نام یک ابرک.

arvan iaas server rename <server-id>

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

آرگومان‌ها:

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

فلگ‌ها:

  • new-name-- و n-: نام جدید ابرک (اجباری)

مثال:

$ arvan iaas server rename srv-12345678 --new-name=production-web-01

خروجی:

SERVER RENAMED
--------------
ID:       srv-12345678
Old Name: web-server-01
New Name: production-web-01

Server renamed successfully!

۸. بازنشانی رمز عبور root ابرک​

بازنشانی رمز عبور root ابرک. این عملیات یک رمز عبور تصادفی جدید تولید کرده و نمایش می‌دهد.

arvan iaas server reset-pass <server-id>

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

آرگومان‌ها:

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

فلگ‌ها:

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

مثال:

$ arvan iaas server reset-pass 747a7d8a-7de6-4b83-9048-81cd74ca3f20

خروجی:

⚠️  Are you sure you want to reset the root password for server '747a7d8a-7de6-4b83-9048-81cd74ca3f20'? (y/n) y

PASSWORD RESET SUCCESSFUL:
Server ID:         747a7d8a-7de6-4b83-9048-81cd74ca3f20
New Root Password: KJJLECubrg

مثال با فلگ force--:

$ arvan iaas server reset-pass 747a7d8a-7de6-4b83-9048-81cd74ca3f20 --force

خروجی:

PASSWORD RESET SUCCESSFUL:
Server ID:         747a7d8a-7de6-4b83-9048-81cd74ca3f20
New Root Password: KJJLECubrg

نکات:

  • این عملیات به‌شکل آنی رمز عبور root را بازنشانی می‌کند.
  • رمز عبور جدید را در مکانی امن ذخیره کنید؛ امکان بازیابی مجدد آن وجود ندارد.
  • برای رد کردن تاییدیه در اسکریپت‌های خودکار، از force-- استفاده کنید.
  • رمز عبور به‌شکل تصادفی توسط سرور تولید می‌شود.

۹. دریافت لینک کنسول VNC​

دریافت لینک کنسول VNC برای دسترسی به کنسول مجازی ابرک. این لینک به مدت ۲۰ دقیقه معتبر است.

arvan iaas server get-vnc-link <server-id>

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

آرگومان‌ها:

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

مثال:

$ arvan iaas server get-vnc-link 747a7d8a-7de6-4b83-9048-81cd74ca3f20

خروجی:

VNC CONSOLE LINK:
Server ID: 747a7d8a-7de6-4b83-9048-81cd74ca3f20
VNC URL:   https://console.arvaniaas.ir/ir-thr-ba1/vnc_auto.html?token=85d5db66-f00a-4593-bc16-7b2ea46b16c4
Note:      This link is valid for 20 minutes

نکات:

  • لینک VNC دسترسی مرورگری به کنسول ابرک را فراهم می‌کند.
  • این لینک به دلایل امنیتی پس از ۲۰ دقیقه منقضی می‌شود.
  • هنگامی که SSH در دسترس نیست، می‌توانید از این روش برای اتصال به ابرک استفاده کنید.
  • برای عیب‌یابی مشکلات بوت یا شبکه بسیار کاربردی است.

۱۰. ترمینیت کردن ابرک​

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

برخلاف حذف، ابرک هم‌چنان وجود دارد اما غیرعملیاتی می‌شود. از این دستور زمانی استفاده کنید که می‌خواهید یک ابرک را به‌طور همیشگی غیرفعال کنید بدون آن‌که حذف شود. هنگام نیاز، این عملیات با دستور poweron‍ قابل بازگشت است.

arvan iaas server terminate <server-id>

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

آرگومان‌ها:

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

فلگ‌ها:

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

مثال:

$ arvan iaas server terminate srv-12345678

خروجی:

SERVER TO TERMINATE
-------------------
ID:     srv-12345678
Name:   web-server-01
Status: ACTIVE
Flavor: g1-2-4
Image:  Ubuntu 22.04
AZ:     ir-central1-a


Are you sure you want to terminate server 'web-server-01'? (y/n) y

✓ SERVER TERMINATED SUCCESSFULLY
---------------------------------
Server ID:   srv-12345678
Server Name: web-server-01

نکات:

  • این عملیات با حذف ابرک متفاوت است؛ در این حالت ابرک هم‌چنان وجود دارد.
  • برای رد کردن تاییدیه در اسکریپت‌های خودکار، از force-- استفاده کنید.
  • این عملیات دایمی نیست و با دستور poweron‍ قابل بازگشت است.

۱۱. حذف ابرک​

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

arvan iaas server delete <server-id>

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

آرگومان‌ها:

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

فلگ‌ها:

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

مثال:

$ arvan iaas server delete srv-12345678

خروجی (بدون وابستگی):

SERVER TO DELETE
----------------
ID:     srv-12345678
Name:   web-server-01
Status: ACTIVE
Flavor: g1-2-4
Image:  Ubuntu 22.04
AZ:     ir-central1-a

Are you sure you want to delete server 'web-server-01'? (y/n) y

✓ SERVER DELETED SUCCESSFULLY
------------------------------
Server ID:   srv-12345678
Server Name: web-server-01

خروجی (با وابستگی):

SERVER TO DELETE
----------------
ID:     srv-12345678
Name:   web-server-01
Status: ACTIVE
Flavor: g1-2-4
Image:  Ubuntu 22.04
AZ:     ir-central1-a

⚠️  WARNING: ASSOCIATED RESOURCES FOUND
----------------------------------------
Snapshots:      1 snapshot(s) found
  - Snapshot:   web-server-snapshot (snap-abc12345)

These resources must be deleted before deleting the server.

Do you want to delete these associated resources? (y/n) y

Deleting snapshots...
  ✓ Deleted snapshot: web-server-snapshot

Are you sure you want to delete server 'web-server-01'? (y/n) y

✓ SERVER DELETED SUCCESSFULLY
------------------------------
Server ID:   srv-12345678
Server Name: web-server-01

Associated Resources Deleted:
  Snapshots: 1

نکات:

  • دستور به‌طور خودکار بکاپ‌ها و اسنپ‌شات‌های مرتبط را شناسایی می‌کند.
  • پیش از حذف ابرک، باید وابستگی‌ها را تایید کنید.
  • برای رد کردن تمام تاییدیه‌ها در اسکریپت‌های خودکار، از force-- استفاده کنید.
  • حذف ابرک، دایمی و غیرقابل بازگشت است.

جدول دستورها​

دستورنام مستعارتوضیحآرگومان‌ها
server listlsنمایش لیست تمام ابرک‌هاندارد
server showshنمایش جزئیات یک ابرک<server-id>
server createcrساخت ابرک جدیدندارد
server poweronponروشن کردن ابرک<server-id>
server poweroffpofخاموش کردن ابرک<server-id>
server rebootrbریستارت ابرک<server-id>
server renamernتغییر نام ابرک<server-id>
server reset-passrpبازنشانی رمز عبور root ابرک<server-id>
server get-vnc-linkvncدریافت لینک کنسول VNC<server-id>
server terminatetermترمینیت ابرک (قابل بازگشت با poweron)<server-id>
server deletedelحذف ابرک<server-id>