Just 커맨드 레퍼런스

Just 커맨드 레퍼런스 (Just Commands Reference)

AgentOps 개발에서 사용 가능한 모든 Just 명령어의 완전한 레퍼런스를 소개해요. 설치부터 설정, 개발, 테스트, Docker 관리 명령어까지 폭넓게 알아볼게요.

출처: 문서

본문

Just 커맨드 레퍼런스

Just는 일반적인 개발 작업을 위한 편리한 단축키를 제공하는 커맨드 러너예요. AgentOps 프로젝트는 설정, 개발, 테스트, 배포를 위한 명령어가 있는 포괄적인 justfile을 포함합니다.

설치 (Installation)

먼저 아직 설치하지 않았다면 Just를 설치하세요.

# macOS
brew install just

# Linux (using cargo)
cargo install just

# Or download from GitHub releases
curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -s -- --to ~/bin

빠른 레퍼런스 (Quick Reference)

사용 가능한 모든 명령어 보기:

just
# or
just --list

설정 명령어 (Setup Commands)

`just setup`

완전한 개발 환경 설정 - 전체 초기화 프로세스를 실행합니다.

just setup

동작 방식:

환경 파일 복사 (.env.example → .env 등)
모든 의존성 설치 (루트, API, 대시보드)
개발 환경 설정

언제 사용하나요:

프로젝트를 처음 설정할 때
새로 클론한 후
개발 환경을 리셋하고 싶을 때

`just install`

모든 서비스에 걸친 모든 프로젝트 의존성을 설치합니다.

just install

동작 방식:

루트 Node.js 의존성 설치 (bun install)
Python 개발 의존성 설치 (uv pip install -r requirements-dev.txt)
API 의존성 설치 (cd api && uv pip install -e .)
대시보드 의존성 설치 (cd dashboard && bun install)

언제 사용하나요:

의존성을 수정하는 변경사항을 pull한 후
package.json, pyproject.toml, 또는 requirements 파일이 변경되었을 때

API 개발 명령어 (API Development Commands)

`just api-native`

API 서버를 네이티브로 실행 (개발에 가장 빠름).

just api-native

동작 방식:

uv run python run.py로 FastAPI 서버 시작
http://localhost:8000에서 실행
개발을 위한 가장 빠른 리로드 시간 제공

언제 사용하나요:

활발한 API 개발 시
가장 빠른 반복 주기가 필요할 때
API 코드 디버깅 시

`just api-build`

API Docker 이미지 빌드.

just api-build

# With Stripe support
just api-build stripe

동작 방식:

API 서비스용 Docker 이미지 빌드
./scripts/just-api-build.sh 사용
선택적 Stripe 통합 지원

언제 사용하나요:

Docker 기반 배포 준비 시
Docker 빌드 프로세스 테스트 시
just api-run 실행 전

`just api-run`

Docker 컨테이너에서 API 서버 실행.

just api-run

# With Stripe support
just api-run stripe

동작 방식:

Docker로 API 서비스 실행
./scripts/just-api-run.sh 사용
필요한 모든 환경 변수 포함
선택적 Stripe 통합

언제 사용하나요:

로컬에서 Docker 배포 테스트 시
격리된 환경이 필요할 때
프로덕션 유사 테스트 시

`just api-test`

pytest로 API 테스트 실행.

just api-test

동작 방식:

api/ 디렉토리로 이동
설정된 모든 테스트로 pytest 실행
단위 및 통합 테스트 포함

언제 사용하나요:

API 변경사항을 커밋하기 전
API 기능 검증 시
지속적 통합 시

프론트엔드 개발 명령어 (Frontend Development Commands)

`just fe-run`

대시보드 개발 서버 실행.

just fe-run

동작 방식:

dashboard/ 디렉토리로 이동
의존성 설치 (bun install)
개발 서버 시작 (bun run dev)
http://localhost:3000에서 사용 가능

언제 사용하나요:

활발한 대시보드 개발 시
프론트엔드 변경사항 테스트 시
풀스택 개발 시

