개발자

모든 것이 스크립트로 가능합니다.
모든 것이 통합 가능합니다.

uVersion은 완전한 CLI, 문서화된 REST API, 그리고 게임 개발에 쓰이는 IDE를 위한 네이티브 플러그인을 제공합니다. 파이프라인을 코드로 짠다면, 그 안에 녹아듭니다.

CLI `uversion`

uversion.exe 바이너리(약 6 MB)는 모든 VCS 작업을 다루며, 어떤 스크립트에서든 파싱할 수 있는 --json 출력을 제공합니다.

자격 증명은 시스템 키링을 통해 데스크톱 클라이언트와 공유되어 이중 로그인이 필요 없습니다. CDC 청킹, zstd 압축, .uversionignore 추적은 데스크톱 클라이언트와 동일합니다.

전체 CLI 레퍼런스 →

# Login + clone + checkin

$ uversion login https://team.uversion.io --username alex.dev

✓ Authenticated as alex.dev

$ uversion clone hero-rpg ./HeroRPG

Cloning to ./HeroRPG ...

✓ 8,432 files in 47s

$ uversion checkout Content/Characters/Hero.uasset

✓ Lock acquired

$ uversion checkin -m "Hero pose pass"

✓ Committed as 7f3a9b1

에디터 플러그인

Unreal 개발에 쓰이는 IDE에 네이티브로 통합됩니다.

Plugin Unreal Engine

사용 가능

에디터에 내장된 Source Control Provider. UE 5.6 이상. 미리 컴파일된 바이너리로 배포되며, 데스크톱 클라이언트가 프로젝트에 대신 설치하고 Unreal 버전별·플랫폼별로 업데이트를 알려줍니다. 압축을 풀 ZIP은 없습니다.

Content Browser에서 Checkout / Checkin / Revert
내장 비주얼 Blueprint diff
10가지 기본 규칙으로 checkin 전 검증
수정 시 자동 Checkout
Windows Credential Manager를 통한 자동 로그인
시작 시 리컨사일(Content/ + Plugins/*/Content/)

문서 →

Plugin Rider

사용 가능

Unreal 게임 개발의 대표 IDE, JetBrains Rider를 위한 VCS 통합.

VCS 메뉴에서 Refresh / Update / Checkin / Revert
내부적으로 uversion CLI에 위임
소스 확장자 필터(.cpp, .h, .cs, .uproject)
데스크톱 클라이언트와 인증 공유

Plugin Visual Studio

Coming soon

Microsoft IDE를 계속 쓰는 C++ 개발자를 위한 Visual Studio 2022 이상의 VCS 통합. Rider 플러그인과 동일한 기능을 Team Explorer 메뉴에 제공합니다.

Extension VS Code

Coming soon

에디터를 벗어나지 않고 스크립트 작성, 설정 편집, 프로젝트 문서 작성을 할 수 있는 VS Code 확장. 탐색기의 상태 아이콘, 명령 팔레트를 통한 checkout / checkin.

API REST

uVersion 서버는 JWT로 인증되는 JSON HTTP API를 제공합니다. 클라이언트의 모든 작업(auth, repos, files, locks, comments, builds)을 REST로 사용할 수 있습니다.

POST /api/auth/login: 30일 유효한 JWT 획득
POST /api/auth/refresh: 비밀번호를 다시 입력하지 않고 갱신
GET /api/repositories: 접근 가능한 저장소 목록
POST /api/files/{repo_id}/upload-chunks: 청크 단위 바이너리 업로드
POST /api/locks/{repo_id}/acquire: 파일 잠금
POST /api/builds/{repo_id}/upload: 플레이테스트 빌드 배포

전체 API 레퍼런스 →

# 저장소 목록 가져오기

curl -X GET https://team.uversion.io/api/repositories \
  -H "Authorization: Bearer $UV_TOKEN"

# 응답

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "hero-rpg",
      "owner": "acme",
      "current_revision": "7f3a9b1...",
      "file_count": 8432,
      "size_bytes": 14211938405
    }
  ]
}

CI/CD

uversion CLI는 자동화 파이프라인을 위해 설계되었습니다. --json 모드, 표준 반환 코드, 비밀번호를 다시 입력하지 않고 갱신할 수 있는 장기 유효 JWT(30일).

# .github/workflows/build.yml

name: Nightly build
on:
  schedule: [{ cron: '0 2 * * *' }]
jobs:
  build:
    runs-on: [self-hosted, unreal]
    steps:
      - name: Login + sync from uVersion
        env:
          UV_SERVER: ${{ secrets.UV_SERVER }}
          UV_USER: ${{ secrets.UV_USER }}
          UV_PASSWORD: ${{ secrets.UV_PASSWORD }}
        run: |
          uversion login "$UV_SERVER" --username "$UV_USER" --password "$UV_PASSWORD" --json
          uversion clone hero-rpg ./project --json
          uversion sync --json
      - name: Build packaged client
        run: |
          ./project/Engine/Build/BatchFiles/RunUAT.bat \
            BuildCookRun -project=./project/HeroRPG.uproject \
            -clientconfig=Development -platform=Win64

안정적이고 빠릅니다

네이티브 서버 바이너리, 가벼운 데스크톱 클라이언트(수 MB, 즉시 실행), 대용량 파일을 위한 대규모 병렬 업로드·다운로드. JWT 인증, 최신 표준으로 해시된 비밀번호, 민감한 작업의 완전한 감사. 자체 인프라의 서버는 자체 서명 TLS로 동작하며, 클라이언트는 첫 접속 시 지문을 고정합니다(TOFU). CI에서 신뢰를 스크립트화하려면 uversion trust를 사용하세요.

문서 속으로 뛰어드세요.

위키 읽기 CLI 레퍼런스

모든 것이 스크립트로 가능합니다.모든 것이 통합 가능합니다.

CLI uversion