[ NCP CLI ] 설치 및 실행

해당 글은 NCP CLI 설치 및 사용 방법에 대해 기재하였습니다. 

목차
▶ 설치파일 다운로드
▶ API 계정 등록
▶ PATH 등록하기

▶ 설치파일 다운로드 

NCP CLI 파일 다운로드 경로 ➡️링크 

wget  "https://www.ncloud.com/api/support/download/files/cli/CLI_1.1.16_20230822.zip"

#압축 해제
unzip CLI_1.1.16_20230822.zip
------------------------------------------
drwxr-xr-x  4 root root 4096 Nov  9 03:00 cli_linux/
drwxr-xr-x  4 root root 4096 Nov  9 03:00 cli_windows/
------------------------------------------

압축해제하면 Linux 환경 설치 파일과 Windows 환경 설치 파일이 있습니다.

Linux 환경 설치 파일에는 아래와 같은 파일들이 있으며 api 계정 등록을 하면 바로 사용이 가능합니다.

drwxr-xr-x 6 root root  4096 Nov  9 03:00 jre8/
drwxr-xr-x 2 root root  4096 Nov  9 03:00 lib/
-rwxr-xr-x 1 root root   101 Nov  9 03:00 ncloud*
-rwxr-xr-x 1 root root 37181 Nov  9 03:00 NOTICE*
-rwxr-xr-x 1 root root   508 Nov  9 03:00 README.md*

• jre8 - JRE 1.8이 설치되어있는 폴더 (특정 운영환경에 종속적이지 않도록 하기 위해서 첨부)
• lib - CLI 관련 .jar파일이 있는 폴더
• ncloud - CLI jar파일을 실행하기 위한 스크립트파일

 

▶ API 계정 등록

./ncloud configure
----------------------
access key:
secreat key: 
api 도메인: 
----------------------

⚠️ 콘솔 마이페이지 → 계정관리 → 인증키 관리 에 있는 API 인증키는 root 권한을 가지고 있으므로 사용하지 않는 것을 권장드립니다, 

 

Sub Accounts에서 API Gateway 접근 권한만 있는 서브 계정을 생성하여 사용하는 것을 권장드립니다.
자세한 방법은 아래 ⬇️ " 더보기 "를 클릭하시기 바랍니다. 

 

개별 권한 추가로 필요한 권한을 추가해 줍니다. 더 자세한 내용은 ➡️ 서비스별 권한 정보 페이지를 참고하시기 바랍니다.

 

Access Key 추가를 통해 ID와 Secret Key 정보를 확인할 수 있습니다.
한 서브 계정에는 최대 2개의 Access Key를 생성할 수 있습니다.

 

▶ PATH 등록하기 

NCP CLI 명령어를 간편하게 사용하기 위해 PATH 등록을 하는 것을 추천 드립니다.  

1) ncloud 파일의 상대경로를 절대 경로로 변경

(예시)

/root/cli_linux/jre8/bin/java -jar /root/cli_linux/lib/ncloud-api-cli-1.1.5-SNAPSHOT-jar-with-dependencies.jar "$@"

 

2) PATH 지정

🚨 주의 : "export PATH = 새로 등록할 스크립트 경로" 는 기존 환경변수에 덮어쓰기 이므로 주의하여야 합니다!  

[ 일시적인 PATH 지정 ]
 export PATH = $PATH:새로등록할 스크립트 경로 

(예시)

export PATH=$PATH:/root/cli_linux/

#수정한 환경설정 파일 바로 적용
source ~/.bashrc

---

[ 영구적인 PATH 지정 ]
# 지역 환경 변수 : 특정 사용자에게만 적용 -  ~/.bashrc 
# 전역 환경 변수 : 모든 사용자에게 적용 -  /etc/profile.d/path명.sh 

(예시)

vi ~/.bashrc 
--맨 밑줄에 추가------------------
export PATH=$PATH:/root/cli_linux/
----------------------------------

#수정한 환경설정 파일 바로 적용
source ~/.bashrc

바이너리 파일을 /usr/local/bin/ 경로 밑에 옮긴 후 "export PATH=$PATH:/usr/local/bin/" PATH 지정해도 됩니다.