EPS (Easy Project Setup)

프로젝트 설정과 배포를 쉽게 도와주는 CLI 도구입니다.

특징

• 🚀 즉시 사용 가능: 로그인 없이 바로 배포 실행
• ⚡ 빠른 실행: 네트워크 요청 없이 로컬에서 즉시 처리
• 🔧 단순한 워크플로우: 복잡한 인증 과정 제거
• 🔄 기능 보존: 필요시 온라인 모드로 모든 기능 사용 가능

설치

npm install -g easy-project-setup

사용법

기본 사용 (추천)

# 로컬 설정 파일로 즉시 배포 실행
eps run

# 로컬에서만 프로젝트 설정
eps setup

오프라인 모드 강제

# 토큰이 있어도 강제로 오프라인 모드로 실행
eps run --offline
eps setup --offline

온라인 모드 (백엔드 연동)

온라인 기능을 사용하려면 먼저 로그인이 필요합니다:

# 로그인
eps login --id=your_username --password=your_password

# 온라인 전용 명령어들
eps upload      # 백엔드에 설정 업로드
eps download    # 백엔드에서 설정 다운로드
eps subscribe   # Kafka 구독 관리
eps request     # 배포 요청 전송

동작 방식

스마트한 모드 자동 선택

EPS CLI는 사용자의 인증 상태에 따라 자동으로 적절한 모드를 선택합니다:

• 토큰이 있는 경우: 온라인 모드로 동작 (백엔드 연동)
• 토큰이 없는 경우: 자동으로 오프라인 모드로 동작 (로컬 전용)
• --offline 플래그: 토큰이 있어도 강제로 오프라인 모드

설정 파일

프로젝트 루트에 project.setup.json 파일을 생성하여 배포 설정을 관리합니다:

{
  "title": "My Project",
  "setup": {
    "runCommand": "npm run build && docker build -t my-app . && docker run my-app"
  },
  "release": {
    "command": "npm run release"
  },
  "deploy": {
    "command": "npm run deploy"
  }
}

명령어 목록

로컬/온라인 모두 지원

• eps run - 설정된 명령어 실행
• eps setup - 프로젝트 설정 구성

온라인 전용 (로그인 필요)

• eps login - 사용자 로그인
• eps upload - 백엔드에 설정 업로드
• eps download - 백엔드에서 설정 다운로드
• eps subscribe - Kafka 구독 관리
• eps request - 배포 요청 전송

마이그레이션 가이드

기존 사용자

기존에 로그인을 사용하던 사용자는 그대로 온라인 모드로 동작합니다. 변경사항이 없습니다.

새로운 사용자

로그인 없이 바로 eps run 명령어를 사용할 수 있습니다. 로컬 project.setup.json 파일만 있으면 즉시 배포가 가능합니다.

개발 정보

• Node.js: >= 10
• 플랫폼: Linux, macOS (Windows 지원 예정)
• 라이센스: ISC