clever-tools (Portable)

완전한 플랫폼 제어

명령줄을 통해 애플리케이션, 애드온, 도메인 및 서비스를 완전히 제어할 수 있습니다. 애플리케이션 목록 조회, 생성, 연결, 배포, 로그 스트리밍, 재시작 등의 작업을 모두 터미널에서 수행할 수 있습니다.

실시간 모니터링

배포 중 실시간 로그 스트리밍, 애플리케이션 상태 확인, 모니터링 기능을 제공하여 개발 및 운영 중에 즉시 피드백을 받을 수 있습니다.

원활한 배포

로컬 환경에서 직접 배포하거나 CI/CD 파이프라인에 통합하여 자동화된 워크플로우를 구축할 수 있습니다. clever deploy 명령으로 현재 디렉토리를 배포할 수 있습니다.

API 직접 접근

clever curl 명령을 통해 Clever Cloud의 API에 직접 인증된 접근이 가능하며, 사용자 정보 조회, 플랫폼 요약, 조직 내 애플리케이션 목록 조회, API 토큰 생성 등을 수행할 수 있습니다.

다운로드·설치 방법

Node.js 사용자는 npm을 통해 전역 설치할 수 있습니다:

npm install -g clever-tools

설치 없이 직접 사용하려면 npx를 활용할 수 있습니다:

npx --yes clever-tools@latest version

또한 Docker 이미지, 바이너리 다운로드, 네이티브 패키지(RPM, DEB), 기타 패키지 관리자(Homebrew, WinGet, AUR)를 통한 설치도 지원됩니다. 자세한 설치 가이드는 공식 문서의 setup guide를 참조하십시오.

기본 사용법/명령어

인증

첫 사용 시 인터랙티브 로그인을 수행합니다:

clever login

비대화형 로그인(CI/CD 환경용)도 지원됩니다:

clever login --token --secret

또는 환경 변수를 사용할 수 있습니다:

export CLEVER_TOKEN="your-token"
export CLEVER_SECRET="your-secret"
clever profile

애플리케이션 관리

애플리케이션 목록을 조회합니다:

clever applications list

새로운 Node.js/Bun 애플리케이션을 생성합니다:

clever applications create --type node

현재 디렉토리를 기존 애플리케이션과 연결합니다:

clever link

로그를 스트리밍하여 모니터링합니다 (최근 1시간):

clever logs --since 1h

애플리케이션을 재시작합니다:

clever restart --app

이런 경우에 유용합니다

Clever Cloud 플랫폼에서 애플리케이션을 개발 및 운영하는 개발자에게 유용합니다. 특히 명령줄을 선호하거나 CI/CD 파이프라인에 배포 프로세스를 자동화하려는 팀에게 적합합니다. 로컬에서 개발 중인 애플리케이션을 빠르게 배포하고, 실시간 로그를 확인하며, 애드온 및 서비스를 관리해야 하는 상황에서 이 도구를 사용할 수 있습니다.

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

Clever Tools는 Windows, macOS, Linux에서 실행됩니다. Node.js 22 이상이 설치되어 있어야 하며, 이는 공식 문서에서 명시된 사전 요구사항입니다. 다른 운영 체제나 이전 버전의 Node.js에서는 정상적으로 작동하지 않을 수 있습니다.

최신 버전·업데이트

현재 버전은 0.10.1이며, 이는 Clever Cloud의 공식 CLI 도구로서 최신 기능을 제공합니다. 업데이트는 npm 저장소를 통해 npm update -g clever-tools 명령으로 수행할 수 있습니다.