rsc – RightScale API Client

다중 API 지원

rsc는 RightScale Cloud Management API 1.5 및 1.6, Self-Service API 1.0, RightLink10 API를 모두 지원합니다. 각각의 API는 cm15, cm16, ss, rl10 서브커맨드로 접근할 수 있습니다.

인증 방식 다양성

기본 인증(이메일/비밀번호), OAuth 2.0(리프레시 토큰/액세스 토큰), 인스턴스 API 토큰, RightLink 10 프록시 등 4가지 인증 방식을 지원합니다. 이를 통해 다양한 보안 환경과 자동화 시나리오에 유연하게 대응할 수 있습니다.

응답 데이터 추출 기능

--x1, --xm, --xj 플래그를 사용하여 JSON 응답에서 특정 값을 추출할 수 있습니다. 이는 bash 스크립트와의 연동을 용이하게 하여, 클라우드 목록 추출이나 필터링된 리소스 이름 가져오기와 같은 작업에 유용합니다.

다운로드 및 설치 방법

Windows용 rsc는 ZIP 형식으로 제공되며, 공식 배포 링크에서 다운로드할 수 있습니다. https://binaries.rightscale.com/rsbin/rsc/v9/rsc-windows-amd64.zip 주소에서 파일을 받은 후 압축을 해제하고 실행 파일을 PATH에 추가하거나 원하는 위치에 두면 바로 사용할 수 있습니다. 별도의 설치 과정이나 의존성이 필요하지 않습니다.

기본 사용법 및 명령어

rsc의 일반적인 명령어 구조는 다음과 같습니다: rsc [GLOBAL] [API] ACTION HREF [PARAM=VALUE].

예를 들어, Cloud Management API 1.5를 사용하여 서버 목록을 보려면 다음과 같이 입력합니다: rsc cm15 show /api/servers. 필터를 적용하려면 rsc cm15 show /api/servers 'filter[]=name==LB'와 같이 사용할 수 있습니다.

전역 플래그로는 --help (도움말), --version (버전 확인), --account (계정 ID), --email 및 --pwd (기본 인증), --host (RightScale 호스트), --verbose (상세 로그 출력) 등이 있습니다.

이런 경우에 유용합니다

RightScale 플랫폼을 사용하는 기업이나 클라우드 관리자는 rsc를 통해 서버 생성, 삭제, 목록 조회, 설정 변경 등의 작업을 스크립트로 자동화할 수 있습니다. 특히 정기적인 인벤토리 점검이나 배포 파이프라인 내에서 API 호출이 필요한 경우에 효과적입니다.

지원 환경 및 시스템 요구사항

rsc는 Windows, macOS, Linux에서 실행 가능한 정적 바이너리로 제공됩니다. 별도의 런타임 라이브러리나 의존성이 없으며, 해당 OS용 바이너리를 다운로드하여 바로 실행할 수 있습니다. Windows의 경우 64비트 버전이 제공됩니다.

최신 버전 및 업데이트

현재 버전은 9.0.0이며, 공식 배포 경로는 버전별로 구분되어 있습니다. 예를 들어 v9.0.0은 https://binaries.rightscale.com/rsbin/rsc/v9/ 경로에서 다운로드할 수 있습니다. 동일한 메이저 버전(예: v9) 내에서는 상위 호환성을 유지하도록 설계되었습니다.

제한 사항 및 확인 사항

rsc를 사용하기 위해서는 RightScale 계정과 해당 계정에 대한 적절한 인증 자격 증명(이메일/비밀번호, 토큰 등)이 필요합니다. 인증 없이 API 호출은 불가능하며, RightScale 플랫폼에 대한 접근 권한이 선행되어야 합니다.