صورة آلة الأمازون هو قالب يُستخدم لبدء تشغيل مثيلات EC2. تشبه AMI المخطط الذي يحتوي على نظام التشغيل وجميع البرامج الضرورية أو تكوينات التطبيقات للمثيلات. يمكن أن تكون وحدات AMI مبنية مسبقًا أو مُدارة بشكل مخصص. تعد AWS CLI أداة مساعدة قوية للوصول إلى الصور وإدارتها عبر أوامر بسيطة مثل 'وصف الصور' يأمر. ال 'وصف الصور' يتم استخدام الأمر لسرد كافة AMIs التي تم تكوينها لحساب معين.
مخطط سريع
وفي هذا المقال سنتعرف على:
ما هو أمر 'وصف الصور' في AWS CLI؟
ال 'وصف الصور' الأمر في AWS CLI عبارة عن عملية مرقّمة يتم استخدامها لسرد جميع وحدات AMI أو محددة داخل الحساب. إخراج ال 'وصف الصور' الأمر موجود في نموذج القائمة الذي يحتوي على معلومات حول الصور المختلفة. يمكن أن تكون هذه الصور عامة أو خاصة أو محددة من قبل المستخدم أو مُدارة بواسطة AWS. يتم الوصول إلى بيانات AMI من خلال استدعاءات API المتعددة للخدمة عند تمكين ترقيم الصفحات.
اقرأ أكثر: كيفية تعطيل الصفحة في AWS CLI؟
كيفية استخدام أمر 'وصف الصور' في AWS CLI؟
الصور التي تم إلغاء تسجيلها هي تلك التي تتم إزالتها من AWS ولم تعد مدعومة بواسطة خدمة EC2 والنظام الأساسي. ومع ذلك، يتم تضمين هذه الصور أيضًا في إخراج الملف 'وصف الصور' يأمر. يمكن للمستخدم التحكم في إخراج الأمر عن طريق التصفية أو الاستعلام أو تحديد AMI معين وما إلى ذلك من خلال معلمات مختلفة متعددة.
بناء الجملة
بناء الجملة من 'وصف الصور' يتم إعطاء الأمر على النحو التالي:
وصف الصور aws ec2 < خيارات >
خيارات
فيما يلي وصف مختصر للخيارات الموجودة في الأمر المذكور أعلاه:
| خيار | الأوصاف |
| – المستخدمين القابلين للتنفيذ | يتم استخدام هذه المعلمة لاستخراج AMIs وإدراجها بناءً على أذونات المستخدم. يمكن للمستخدم إما تحديد 'الذات' أو 'الكل' أو معرف حساب AWS. |
| -المرشحات | يتم استخدام المعلمة –filters لسرد تفاصيل محددة أو AMIs في المخرجات. هناك أنواع مختلفة من عوامل التصفية يدعمها هذا الأمر: - اسم: يمكن للمستخدم تصفية AMIs عن طريق تحديد الاسم. - بطاقة هوية المالك: يمكن لمعرف حساب AWS أيضًا تصفية AMIs من خلال وصف تلك الصور التي تم تكوينها داخل حساب معين فقط. - بطاقة شعار: العلامات هي مزيج من أزواج القيمة الرئيسية. من خلال تحديد العلامات، يمكن للمستخدم بسهولة تصفية AMIs لحساب معين. - معرف الصورة: هناك طريقة أخرى لتصفية AMIs وهي تحديد معرف الصورة. سيؤدي هذا إلى سرد AMI محدد فقط. |
| – معرفات الصور | تقوم هذه المعلمة بإدخال معرف AMI. |
| -أصحاب | تقبل المعلمة –owner معرف الحساب، أو self، أو amazon، أو خيارات aws-marketplace. ستقوم هذه الخيارات بإدراج وحدات AMI التي تتطابق تمامًا مع الخيار المحدد فقط. |
| -تضمين-إهمال | يتم استخدام هذه المعلمة لتحديد ما إذا كان سيتم إدراج AMIs المهملة أم لا. إن وحدات AMI المهملة هي تلك الصور التي لم يعد يوصى باستخدامها. |
| -تشمل معطل | يحدد هذا الحقل ما إذا كان سيتم إدراج AMIs المعطلة في المخرجات أم لا. |
| -ركض جاف | يتم استخدام المعلمة –dry-run لتحديد ما إذا كان المستخدم لديه إذن للإجراء المطلوب أم لا. تقوم بإرجاع الإخراج بتنسيق الخطأ. علاوة على ذلك، إذا كان المستخدم لديه الأذونات، فسوف يحتوي الإخراج على 'DryRunOperation'. إذا لم يكن المستخدم مجهزًا بهذا الإذن، فسوف يُرجع 'UnauthorizedOperation' في الإخراج. |
| -cli-input-json | تُستخدم هذه المعلمة لتوفير تعليمات JSON متعددة مرة واحدة في شكل قالب لخدمات AWS. يتم إنشاء القالب المتبع بواسطة المعلمة '–generate-cli-skeleton'. |
| -رمز البداية | تقوم هذه المعلمة بإدخال قيمة حقل 'NextToken' من الإخراج. يرمز NextToken إلى وجود المزيد من البيانات لإدراجها. عندما يتم توفير قيمة NextToken إلى –starting-token، سيبدأ في سرد البيانات من الاستجابة السابقة. |
| -مقاس الصفحه | تحدد هذه المعلمة حجم الصفحة في كل استدعاء خدمة AWS. يؤدي حجم الصفحة الأصغر إلى المزيد من استدعاءات واجهة برمجة التطبيقات (API) التي تمنع خطأ المهلة. ومع ذلك، فإنه يسترد بيانات أقل في كل مكالمة. |
| -الحد الأقصى للعناصر | يتم استخدام المعلمة –max-items لتحديد عدد الإدخالات التي سيتم عرضها في الإخراج. |
| – إنشاء هيكل عظمي cli | يقوم بإنشاء هيكل عظمي أو قالب يجب اتباعه عند تقديم تعليمات متعددة لخدمة AWS في وقت واحد. |
بخلاف هذه الخيارات، هناك أيضًا خيارات عالمية تقدمها AWS. الخيارات العامة شائعة في أمر AWS CLI ويمكن استخدامها مع أوامر مختلفة. ال وثائق AWS يناقش مختلف الخيارات العالمية.
أمثلة
يناقش هذا القسم من المقالة أمثلة مختلفة 'وصف الصور' الأمر في AWS CLI:
- المثال 1: كيفية وصف الصور في AWS CLI؟
- المثال 2: كيفية وصف جميع الصور في AWS CLI؟
- مثال 3: كيفية وصف AMI حسب معرف المالك في AWS CLI؟
- المثال 4: كيفية تصفية الصور في AWS CLI؟
- مثال 5: كيفية الاستعلام عن AMI في AWS CLI؟
- المثال 6: كيفية وصف الصور المهملة في AWS CLI؟
- المثال 7: كيفية وصف الصور الممكّنة أو المعطلة في AWS CLI؟
- المثال 8: كيفية وصف الصور بتنسيقات إخراج متعددة؟
المثال 1: كيفية وصف الصور في AWS CLI؟
ال 'وصف الصور' يتم استخدام الأمر في AWS CLI لسرد تفاصيل AMI محددة لحساب معين. يتطلب هذا الأمر معرف الصورة الخاص بـ AMI. قم بزيارة خدمة EC2 وانقر فوق 'أيّ' الخيار من جزء التنقل الأيسر. حدد صورة الإنشاء وسيعرض تكوينات الصورة. في حدود تفاصيل القسم، انسخ واحفظ معرف AMI:
يتم إعطاء الأمر بإدراج AMI محدد كما يلي:
وصف الصور aws ec2 --منطقة AP-جنوب شرق- 1 --image-ids < AMIImageID >
استبدل
انتاج |
المثال 2: كيفية وصف جميع الصور في AWS CLI؟
الأمر الخاص بإدراج جميع الصور المتوفرة في AWS CLI هو كما يلي:
وصف الصور aws ec2
انتاج |
سيستغرق هذا بعض الوقت لعرض قائمة بجميع الصور. استمر في الضغط على 'يدخل' من لوحة المفاتيح لعرض تفاصيل جميع الصور:
مثال 3: كيفية وصف AMI حسب معرف المالك في AWS CLI؟
يمكن أيضًا تحديد AMIs التي تم تكوينها داخل حساب AWS بواسطة المالك أو معرف الحساب. يمكن تحديد معرف الحساب بالنقر فوق اسم المستخدم في الزاوية العلوية اليمنى من وحدة الإدارة في AWS. انقر على 'ينسخ' أيقونة لنسخ معرف الحساب:
يتم تخصيص الأمر بمعلمة إضافية بالطريقة التالية:
وصف الصور aws ec2 --أصحاب < معرف الحساب >
استبدل <معرف الحساب> باستخدام معرف حساب AWS الخاص بك.
انتاج |
المثال 4: كيفية تصفية الصور في AWS CLI؟
هناك مرشحات مختلفة متاحة لاستخراج تفاصيل محددة من الصورة. يمكن للمستخدم تصفية الصور حسب معرف المالك، أو معرف الصورة، أو العلامات، أو الاسم أو الحالة، وما إلى ذلك. ولإدراج صورة حسب اسمها، يتم استخدام الأمر التالي:
وصف الصور aws ec2 --filters 'الاسم = الاسم، القيم = ec2image'
استبدل 'ec2image' في القيم باسم AMI الخاص بك.
انتاج |
يمكن تحديد قيمة أزواج القيمة الرئيسية لعلامة AMI عن طريق تحديد AMI من لوحة معلومات AMI. سيعرض هذا تكوينات الصورة. اضغط على 'العلامات' علامة التبويب ونسخ قيمة حقول القيمة الرئيسية:
لتصفية صورة حسب علاماتها، يتم إعطاء الأمر أدناه:
وصف الصور aws ec2 --filters 'الاسم=العلامة:المفتاح الأول، القيم=الأول'
استبدل 'المفتاح الأول' في حقل الاسم بالمفتاح. وبالمثل، استبدل 'أولاً' في القيم بقيمة العلامة.
انتاج |
مثال 5: كيفية الاستعلام عن AMI في AWS CLI؟
يمكن للمستخدم استخراج تفاصيل محددة لصورة من القائمة المعروضة باستخدام '-استفسار' معامل. يتم إعطاء الأمر على النحو التالي:
وصف الصور aws ec2 --استفسار 'الصور[*].[ImageId]'
انتاج |
وبالمثل، يمكن للمستخدم أيضًا الاستعلام عن تفاصيل معينة لصورة ما عن طريق تحديد معرف الصورة باستخدام معلمة الاستعلام:
وصف الصور aws ec2 --معرف الصورة < AMIIs > --استفسار 'صورة [*].[نوع الصورة، الوصف، الحالة]'
انتاج |
المثال 6: كيفية وصف الصور المهملة في AWS CLI؟
وحدات AMI المهملة هي تلك الصور التي لم يعد يوصى باستخدامها بواسطة AWS. لتحديد الصور التي تم إهمالها، استخدم الأمر الموضح كما يلي:
وصف الصور aws ec2 --include-مهملة
انتاج |
وبالمثل، يمكن للمستخدم أيضًا تحديد '-عدم التضمين-إهمال' المعلمة لسرد جميع الصور بما في ذلك الصور المهملة:
وصف الصور aws ec2 --no-include-deprecated
انتاج |
المثال 7: كيفية وصف الصور الممكّنة أو المعطلة في AWS CLI؟
ال 'وصف الصور' يمكن أيضًا استخدام الأمر لسرد تلك الصور المعطلة أو غير المعطلة للحساب. سيساعد هذا المستخدمين في تحديد أجهزة AMI التي سيتم استخدامها. يتم استخدام الأمر الوارد أدناه لسرد AMIs التي تم تعطيلها للحساب:
وصف الصور aws ec2 --تشمل معطل
انتاج |
وبالمثل، فإن 'وصف الصور' يقوم الأمر بإرجاع فقط تلك AMIs التي لم يتم تعطيلها لحساب معين. لهذا الغرض، استخدم الأمر أدناه:
وصف الصور aws ec2 --لا يشمل معطل
انتاج |
المثال 8: كيفية وصف الصور بتنسيقات إخراج متعددة؟
هناك تنسيقات إخراج متعددة يدعمها ملف 'وصف الصور' يأمر. تتضمن التنسيقات YAML، أو JSON، أو النص، أو الجدول. فيما يلي الأمر الخاص بوصف الصور بتنسيق جدولي:
وصف الصور aws ec2 --انتاج طاولة
استبدل 'طاولة' القيمة في حقل الإخراج بتنسيق إخراج مختلف من اختيارك مثل JSON أو YAML أو النص.
انتاج |
يضعط 'يدخل' من لوحة المفاتيح للاستمرار في إدراج البيانات:
خاتمة
ال 'وصف الصور' يقوم الأمر في AWS بإرجاع قائمة بجميع وحدات AMI أو محددة لحساب معين. فهو يقبل المعلمات الاختيارية، على سبيل المثال، -query، -output، وما إلى ذلك 'وصف الصور' يعد الأمر مفيدًا لمطوري AWS لأنه يساعدهم على الفهم والاختيار بين AMIs المختلفة لتطبيقاتهم. قبل استخدام 'وصف الصور' الأمر، تأكد من تكوين AWS CLI على أجهزتك المحلية، ثم قم بتوفير الأوامر المذكورة إلى الجهاز الطرفي. توفر هذه المقالة فهمًا متعمقًا لل 'وصف الصور' الأمر مع أمثلة متعددة لمناقشة معلماته المختلفة.