`just fe-build`

프로덕션용 대시보드 빌드.

just fe-build

동작 방식:

dashboard/ 디렉토리로 이동
최적화된 프로덕션 번들 빌드 (bun run build)
정적 자산 생성

언제 사용하나요:

프로덕션 배포 준비 시
로컬에서 프로덕션 빌드 테스트 시
성능 최적화 시

`just fe-test`

프론트엔드 테스트 실행.

just fe-test

동작 방식:

dashboard/ 디렉토리로 이동
테스트 스위트 실행 (bun test)
단위 및 컴포넌트 테스트 포함

언제 사용하나요:

프론트엔드 변경사항을 커밋하기 전
UI 기능 검증 시
지속적 통합 시

코드 품질 명령어 (Code Quality Commands)

`just lint`

프로젝트 전체에서 모든 린트 검사 실행.

just lint

동작 방식:

프로젝트 루트에서 bun run lint 실행
ESLint로 JavaScript/TypeScript 파일 검사
Ruff로 Python 파일 검사
코드 스타일과 품질 검증

언제 사용하나요:

변경사항을 커밋하기 전
코드 리뷰 준비 시
코드 품질 유지 시

`just format`

프로젝트 표준으로 모든 코드 포맷.

just format

동작 방식:

Python 파일에 ruff format 실행
일관된 코드 포맷 적용
자동으로 수정 가능한 이슈 해결

언제 사용하나요:

변경사항을 커밋하기 전
코드 스타일 표준화 시
코드 리뷰 준비 시

`just test`

프로젝트 전체에서 모든 테스트 실행.

just test

동작 방식:

just api-test 실행 (API 테스트)
just fe-test 실행 (프론트엔드 테스트)
포괄적인 테스트 스위트 실행

언제 사용하나요:

주요 릴리스 전
전체 시스템 검증 시
지속적 통합 시

Docker 관리 명령어 (Docker Management Commands)

`just up`

Docker Compose로 모든 서비스 시작.

just up

동작 방식:

docker-compose up -d 실행
정의된 모든 서비스를 분리 모드로 시작
필요에 따라 네트워크와 볼륨 생성

언제 사용하나요:

개발 환경 시작 시
전체 시스템 통합 테스트 시
Docker 기반 개발 시

`just down`

모든 Docker 서비스 중지.

just down

동작 방식:

docker-compose down 실행
컨테이너 중지 및 제거
볼륨과 네트워크 보존

언제 사용하나요:

개발 환경 중지 시
개발 모드 전환 시
실행 중인 서비스 정리 시

`just logs`

모든 서비스의 Docker 로그 보기.

just logs

동작 방식:

docker-compose logs -f 실행
모든 서비스의 실시간 로그 표시
디버깅과 모니터링에 유용

언제 사용하나요:

서비스 이슈 디버깅 시
애플리케이션 동작 모니터링 시
문제 해결 시

`just clean`

Docker 리소스 정리.

just clean

동작 방식:

docker-compose down -v 실행 (서비스 중지 및 볼륨 제거)
docker system prune -f 실행 (사용하지 않는 Docker 리소스 제거)
디스크 공간 확보

언제 사용하나요:

개발 환경 정리 시
디스크 공간 확보 시
Docker 이슈 해결 시
완전히 새로 시작할 필요가 있을 때

명령어 조합과 워크플로우 (Command Combinations and Workflows)

완전한 개발 설정 (Full Development Setup)

# First time setup
just setup

# Start development
just api-native     # Terminal 1
just fe-run         # Terminal 2

Docker 개발 (Docker Development)

# Setup and start with Docker
just setup
just up
just logs

테스트 워크플로우 (Testing Workflow)

# Run quality checks before committing
just lint
just format
just test

프로덕션 준비 (Production Preparation)

# Build and test production assets
just api-build
just fe-build
just test

환경별 사용 (Environment-Specific Usage)

개발 환경 (Development Environment)

