CLI 다운로드

Classic/VPC 환경에서 이용 가능합니다.

Ncloud CLI를 설치하는 방법을 설명합니다.

설치

운영체제(Windows, Linux)에 해당하는 CLI 파일을 다운로드해 주십시오. CLI는 항상 최신 버전 상태로 유지해야 정상적인 동작이 가능합니다.

버전	게시 날짜	파일
1.1.29	2026-04-23	CLI_1.1.29_20260423.zip (281 MB) cli_linux: Linux 환경의 설치 파일 cli_windows: Windows 환경의 설치 파일

다운로드한 CLI 파일은 Windows 환경용과 Linux 환경용이 있습니다. 두 파일의 구조는 같으며, 환경에 따라 실행 방법이 다릅니다.

jre8: Ncloud CLI는 Java를 이용해서 개발되어 JRE(Java Runtime Environment)가 필요합니다. CLI 폴더에는 JRE 8이 포함되어 있으므로 CLI를 운영하는 환경에서 이미 JRE나 JDK가 설치되어 있을 경우 참고해 주십시오. (Java 1.8 이상에서 구동)alr
lib: CLI 관련 .jar 파일이 있는 폴더입니다.
ncloud: CLI jar 파일을 실행하기 위한 스크립트 파일입니다. Windows, Linux 환경에 따라 파일 확장자가 상이합니다.

주의

CLI 1.0.17 이하 버전에서는 JDK 1.7을 사용했으나 CLI 1.0.18 이후 버전에서는 JDK 1.8을 사용하고 있습니다. 따라서 JDK 1.9 이상 버전에서 구동 시에는 문제가 발생할 수 있습니다.
내부 JDK 사용 시 스크립트도 변경이 필요합니다.

다운로드한 폴더 경로로 이동한 후 ncloud 명령어를 실행하여 CLI가 정상적으로 설치되었는지 확인합니다.

cd C:\Users\{username}\Downloads\CLI_1.1.28_20260122\cli_windows
ncloud

cd ~/Downloads/CLI_1.1.28_20260122/cli_linux
./ncloud

다음과 같은 메시지가 출력되면 CLI가 정상적으로 설치된 것입니다.

ncloud <command> [subcommand] help

ncloud: error: The command does not exist. For help, input 'help' command.

참고

위 메시지는 명령어를 지정하지 않아 출력되는 안내 메시지이며, CLI 설치 오류가 아닙니다.

포함된 JRE 파일이 아니라 기존 로컬 환경에 이미 설치되어 있는 JRE, JDK를 이용할 경우, ncloud 스크립트 파일에서 ./jre8/bin/java를 java로 변경합니다. 기존 로컬 환경에 JRE 또는 JDK가 설치되어 있어야 합니다.

수정 전

#!/bin/bash
HOME='./lib'
/jre8/bin/java -jar ${HOME}/ncloud-api-cli-1.0.2-SNAPSHOT-jar-with-dependencies.jar $@

수정 후

#!/bin/bash
HOME='./lib'
java -jar ${HOME}/ncloud-api-cli-1.0.2-SNAPSHOT-jar-with-dependencies.jar $@