Wiki

리포지토리 만들기

uVersion 리포지토리 만들기: 누가 만들 수 있는지, 두 가지 방법(관리 패널 또는 기존 프로젝트 폴더), 그리고 서버가 자동으로 하는 일.

리포지토리는 서버 측 프로젝트로, 프로덕션의 이력과 파일을 담고 있습니다. workspace는 디스크에서 이에 대응하는 폴더입니다. 이 둘은 별개입니다: 리포지토리를 만들어도 컴퓨터에는 아무것도 생기지 않으며, 그 반대도 마찬가지입니다.

리포지토리를 만들 수 있는 사람

서버 관리자 전용 어떤 방법으로든 리포지토리를 만들 수 있는 것은 admin 역할뿐입니다. lead나 project_admin은 만들 수 없습니다: 서버는 Admin role required라고 응답하고, 클라이언트는 그들에게 버튼을 그냥 숨깁니다. 아래에 설명된 버튼이 보이지 않는다면, 원인은 표시 결함이 아니라 당신의 역할입니다.

uversion 명령줄에는 생성 명령이 전혀 없습니다: 기존 리포지토리를 복제하고 그 안에서 작업할 수는 있지만, 새로 만들 수는 없습니다. 데스크톱 클라이언트나 웹 인터페이스를 사용하세요.

두 가지 방법

선택은 이미 무엇을 가지고 있는지에 달려 있습니다:

처음부터 시작하거나, 팀이 나중에 채울 프로젝트를 준비하는 경우: 관리 패널에서 빈 리포지토리를 만드세요. 설명을 입력할 수 있는 유일한 방법입니다. 아래를 참고하세요.
이미 디스크에 Unreal 프로젝트가 있고 그것을 uVersion으로 관리하려는 경우: 여기로 오지 말고 기존 프로젝트 업로드하기를 따르세요. 이 방법은 리포지토리 생성과 폴더 연결을 한 번에 처리하며, 아무것도 옮기지 않습니다.

관리 패널에서

1. Repositories 탭 열기

사이드바에서 Admin을 연 다음 Repositories 탭을 엽니다. 올바른 행에 주의하세요: 패널에는 두 개가 있는데, SERVER는 서버 전체에 관한 것이고, PROJECT는 바로 옆에서 선택한 리포지토리에만 관한 것입니다. 리포지토리는 SERVER 행에서 만듭니다.

헤더에는 활성 리포지토리 수가 표시됩니다. 새 서버에서는 목록이 비어 있고, + Create Repository 버튼이 오른쪽 위에 있습니다.

관리 패널의 Repositories 탭: SERVER 행, 상태와 생성 날짜가 있는 리포지토리 목록, 그리고 오른쪽 위의 Create Repository 버튼.

2. 생성 대화 상자 열기

+ Create Repository를 클릭합니다. 두 개의 필드가 있는 대화 상자가 열립니다. 회색으로 표시된 텍스트는 예시일 뿐이며, 미리 채워진 것은 없습니다.

3. 리포지토리 이름 지정 후 확인

Name 필드를 입력합니다. Description (optional) 필드는 선택 사항이며, 설명을 입력할 수 있는 유일한 곳입니다. Create 버튼은 이름이 비어 있는 동안 비활성 상태로 남습니다.

같은 대화 상자를 채운 상태: Name은 MyProject, Description은 My test project, 그리고 Create 버튼이 활성화됨.

리포지토리는 서버에 비어 있는 상태로 만들어집니다 이 단계에서는 디스크에 아무것도 나타나지 않습니다. 그 안에서 작업하려면, 다음으로 Workspace로 이동해 Open Repository를 클릭한 다음 Clone을 클릭하세요. 복제 시 상위 폴더와 workspace 이름을 묻습니다.

자동으로 일어나는 일

생성 시 서버는 묻지 않고 세 가지를 합니다:

이에 대응하는 스토리지 폴더를 만듭니다. 그 이름은 당신의 이름에서 파생되며, 문자도 숫자도 아닌 문자는 모두 하이픈이 됩니다.
기본 검증 규칙을 설치합니다. 모두 비활성화되어 있습니다: 관리자가 활성화하기 전까지는 어떤 검사도 실행되지 않습니다.
감사 로그에 항목을 기록합니다.

반면에 권한은 전혀 설정되지 않습니다. 새 리포지토리는 admin과 lead 역할에게만 보입니다: 그 위에 어떤 권한도 부여하지 않는 한, 다른 계정은 읽기로도 전혀 보지 못합니다. 다음으로 가장 먼저 할 일은 Permissions 탭에서 이 작업을 하는 것입니다.

흔한 함정

"Invalid repository name"

이름이 비어 있거나 255자를 초과합니다. 다른 제약은 없습니다: 공백과 악센트 부호는 허용되며, 단순화되는 것은 스토리지 폴더 이름뿐입니다.

"Repository name already exists"

이름은 서버 전체에서 고유합니다. 검사는 저장 시점에 이루어지므로, 메시지는 입력 중이 아니라 Create를 클릭한 후에 나타납니다. 비활성화된 리포지토리도 기억하세요: 그것들도 여전히 이름을 차지하고 있습니다.

리포지토리를 만들었는데 파일을 찾을 수 없습니다

이는 예상된 동작입니다: 관리 화면에서의 생성은 서버에 빈 리포지토리를 만들 뿐 디스크에는 절대 손대지 않습니다. 아마도 이미 가지고 있는 프로젝트를 uVersion으로 관리하려던 것이겠지요.

빈 리포지토리는 누구에게도 방해가 되지 않고 아무것도 소비하지 않습니다: 반사적으로 삭제하지 마세요. 선호하는 순서로 두 가지 출구가 있습니다:

사용하세요. 빈 폴더에 복제하고, 그 안으로 프로젝트 내용을 옮긴 다음, 기존 프로젝트 업로드하기의 업로드 단계부터 다시 시작하세요. 아무것도 파괴되지 않으며 리포지토리는 당신이 준 이름을 유지합니다.
그대로 두고 기존 프로젝트 업로드하기에서 다시 시작하세요. 이는 당신의 폴더에서 자체 리포지토리를 만들며 아무것도 옮기지 않습니다. 이 이름은 이미 사용 중이므로 다른 이름이 필요합니다.

휴지통은 휴지통으로 보내지 않습니다 꼭 이름을 되찾고 싶다면, 리포지토리 목록의 삭제 아이콘이 무엇을 하는지 알아두세요: 그것은 영구적으로 삭제하며, 휴지통도 복원도 없습니다. 그 확인 창은 그대로의 말로 알려주며, 이 작업은 프로젝트의 파일, 리비전, 잠금, 권한, 검증 규칙, Webhook, 프로덕션 보드, 게시된 빌드, 배포 링크를 가져가 버립니다. 빈 리포지토리에서는 잃을 것이 없습니다: 진짜 위험은 잘못된 행을 겨냥하는 것으로, 실제 프로젝트가 바로 위와 아래에 있습니다. 확인하기 전에 확인 창에 표시된 이름을 읽으세요.

우리 팀이 새 리포지토리를 보지 못합니다

권한이 부여되지 않은 동안은 정상입니다. Permissions를 참고하세요.