dashcloud deploy CLI 완전 정복 가이드
업데이트: 2026-10-10
DashCloud CLI(dashcloud)는 웹 브라우저를 열지 않고도 로컬 터미널, VS Code 통합 터미널, GitHub Actions CI/CD 파이프라인에서 프로젝트를 즉시 배포하고 제어할 수 있는 공식 커맨드라인 도구입니다.
npx로 전역 설치 없이 항상 최신 버전을 실행할 수 있으며, 배포부터 로그·상태·환경변수·백업 관리까지 터미널에서 끝낼 수 있습니다.
1. 인증 및 로그인 (dashcloud login)
대시보드의 API 인증 키에서 발급한 토큰(dc_live_...)을 등록합니다.
npx dashcloud login --key dc_live_your_token_here토큰은 ~/.dashcloud/config.json(0600)에 저장되며, 아래 환경변수로 대체할 수도 있습니다 (CI 권장).
export DASHCLOUD_API_KEY="dc_live_your_token_here"
export DASHCLOUD_API_URL="https://api.dashcloud.kr" # 선택확인:
npx dashcloud whoami2. 프로젝트 배포 (dashcloud deploy)
현재 디렉터리를 tar.gz로 묶어 배포합니다. node_modules·.git·.venv·__pycache__·dist 등은 자동 제외됩니다.
# 프로젝트 이름(또는 id)으로 현재 디렉터리 배포
npx dashcloud deploy --project my-telegram-bot
# 다른 디렉터리 배포
npx dashcloud deploy --project my-telegram-bot --dir ./bot
# 재시작 없이 파일만 올리기
npx dashcloud deploy --project my-telegram-bot --restart=falsedashcloud.json 자동 적용
프로젝트 루트에 dashcloud.json이 있으면 배포 시 runtime·entrypoint·env가 자동으로 적용됩니다. --project를 생략하면 name 값으로 프로젝트를 찾습니다.
{
"name": "my-telegram-bot",
"runtime": "python312",
"entrypoint": "src/main.py",
"env": { "TZ": "Asia/Seoul" }
}# --project 없이 dashcloud.json의 name으로 배포
npx dashcloud deploy주요 플래그
| 플래그 | 타입 | 기본값 | 설명 |
|---|---|---|---|
--project | string | dashcloud.json의 name | 프로젝트 id 또는 이름 |
--dir | string | . | 배포할 로컬 디렉터리 |
--restart | boolean | true | 배포 후 컨테이너 재시작 |
--json | boolean | false | 기계 판독용 JSON 출력 (전역) |
3. 상태·로그·메트릭
# 내 프로젝트 목록
npx dashcloud projects
# 컨테이너 상태 (state/uptime/OOM)
npx dashcloud status my-telegram-bot
# 최근 로그 100줄
npx dashcloud logs my-telegram-bot --lines 100
# CPU·메모리·트래픽 메트릭
npx dashcloud metrics my-telegram-bot
# 최근 배포 이력
npx dashcloud deployments --project my-telegram-botCLI 로그는 최근 N줄 스냅샷입니다. 실시간 tail 스트리밍은 대시보드 프로젝트 ➔ 콘솔 탭의 웹소켓 콘솔을 사용하세요.
4. 환경변수·백업·GitHub
# 워크스페이스 시크릿 목록
npx dashcloud env
# 시크릿 저장 + 프로젝트에 주입
npx dashcloud env set TELEGRAM_BOT_TOKEN=123456:ABC --project my-telegram-bot
# 시크릿 삭제
npx dashcloud env rm TELEGRAM_BOT_TOKEN
# 백업 목록 / 생성은 대시보드에서, 복원 확인은 CLI에서
npx dashcloud backups my-telegram-bot
# 연결된 GitHub 저장소 목록
npx dashcloud github전체 커맨드: login · whoami · projects · deploy · deployments · status · logs · metrics · env · backups · github
5. GitHub Actions CI/CD 파이프라인 연동
저장소 Settings ➔ Secrets and variables ➔ Actions에 DASHCLOUD_API_KEY를 등록한 뒤 아래 워크플로우를 추가하면, main 푸시마다 자동 배포됩니다.
name: Deploy to DashCloud
on:
push:
branches:
- main
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: 소스 코드 체크아웃
uses: actions/checkout@v4
- name: Node.js 런타임 설정
uses: actions/setup-node@v4
with:
node-version: 20
- name: DashCloud 클라우드로 자동 배포
run: npx -y dashcloud deploy --project my-bot --dir .
env:
DASHCLOUD_API_KEY: ${{ secrets.DASHCLOUD_API_KEY }}