# Fast iteration cycle
just api-native    # Native API for speed
just fe-run        # Frontend dev server

통합 테스트 (Integration Testing)

# Full Docker environment
just up            # All services in Docker
just test          # Run full test suite

프로덕션 테스트 (Production Testing)

# Production-like environment
just api-build     # Build production API image
just fe-build      # Build production frontend
just up            # Run with Docker

Just 명령어 문제 해결 (Troubleshooting Just Commands)

커맨드를 찾을 수 없음 (Command Not Found)

# Verify Just is installed
just --version

# Install if missing
brew install just  # macOS

권한 문제 (Permission Issues)

# Make sure justfile is executable
chmod +x justfile

# Check file permissions
ls -la justfile

환경 문제 (Environment Issues)

# Verify environment files exist
ls -la .env api/.env dashboard/.env.local

# Run setup to create missing files
just setup

Docker 문제 (Docker Issues)

# Clean Docker environment
just clean

# Restart Docker service
sudo systemctl restart docker  # Linux

커스텀 명령어와 확장 (Custom Commands and Extensions)

justfile을 여러분의 명령어로 확장할 수 있어요. 파일 하단에 추가하세요.

# Custom command example
my-command:
    @echo "Running my custom command"
    # Your commands here

# Command with parameters
deploy env:
    @echo "Deploying to {{env}}"
    # Deployment commands

커스텀 명령어 사용:

just my-command
just deploy staging

모범 사례 (Best Practices)

일일 개발 (Daily Development)

API 개발은 just api-native (가장 빠름)
프론트엔드 개발은 just fe-run
커밋 전에 just lint && just test

통합 테스트 (Integration Testing)

전체 환경은 just up
모니터링은 just logs
이슈 발생 시 just clean

프로덕션 준비 (Production Preparation)

프로덕션 빌드는 just api-build && just fe-build
검증은 just test
최종 테스트는 just up

백엔드 설정 가이드 - 완전한 설정 지침
Docker 가이드 - Docker 특화 명령어
개발 워크플로우 - 개발 모범 사례

더 알아보기 (Learn more)

AgentOps 공식 문서

Just 커맨드 레퍼런스

Just 커맨드 레퍼런스 (Just Commands Reference)

본문

Just 커맨드 레퍼런스

설치 (Installation)

빠른 레퍼런스 (Quick Reference)

설정 명령어 (Setup Commands)

just setup

just install

API 개발 명령어 (API Development Commands)

just api-native

just api-build

just api-run

just api-test

프론트엔드 개발 명령어 (Frontend Development Commands)

just fe-run

just fe-build

just fe-test

코드 품질 명령어 (Code Quality Commands)

just lint

just format

just test

Docker 관리 명령어 (Docker Management Commands)

just up

just down

just logs

just clean

명령어 조합과 워크플로우 (Command Combinations and Workflows)

완전한 개발 설정 (Full Development Setup)

Docker 개발 (Docker Development)

테스트 워크플로우 (Testing Workflow)

프로덕션 준비 (Production Preparation)

환경별 사용 (Environment-Specific Usage)

개발 환경 (Development Environment)

통합 테스트 (Integration Testing)

프로덕션 테스트 (Production Testing)

Just 명령어 문제 해결 (Troubleshooting Just Commands)

커맨드를 찾을 수 없음 (Command Not Found)

권한 문제 (Permission Issues)

환경 문제 (Environment Issues)

Docker 문제 (Docker Issues)

커스텀 명령어와 확장 (Custom Commands and Extensions)

모범 사례 (Best Practices)

일일 개발 (Daily Development)

통합 테스트 (Integration Testing)

프로덕션 준비 (Production Preparation)

관련 문서 (Related Documentation)

더 알아보기 (Learn more)

`just setup`

`just install`

`just api-native`

`just api-build`

`just api-run`

`just api-test`

`just fe-run`

`just fe-build`

`just fe-test`

`just lint`

`just format`

`just test`

`just up`

`just down`

`just logs`

`just clean`