5분 만에 첫 서비스 배포하기

CLI 도구와 AI로 더 쉽게

예상 소요시간: 약 5분

1
2
3
4
5
6
1

회원가입 및 API 키 발급

DropTheCodes를 사용하려면 먼저 계정을 만들고 API 키를 발급받아야 합니다.

API 키 발급 방법: 로그인 후 콘솔 > 프로필 > API 키 생성 버튼을 클릭하세요.

2

CLI 도구 설치

터미널에서 다음 명령어를 실행하여 dtc CLI를 설치합니다.

macOS / Linux

curl -fsSL https://dropthe.codes/install.sh | sh

Windows (PowerShell)

iwr -useb https://dropthe.codes/install.ps1 | iex

Homebrew (macOS)

brew install drop-the-codes/tap/dtc

# 설치 확인

dtc --version
3

CLI 인증 설정

발급받은 API 키로 CLI를 인증합니다. 아래 방법 중 하나를 선택하세요.

API 키 발급 방법

  1. 로그인 후 좌측 메뉴의 프로필 클릭
  2. 페이지 하단 API 키 섹션에서 "API 키 생성" 버튼 클릭
  3. 생성된 키(dtc_로 시작) 복사

API 키는 생성 시 한 번만 표시됩니다. 안전한 곳에 보관하세요.

방법 1: 대화식 로그인 (권장)

# API 키를 입력하면 설정 파일에 자동 저장됩니다

dtc login

방법 2: 직접 설정

# 설정 파일에 저장

dtc config set api-key dtc_your_api_key_here

방법 3: 환경변수 (CI/CD 환경에 적합)

export DTC_API_KEY="dtc_your_api_key_here"

# 연결 확인

dtc ls
4

프로젝트 배포

프로젝트 폴더에서 dtc deploy 명령어를 실행합니다.

# 자동 감지 배포 (프로젝트 타입 자동 인식)

dtc deploy

# 이름과 포트 지정

dtc deploy --name my-app --port 3000

# 리소스, 도메인, 볼륨까지 지정하는 고급 배포

dtc deploy --name my-app --port 3000 --cpu 500m --memory 512Mi --replicas 2 --domain my-app.example.com --volume my-storage:/data --env-file .env

주요 배포 옵션

--name 서비스 이름
--port 컨테이너 포트
--image Docker 이미지
--domain 커스텀 도메인
--cpu CPU 제한
--memory 메모리 제한
--replicas 복제본 수
--volume 스토리지:경로
--env 환경변수
--env-file .env 파일 경로
🟢

Node.js

🐍

Python

🐹

Go

🐳

Docker

5

AI 연동 (MCP)

MCP(Model Context Protocol)를 설치하면 Claude Code나 Claude Desktop에서 자연어로 배포를 관리할 수 있습니다.

# MCP 서버 설치

dtc mcp install

# Claude Code 또는 Claude Desktop 재시작

Claude에서 사용 가능한 명령 예시:

  • > "현재 프로젝트를 DropTheCodes에 배포해줘"
  • > "my-app 서비스 상태 확인해줘"
  • > "환경변수 DATABASE_URL을 설정해줘"
  • > "서비스 로그에서 에러 찾아줘"
6

배포 확인 및 관리

CLI 또는 웹 콘솔에서 배포된 서비스를 확인하고 관리합니다.

# 서비스 목록 조회

dtc ls

# 서비스 상세 정보

dtc describe my-app

# 로그 확인

dtc logs my-app --tail 100

# 서비스 설정 업데이트

dtc update my-app --image nginx:latest --cpu 1000m

# 재시작 / 정지 / 시작

dtc restart my-app | dtc stop my-app | dtc start my-app

# 서비스 삭제

dtc delete my-app

웹 콘솔에서 관리하기

GUI로 서비스 상태, 로그, 설정을 관리합니다.

콘솔 열기

준비가 되셨나요?

지금 바로 첫 번째 서비스를 배포해보세요.