เลื่อย
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 ทั้งหมดด้วยแท็กที่ตรงกัน (รองรับ wildcard * ):
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
แสดงรายการคลัสเตอร์ EMR ทั้งหมด:
aws emr ls # fuzzy shortcut: aws emls
เพิ่ม/ลบ/แก้ไขทางลัดในไฟล์ ~/.saws.shortcuts ของคุณเพื่อให้เหมาะกับความต้องการของคุณ
รู้สึกอิสระที่จะส่ง:
หากต้องการสลับทรัพยากรและทางลัด AWS ให้สมบูรณ์อย่างคลุมเครือ ให้ใช้ปุ่ม F3
ตัวอย่างทางลัดที่ไม่ชัดเจนเพื่อเริ่มและหยุดอินสแตนซ์ EC2:
aws ecstop
aws ecstart
หมายเหตุ: ปัจจุบันการทำงานแบบคลุมเครือใช้งานได้กับทรัพยากรและทางลัดของ AWS เท่านั้น
SAWS รองรับการแนะนำอัตโนมัติแบบ Fish ใช้ปุ่ม right arrow เพื่อกรอกคำแนะนำ
SAWS ช่วยให้คุณสามารถรันคำสั่งเชลล์จากพรอมต์ saws>
SAWS ติดตามคำสั่งที่คุณป้อนและเก็บไว้ใน ~/.saws-history ใช้ปุ่มลูกศรขึ้นและลงเพื่อวนดูประวัติคำสั่ง
SAWS รองรับ help บรรทัดคำสั่งตามบริบทและ docs เว็บตามบริบท
คำสั่ง help ขับเคลื่อนโดย AWS CLI และส่งออกความช่วยเหลือภายในบรรทัดคำสั่ง
การใช้งาน:
aws help
บางครั้งคุณอาจไม่แน่ใจว่าจำเป็นต้องใช้ชุดคำสั่ง/คำสั่งย่อย/ตัวเลือกใด ในกรณีเช่นนี้ การเรียกดูหลายชุดโดยใช้บรรทัดคำสั่ง help เป็นเรื่องที่ยุ่งยากเมื่อเทียบกับการเรียกดูเอกสาร AWS CLI ออนไลน์ผ่านเว็บเบราว์เซอร์
SAWS รองรับเอกสารเว็บตามบริบทด้วยคำสั่ง docs หรือปุ่ม F9 SAWS จะแสดงเอกสารเว็บเฉพาะสำหรับคำสั่งและคำสั่งย่อยที่ป้อนในปัจจุบัน
การใช้งาน:
aws docs
SAWS รองรับตัวเลือกแถบเครื่องมือจำนวนหนึ่ง:
F2 สลับการเน้นไวยากรณ์เอาต์พุตF3 สลับการทำให้ทรัพยากรและทางลัดของ AWS สมบูรณ์อย่างคลุมเครือF4 สลับการเสร็จสิ้นทางลัด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 ใน virtualenv เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นกับการขึ้นต่อกันหรือการอนุญาต
หากต้องการดูคำแนะนำในการติดตั้ง 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 โปรดดูเอกสารประกอบต่อไปนี้
การทดสอบแบบ Light บ่งชี้ว่า 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 ภายใต้ประทุนSAWS ง่ายขึ้นSAWS และฟังก์ชันอรรถประโยชน์ที่มีประโยชน์บางอย่าง อย่าลังเลที่จะติดต่อฉันเพื่อหารือเกี่ยวกับปัญหา คำถาม หรือความคิดเห็น
ฉันกำลังมอบโค้ดและทรัพยากรในพื้นที่เก็บข้อมูลนี้ให้กับคุณภายใต้ใบอนุญาตโอเพ่นซอร์ส เนื่องจากนี่คือพื้นที่เก็บข้อมูลส่วนตัวของฉัน ใบอนุญาตที่คุณได้รับสำหรับโค้ดและทรัพยากรของฉันจึงมาจากฉัน ไม่ใช่นายจ้างของฉัน (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.
