مناشير
0.4.2
على الرغم من أن AWS CLI يعد موردًا رائعًا لإدارة الخدمات التي تدعمها AWS، إلا أنه من الصعب تذكر استخدام ما يلي:
تهدف SAWS إلى تعزيز AWS CLI بميزات تركز على:
تحت الغطاء، يتم تشغيل SAWS بواسطة AWS CLI ويدعم نفس الأوامر وبنية الأوامر .
استخدام SAWS و AWS CLI :
aws [parameters] [options]
ميزات SAWS :
SAWS متاح لأنظمة التشغيل Mac، وLinux، وUnix، وWindows.
يمكنك التحكم في القالب الذي سيتم تحميله لتمييز بناء الجملة عن طريق تحديث ملف ~/.sawsrc الخاص بك:
# Visual theme. Possible values: manni, igor, xcode, vim, autumn, vs, rrt,
# native, perldoc, borland, tango, emacs, friendly, monokai, paraiso-dark,
# colorful, murphy, bw, pastie, paraiso-light, trac, default, fruity
theme = vim
يوفر SAWS الإكمال التلقائي الذكي أثناء الكتابة. سيؤدي إدخال الأمر التالي إلى إدراج جميع الأوامر الفرعية الخاصة بـ ec2 وإكمالها تلقائيًا بشكل تفاعلي:
aws ec2
بالإضافة إلى الأوامر الافتراضية والأوامر الفرعية والخيارات التي يوفرها AWS CLI، يدعم SAWS الإكمال التلقائي لموارد AWS الخاصة بك. حاليًا، يتم تضمين أسماء الحاوية ومعرفات المثيلات وعلامات المثيلات، مع دعم إضافي لمزيد من الموارد قيد التطوير.
خيار s3api :
--bucket
استخدام العينة:
aws s3api get-bucket-acl --bucket
بناء الجملة لـ s3 :
s3://
استخدام العينة:
aws s3 ls s3://
ملاحظة: يوضح المثال أدناه استخدام إكمال الموارد الغامضة:
خيار ec2 :
--instance-ids
استخدام العينة:
aws ec2 describe-instances --instance-ids
aws ec2 ls --instance-ids
ملاحظة: يوضح الأمر ls استخدام الاختصارات القابلة للتخصيص:
خيار ec2 :
--ec2-tag-key
--ec2-tag-value
استخدام العينة:
aws ec2 ls --ec2-tag-key
aws ec2 ls --ec2-tag-value
تدعم العلامات أحرف البدل التي تحتوي على الحرف * .
ملاحظة: يوضح ls و --ec2-tag-value و --ec2-tag-key استخدام الاختصارات القابلة للتخصيص:
لا تتردد في إرسال مشكلة أو طلب سحب إذا كنت ترغب في الحصول على دعم للحصول على موارد إضافية.
يحتوي الملف ~/.saws.shortcuts على اختصارات يمكنك تعديلها. يأتي مزودًا مسبقًا بالعديد من الاختصارات المفيدة خارج الصندوق. يمكنك الجمع بين الاختصارات والإكمال غير الواضح لضغطات مفاتيح أقل. وفيما يلي بعض الأمثلة.
قم بإدراج كافة مثيلات EC2:
aws ec2 ls
قم بإدراج كافة مثيلات EC2 قيد التشغيل:
aws ec2 ls --ec2-state running # fuzzy shortcut: aws ecstate
قم بإدراج جميع مثيلات EC2 بعلامة مطابقة (يدعم أحرف البدل * ):
aws ec2 ls --ec2-tag-key # fuzzy shortcut: aws ectagk
aws ec2 ls --ec2-tag-value # fuzzy shortcut: aws ectagv
قم بإدراج مثيل EC2 بالمعرف المطابق:
aws ec2 ls --instance-ids # fuzzy shortcut: aws eclsi
قم بإدراج جميع جداول DynamoDB:
aws dynamodb ls # fuzzy shortcut: aws dls
قائمة بجميع مجموعات السجلات الطبية الإلكترونية:
aws emr ls # fuzzy shortcut: aws emls
قم بإضافة/إزالة/تعديل الاختصارات في ملف ~/.saws.shortcuts الخاص بك ليناسب احتياجاتك.
لا تتردد في تقديم:
لتبديل الإكمال الغامض لموارد واختصارات AWS، استخدم المفتاح F3 .
عينة من الاختصارات الغامضة لبدء وإيقاف مثيلات EC2:
aws ecstop
aws ecstart
ملاحظة: يعمل الإكمال الغامض حاليًا فقط مع موارد واختصارات AWS.
يدعم SAWS الاقتراحات التلقائية بنمط السمكة. استخدم مفتاح right arrow لإكمال الاقتراح.
يتيح لك SAWS تنفيذ أوامر shell من موجه saws> .
يقوم SAWS بتتبع الأوامر التي تدخلها ويخزنها في ~/.saws-history . استخدم مفاتيح الأسهم لأعلى ولأسفل للتنقل عبر سجل الأوامر.
يدعم SAWS help سطر الأوامر السياقية docs الويب السياقية.
يتم تشغيل أمر help بواسطة AWS CLI ويتم إخراج المساعدة داخل سطر الأوامر.
الاستخدام:
aws help
في بعض الأحيان لا تكون متأكدًا تمامًا من مجموعة الأوامر/الأوامر الفرعية/الخيارات المحددة التي تحتاج إلى استخدامها. في مثل هذه الحالات، يعد تصفح عدة مجموعات باستخدام سطر أوامر help أمرًا مرهقًا مقارنة بتصفح مستندات AWS CLI عبر الإنترنت من خلال متصفح الويب.
يدعم SAWS مستندات الويب السياقية باستخدام أمر docs أو المفتاح F9 . سيعرض SAWS مستندات الويب الخاصة بالأمر والأمر الفرعي الذي تم إدخاله حاليًا.
الاستخدام:
aws docs
يدعم SAWS عددًا من خيارات شريط الأدوات:
F2 بتبديل تمييز بناء جملة الإخراجF3 بتبديل الإكمال الغامض لموارد واختصارات AWSF4 بتبديل إكمال الاختصاراتF5 بتحديث الموارد للإكمال التلقائيF9 مستندات الويب السياقيةF10 أو control d يخرج من SAWS تم اختبار SAWS على نظامي التشغيل Windows 7 وWindows 10.
على نظام التشغيل Windows، يمكن العثور على ملف .sawsrc في %userprofile% . على سبيل المثال:
C:Usersdmartin.sawsrc
على الرغم من أنه يمكنك استخدام موجه أوامر Windows القياسي، فمن المحتمل أن يكون لديك تجربة أفضل مع cmder أو conemu.
تتم استضافة SAWS على PyPI. سيقوم الأمر التالي بتثبيت SAWS مع التبعيات مثل AWS CLI:
$ pip install saws
يمكنك أيضًا تثبيت أحدث إصدار SAWS من مصدر GitHub والذي يمكن أن يحتوي على تغييرات لم يتم دفعها بعد إلى PyPI:
$ pip install git+https://github.com/donnemartin/saws.git
إذا لم تكن تقوم بالتثبيت في virtualenv، فقم بتشغيله باستخدام sudo :
$ sudo pip install saws
بمجرد التثبيت، ابدأ تشغيل SAWS :
$ saws
يوصى بتثبيت حزم Python في بيئة افتراضية لتجنب المشكلات المحتملة المتعلقة بالتبعيات أو الأذونات.
لعرض تعليمات تثبيت SAWS virtualenv وDocker، انقر هنا.
هناك مشكلة معروفة في Apple وتبعيات حزمة python المضمنة (مزيد من المعلومات على pypa/pip#3165). نحن نبحث عن طرق لإصلاح هذه المشكلة، ولكن في هذه الأثناء، لتثبيت المناشير، يمكنك تشغيل:
$ sudo pip install saws --upgrade --ignore-installed six
قم بتكوين بيانات الاعتماد الخاصة بك باستخدام AWS CLI:
$ aws configure
إذا كنت ترغب في استخدام ملف تعريف مسمى محدد مع SAWS ، فقم بتشغيل الأوامر التالية على OS X أو Linux أو Unix:
$ export AWS_DEFAULT_PROFILE=user1
$ saws
أو كبطانة واحدة:
$ AWS_DEFAULT_PROFILE=user1 saws
يمكن لمستخدمي Windows تشغيل الأوامر التالية:
> set AWS_DEFAULT_PROFILE=user1
> saws
خيارات سطر الأوامر لبدء SAWS بملف تعريف محدد قيد التطوير. لمزيد من التفاصيل حول كيفية تثبيت وتكوين AWS CLI، راجع الوثائق التالية.
يشير اختبار الضوء إلى أن SAWS يبدو أيضًا متوافقًا مع Python 3.5.
Pypy3 غير مدعوم بسبب نقص الدعم من boto.
إذا كنت مهتمًا بالمساهمة في SAWS ، فقم بتشغيل الأوامر التالية:
$ git clone https://github.com/donnemartin/saws.git
$ pip install -e .
$ pip install -r requirements-dev.txt
$ saws
تتوفر تفاصيل التكامل المستمر على Travis CI.
تتوفر تفاصيل إدارة التبعيات على Gemnasium.
قم بإجراء اختبارات الوحدة في بيئة Python النشطة الخاصة بك:
$ python tests/run_tests.py
قم بتشغيل اختبارات الوحدة باستخدام tox في بيئات Python المتعددة:
$ tox
وثائق كود المصدر متاحة على موقع Readthedocs.org.
قم بتشغيل ما يلي لإنشاء المستندات:
$ scripts/update_docs.sh
المساهمات هي موضع ترحيب!
قم بمراجعة إرشادات المساهمة للحصول على تفاصيل حول كيفية:
SAWS تحت الغطاءSAWSSAWS وبعض وظائف المرافق المفيدة لا تتردد في الاتصال بي لمناقشة أي مشاكل أو أسئلة أو تعليقات.
أقدم لك التعليمات البرمجية والموارد في هذا المستودع بموجب ترخيص مفتوح المصدر. نظرًا لأن هذا هو المستودع الشخصي الخاص بي، فإن الترخيص الذي تحصل عليه للأكواد والموارد الخاصة بي هو مني وليس من صاحب العمل (Facebook).
Copyright 2015 Donne Martin
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
