톱
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 리소스의 자동 완성을 지원합니다. 현재 버킷 이름, 인스턴스 ID 및 인스턴스 태그가 포함되어 있으며 개발 중인 더 많은 리소스에 대한 추가 지원이 포함되어 있습니다.
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
일치하는 ID를 가진 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에서 호스팅됩니다. 다음 명령은 AWS CLI와 같은 종속성과 함께 SAWS 설치합니다.
$ pip install saws
아직 PyPI에 푸시되지 않은 변경 사항을 포함할 수 있는 GitHub 소스에서 최신 SAWS 설치할 수도 있습니다.
$ pip install git+https://github.com/donnemartin/saws.git
virtualenv에 설치하지 않는 경우 sudo 사용하여 실행하세요.
$ sudo pip install saws
설치가 완료되면 SAWS 시작합니다.
$ saws
종속성 또는 권한과 관련된 잠재적인 문제를 방지하려면 virtualenv에 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
여러 Python 환경에서 tox를 사용하여 단위 테스트를 실행합니다.
$ tox
소스 코드 문서는 Readthedocs.org에서 볼 수 있습니다.
문서를 작성하려면 다음을 실행하세요.
$ scripts/update_docs.sh
기여를 환영합니다!
다음 방법에 대한 자세한 내용은 기여 지침을 검토하세요.
SAWS 지원하기 위한 AWS의 AWS CLISAWS 생성을 단순화하기 위한 jonathanslenders의 Python Prompt ToolkitSAWS 생성에 영감을 주고 몇 가지 편리한 유틸리티 기능을 제공한 j-bennet의 Wharfee 문제, 질문 또는 의견에 대해 논의하려면 언제든지 저에게 연락하십시오.
저는 오픈 소스 라이선스에 따라 이 저장소의 코드와 리소스를 귀하에게 제공하고 있습니다. 이것은 내 개인 저장소이기 때문에 귀하가 내 코드와 리소스에 대해 받는 라이선스는 내 고용주(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.
