- Original Code from https://github.com/minsu/ucloud
- Forked and Revised by Jioh L. Jung (ziozzang@gmail.com)
The Python Commandline Tool & library for UCloud.
유클라우드 서버 API를 이용한 파이썬 클라이언트 라이브러리 및 Command Line 유틸리티 프로그램입니다.
- PIP으로 설치 하는 경우
라이브러리로 사용 할경우에는 pip/PyPI로 설치 하면 됩니다.
pip install ucloud
- Git 으로 클론 하기.
별도 설치없이 Git 클론한 후에 해당 폴더에서 명령을 실행하거나 해당 파이썬 모듈을 import UClient 한 후에 사용합니다. 명령어 실행은 다음의 Example과 같이 Command Line 환경에서 실행 합니다.
python UClient.py server listVirtualMachines
python UClient.py server deployVirtualMachine serviceofferingid=75 templateid=845 zoneid=2 diskofferingid=38 usageplantype=hourly
...
python UClient.py server queryAsyncJobResult jobid=19993
python UClient.py lb listLoadBalancers
python UClient.py waf listWAFs
-
파일에 직접 수정
-
Client.py 를 열어서 API_KEY 와 SECRET 을 수정 하거나, 환경 변수로 설정 할수 있다.
-
환경 변수로 설정
-
API/SECRET Key 설정:
UCLOUD_API_KEY,UCLOUD_SECRET가 환경 변수로 설정 되어 있으면 해당 값을 읽어서 씁니다. (export 또는 윈도에서 set 으로 설정 하면 됩니다) -
출력 형식 지정: 기본은 JSON 출력이나, XML 출력을 하고 싶으면 환경변수에
UCLOUD_RESP_TYPE를 xml 로 세팅 해주시면 됩니다. -
코드로 실행 하는 경우, 파라미터로 넘겨 주는 방법
-
client = UClient.UClient(api_type="package", api_key=UCLOUD_API_KEY, secret=UCLOUD_SECRET)와 같이 파라미터로 넘겨줌
./UClient.py [api_type] [command] [params1] [param2]...
기본 실행 형식입니다.
예를들어 zoneID 를 얻는 API는 다음과 같습니다.
관련 API 문서 http://developer.ucloudbiz.olleh.com/doc/cloudstack/etc/listZones/
./UClient.py server listZones
예를들어 WAF 생성 API 는 다음과 같습니다.
관련 API 문서 http://developer.ucloudbiz.olleh.com/doc/waf/WAF/createWAF-A/
./UClient.py waf name=wafname type=single spec=basic zoneid=9845bd17-d438-4bde-816d-1b12f37d5080 waf1consoleport=5950 waf1SSHport=5951 waf1DBport=5952
파이썬 모듈로 사용할때에는 다음과 같이 사용하면 됩니다.
import json
from ucloud import UClient
client = UClient.UClient(api_type="server", api_key="API_KEY_HERE", secret="SECRET_KEY_HERE")
params = {
"parameter1":"value1",
}
post_data = {
"body1": "longbody1",
}
resp = client.run("Command", params, post=post_data) # POST 로 넘기는 경우
resp = client.run("Command", params) # POST를 쓰지 않는 경우
중간에 들어가는 api_type 은 다음을 확인해주시면 됩니다.
현재 디버깅은 코드로 작성 하는 경우에만 지원 합니다. 파라미터를 넣어 실행할때에 debug=True 로 실행 해주면 됩니다.
client.run(.... , debug=True)
프로그램 사용상 주의할 점들입니다.
- 실행하기 전에 API 키 값과 Secret Key 값을 설정 해 주어야 명령들이 동작합니다.
- 일부 명령어의 경우 Command Line 실행시 보기 편한 형태로 출력되지만, 필요한 필드가 빠져있을 수 있습니다. 또한 대부분의 명령은 서버가 회신한 JSON/XML 데이터를 출력합니다.
- 모듈로 사용할 경우 모든 데이터는 JSON 데이터로 처리되어야 합니다.
- 커맨드 라인으로 명령어를 호출할 경우 오직 GET 방식으로 요청 됩니다.
- 잘못된 명령에 대한 서버의 반응은 별도의 에러메시지도 출력되지만 XML포맷으로된 에러 메시지가 출력 됩니다.
destroyVirtualMachine과 같은 명령은stopVirtualMachine이 이루어 진 다음에 실행되어야 정상 동작합니다.
유클라우드 서버 API 전체가 사용가능합니다, 테스트 해 본 것은 VM 관련한 명령과 Port Forwarding 관련 명령 뿐입니다.
유클라우드 로드밸런서 API 지원이 추가되었습니다. (2012. 11. 13)
유클라우드 웹 방화벽 API 지원이 추가되었습니다. (2013. 02. 20)
유클라우드 Package API 지원이 추가 되었습니다. (2013. 08. 19)
유클라우드 전체 API 지원이 추가 되었습니다. (2013. 08. 23)
PIP/PyPI 에서 설치가 가능합니다. (2013. 09. 09)
commands.py 에 명시되어 있는 각 명령에는 default 라는 Dictionary 데이터가 있습니다. 기본 값으로 지정할 경우 명령창에서 별도로 지정하지 않는 한 해당 default 값이 사용됩니다. 현재 deployVirtualMachine 명령의 기본값은 kr-1b 존에 Ubuntu 11.04 32bit, 1vCore, 1GB RAM, 100GB Disk 시간제 요금이 들어가 있습니다.
commands.py 에 명시 되어 있지 않은 명령어도 실행에는 문제가 없으며 API 문서를 보고 적절한 파라미터를 명시하면 명령어를 사용할수 있습니다.
0.1A : 2012. 03. 19 Release
0.2A : 2012. 11. 13
0.3A : 2013. 02. 20
0.3A-Forked-ziozzang-v1 : 2013. 08. 19
0.3A-Forked-ziozzang-v3 : 2013. 08. 23
1.0 : 2013. 09. 09