GitLab에서 대부분의 작업은 프로젝트에서 이루어집니다. 파일과 코드는 프로젝트에 저장되며 대부분의 기능은 프로젝트 범위 내에 있습니다.

프로젝트 개요#

히스토리

• GitLab 16.10에서 프로젝트 생성 날짜가 도입되었습니다.

프로젝트를 선택하면 Project overview 페이지에 프로젝트 내용이 표시됩니다:

• 저장소의 파일
• 프로젝트 정보(설명)
• 주제
• 배지
• 프로젝트의 별표, 포크, 커밋, 브랜치, 태그, 릴리스, 환경 수
  • 커밋 수는 모든 브랜치가 아닌 프로젝트의 기본 브랜치에서 계산됩니다
• 프로젝트 스토리지 크기
• 선택적 파일 및 구성
• README 또는 인덱스 파일
  • 위키 페이지
  • 라이선스
  • 변경 내역
  • 기여 가이드라인
  • Kubernetes 클러스터
  • CI/CD 구성
  • 통합
  • GitLab Pages
• 생성 날짜

공개 프로젝트의 경우 및 프로젝트 코드를 볼 수 있는 권한이 있는 내부 및 비공개 프로젝트의 구성원의 경우 프로젝트 개요 페이지에 다음이 표시됩니다:

• README 또는 인덱스 파일.
• 프로젝트 저장소의 디렉토리 목록.

프로젝트 코드를 볼 수 있는 권한이 없는 사용자의 경우 개요 페이지에 다음이 표시됩니다:

• 위키 홈페이지.
• 프로젝트의 이슈 목록.

https://gitlab.example.com/projects/<id>에서 이름 대신 ID를 사용하여 프로젝트에 액세스할 수 있습니다. 예를 들어 개인 네임스페이스 alex에 ID 123456의 프로젝트 my-project가 있는 경우 https://gitlab.example.com/alex/my-project 또는 https://gitlab.example.com/projects/123456에서 프로젝트에 액세스할 수 있습니다.

프로젝트 ID 찾기#

GitLab API를 사용하여 프로젝트와 상호 작용하려면 프로젝트 ID가 필요할 수 있습니다.

프로젝트 ID를 찾으려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 프로젝트 개요 페이지의 오른쪽 상단 모서리에서 Actions (⋮)를 선택합니다.
3. Copy project ID를 선택합니다.

프로젝트 보기#

Projects 목록을 사용하여 다음을 봅니다:

• 인스턴스의 모든 프로젝트
• 작업하거나 소유한 프로젝트
• 보관된 프로젝트 및 삭제 대기 중인 프로젝트를 포함한 비활성 프로젝트

인스턴스의 모든 프로젝트 탐색#

히스토리

• GitLab 19.0에서 트렌딩 프로젝트 탭이 제거되었습니다. 기능 플래그 retire_trending_projects가 기본적으로 활성화되었습니다.

GitLab 인스턴스의 모든 프로젝트를 봅니다. 활성 및 비활성 프로젝트별로 목록을 필터링합니다:

• 활성 프로젝트는 최근 활동이 있거나 진행 중인 개발 프로젝트입니다.
• 비활성 프로젝트는 보관되었거나 삭제 예약된 프로젝트입니다.

인증되지 않은 경우 목록에는 공개 프로젝트만 표시됩니다.

GitLab 인스턴스의 프로젝트를 보려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. Explore를 선택합니다.
3. 선택사항. 탭을 선택하여 표시되는 프로젝트를 필터링합니다.

작업한 프로젝트 보기#

히스토리

• GitLab 17.9에서 your_work_projects_vue라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.9에서 your_work_projects_vue라는 플래그와 함께 탭 레이블이 Yours에서 Member로 변경되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.10에서 일반적으로 사용 가능하게 되었습니다. 기능 플래그 your_work_projects_vue가 제거되었습니다.

상호 작용한 프로젝트를 보려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. View all my projects를 선택합니다.
3. 선택사항. 탭을 선택하여 표시되는 프로젝트를 필터링합니다:
   • Contributed: 다음 작업을 수행한 프로젝트:
     • 이슈, 병합 요청 또는 에픽 생성
     • 이슈, 병합 요청 또는 에픽에 댓글 달기
     • 이슈, 병합 요청 또는 에픽 닫기
     • 커밋 push
     • 병합 요청 승인
     • 병합 요청 병합
   • Starred: 별표 표시한 프로젝트
   • Personal: 개인 네임스페이스에서 만든 프로젝트
   • Member: 구성원인 프로젝트
   • Inactive: 보관된 프로젝트 및 삭제 대기 중인 프로젝트

개인 프로필에서 별표 표시된 프로젝트와 개인 프로젝트도 볼 수 있습니다:

1. 오른쪽 상단 모서리에서 아바타를 선택한 다음 사용자 이름을 선택합니다.
2. 왼쪽 사이드바에서 Starred projects 또는 Personal projects를 선택합니다.

비활성 프로젝트 보기#

히스토리

• GitLab 17.9에서 your_work_projects_vue라는 플래그와 함께 탭 레이블이 "Pending deletion"에서 "Inactive"로 변경되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.10에서 탭 레이블이 일반적으로 사용 가능하게 되었습니다. 기능 플래그 your_work_projects_vue가 제거되었습니다.
• GitLab 18.0에서 GitLab Premium에서 GitLab Free로 이동되었습니다.
• GitLab 18.0에서 개인 네임스페이스의 프로젝트에 대해 활성화되었습니다.

프로젝트가 삭제 대기 중이거나 보관된 경우 비활성 상태입니다.

모든 비활성 프로젝트를 보려면:

1. 다음 중 하나를 선택합니다:
   • View all my projects: 프로젝트를 필터링합니다.
   • Explore: 액세스할 수 있는 모든 프로젝트를 필터링합니다.
2. Inactive 탭을 선택합니다.

목록의 각 비활성 프로젝트에는 프로젝트가 보관되었는지 삭제 대기 중인지 나타내는 배지가 표시됩니다.

프로젝트가 삭제 대기 중인 경우 목록에는 다음도 표시됩니다:

• 프로젝트가 최종 삭제 예약된 시간.
• Restore 작업. 프로젝트를 복원하면:
  • Pending deletion 레이블이 제거됩니다. 프로젝트가 더 이상 삭제 예약되지 않습니다.
  • 프로젝트가 Inactive 탭에서 제거됩니다.

소유한 프로젝트만 보기#

소유한 프로젝트만 보려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. 다음 중 하나를 선택합니다:
   • View all your projects: 프로젝트를 필터링합니다.
   • Explore: 액세스할 수 있는 모든 프로젝트를 필터링합니다.
3. 프로젝트 목록 위에서 Search or filter results를 선택합니다.
4. Role 드롭다운 목록에서 Owner를 선택합니다.

프로젝트 활동 보기#

프로젝트의 활동을 보려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.

2. 왼쪽 사이드바에서 Manage > Activity를 선택합니다.

3. 선택사항. 기여 유형별로 활동을 필터링하려면 탭을 선택합니다:

   • All: 프로젝트 구성원의 모든 기여.
   • Push events: 프로젝트의 Push 이벤트.
   • Merge events: 프로젝트에서 수락된 병합 요청.
   • Issue events: 프로젝트에서 열리고 닫힌 이슈.
   • Comments: 프로젝트 구성원이 게시한 댓글.
   • Designs: 프로젝트에서 추가, 업데이트, 제거된 디자인.
   • Team: 프로젝트에 참여하거나 나간 구성원.

GitLab은 성능상의 이유로 3년이 지난 프로젝트 활동 이벤트를 이벤트 테이블에서 제거합니다.

언어별 프로젝트 필터링#

히스토리

• GitLab 15.9에서 project_language_search라는 플래그와 함께 도입되었습니다. 기본적으로 활성화되어 있습니다.
• GitLab 15.9에서 일반적으로 사용 가능하게 되었습니다. 기능 플래그 project_language_search가 제거되었습니다.

사용하는 프로그래밍 언어별로 프로젝트를 필터링할 수 있습니다. 이를 위해:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. 다음 중 하나를 선택합니다:
   • View all your projects: 프로젝트를 필터링합니다.
   • Explore: 액세스할 수 있는 모든 프로젝트를 필터링합니다.
3. 프로젝트 목록 위에서 Search or filter results를 선택합니다.
4. Language 드롭다운 목록에서 프로젝트를 필터링할 언어를 선택합니다.

선택한 언어를 사용하는 프로젝트 목록이 표시됩니다.

프로젝트 별표 표시#

자주 사용하는 프로젝트에 별표를 표시하여 더 쉽게 찾을 수 있습니다.

프로젝트에 별표를 표시하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 페이지의 오른쪽 상단 모서리에서 Star를 선택합니다.

프로젝트 나가기#

히스토리

• GitLab 16.7에서 프로젝트 나가기 버튼이 Actions 메뉴로 이동되었습니다.

프로젝트를 나갈 때:

• 더 이상 프로젝트 구성원이 아니며 기여할 수 없습니다.
• 할당된 모든 이슈와 병합 요청의 할당이 취소됩니다.

사전 요건:

• 이 방법으로는 프로젝트가 그룹 네임스페이스 아래의 그룹에 속할 때만 프로젝트를 나갈 수 있습니다.
• 프로젝트의 직접 구성원이어야 합니다.

프로젝트를 나가려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 프로젝트 개요 페이지의 오른쪽 상단 모서리에서 Actions (⋮)를 선택합니다.
3. Leave project를 선택한 다음 다시 Leave project를 선택합니다.

Your work 목록 뷰에서 직접 프로젝트를 나가려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. View all my projects를 선택합니다.
3. Member 탭에서 나가려는 프로젝트를 찾고 세로 줄임표 (⋮)를 선택합니다.
4. Leave project를 선택합니다.

이 작업은 다른 목록 페이지에서도 사용할 수 있습니다.

프로젝트 편집#

프로젝트 일반 설정을 사용하여 프로젝트 세부 정보를 편집합니다.

사전 요건:

• 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Project name 텍스트 상자에 프로젝트 이름을 입력합니다. 프로젝트 이름 제한을 참조하십시오.
4. 선택사항. Project description 텍스트 상자에 프로젝트 설명을 입력합니다. 설명은 2,000자로 제한됩니다. CI/CD 카탈로그에 게시된 컴포넌트에는 프로젝트 설명이 필요합니다.
5. Save changes를 선택합니다.

저장소 이름 변경#

프로젝트의 저장소 이름은 URL을 정의합니다.

사전 요건:

• 관리자이거나 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.

저장소 이름을 변경하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced를 펼칩니다.
4. Change path 텍스트 상자에서 경로를 편집합니다.
5. Change path를 선택합니다.

프로젝트 아바타 추가#

프로젝트를 시각적으로 식별하는 데 도움이 되는 프로젝트 아바타를 추가합니다. 아바타를 추가하지 않으면 GitLab이 프로젝트 이름의 첫 글자를 기본 프로젝트 아바타로 표시합니다.

프로젝트 아바타를 추가하려면 다음 방법 중 하나를 사용합니다:

• 저장소에 로고를 추가합니다.
• 프로젝트 설정에서 아바타를 업로드합니다.

저장소에 로고 추가#

프로젝트 설정에 아바타를 업로드하지 않은 경우 GitLab은 기본 프로젝트 아바타로 사용하기 위해 저장소에서 logo라는 파일을 찾습니다.

사전 요건:

• 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
• 파일이 200KB 이하여야 합니다. 이상적인 이미지 크기는 192 x 192 픽셀입니다.
• 파일 이름이 .png, .jpg, 또는 .gif 확장자를 가진 logo여야 합니다. 예: logo.gif.

프로젝트 아바타로 사용할 로고 파일을 추가하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 프로젝트 저장소의 루트에 로고 파일을 업로드합니다.

프로젝트 설정에서 아바타 업로드#

사전 요건:

• 프로젝트에 대한 Maintainer 또는 Owner 역할이 있어야 합니다.
• 파일이 200KB 이하여야 합니다. 이상적인 이미지 크기는 192 x 192 픽셀입니다.
• 이미지는 다음 파일 유형 중 하나여야 합니다:
  • .bmp
  • .gif
  • .ico
  • .jpeg
  • .png
  • .tiff

프로젝트 설정에서 아바타를 업로드하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Project avatar 섹션에서 Choose file을 선택합니다.
4. 아바타 파일을 선택합니다.
5. Save changes를 선택합니다.

프로젝트 삭제#

히스토리

• GitLab 16.0에서 GitLab.com 및 GitLab Self-Managed의 Premium 및 Ultimate 티어에 대해 기본 동작이 지연된 프로젝트 삭제로 변경되었습니다.
• GitLab 18.0에서 GitLab Free 및 개인 프로젝트에 대해 기본 동작이 지연된 프로젝트 삭제로 변경되었습니다.

기본적으로 처음으로 프로젝트를 삭제하면 삭제 대기 상태로 전환됩니다. 프로젝트를 다시 삭제하면 즉시 제거됩니다.

사전 요건:

• 프로젝트에 대한 Owner 역할이 있어야 합니다.
• Owner가 프로젝트를 삭제하도록 허용되어야 합니다.

프로젝트를 삭제하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced를 펼칩니다.
4. Delete project 섹션에서 Delete를 선택합니다.
5. 확인 대화 상자에서 프로젝트 이름을 입력하고 Yes, delete project를 선택합니다.

이 작업은 프로젝트를 삭제로 표시하는 백그라운드 작업을 추가합니다. GitLab.com에서는 30일 후 프로젝트가 삭제됩니다. GitLab Self-Managed에서는 인스턴스 설정을 통해 보존 기간을 수정할 수 있습니다.

삭제를 예약한 사용자가 삭제가 발생하기 전에 프로젝트 액세스를 잃은 경우(예: 프로젝트 탈퇴, 역할 다운그레이드, 프로젝트에서 차단됨) 삭제 작업 대신 프로젝트를 복원하고 프로젝트는 더 이상 삭제 예약되지 않습니다.

프로젝트가 삭제로 표시되면 예약된 CI/CD 파이프라인이 실행을 중지합니다.

Rails 콘솔을 사용하여 프로젝트를 삭제할 수도 있습니다.

프로젝트 즉시 삭제#

히스토리

• GitLab 16.0에서 일반적으로 사용 가능하게 되었습니다. Premium 및 Ultimate 전용.
• GitLab 18.0에서 GitLab Premium에서 GitLab Free로 이동되었습니다.

구성된 보존 기간을 기다리지 않고 프로젝트를 삭제하려면 즉시 삭제할 수 있습니다.

사전 요건:

• 프로젝트에 대한 Owner 역할이 있어야 합니다.
• 프로젝트를 삭제 예약해야 합니다.

삭제 예약된 프로젝트를 영구적으로 삭제하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced를 펼칩니다.
4. Delete project 섹션에서 Delete permanently를 선택합니다.
5. 확인 대화 상자에서 프로젝트 이름을 입력하고 Confirm을 선택합니다.

이 작업은 프로젝트와 이슈 및 병합 요청을 포함한 모든 관련 리소스를 삭제합니다.

프로젝트 복원#

히스토리

• GitLab 18.0에서 GitLab Premium에서 GitLab Free로 이동되었습니다.
• GitLab 18.0에서 개인 네임스페이스의 프로젝트에 대해 활성화되었습니다.

사전 요건:

• 프로젝트에 대한 Owner 역할이 있어야 합니다.

삭제 대기 중인 프로젝트를 복원하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced를 펼칩니다.
4. Restore project 섹션에서 Restore project를 선택합니다.

프로젝트 보관#

히스토리

• GitLab 17.5에서 Pages 제거가 도입되었습니다.

프로젝트를 보관하여 읽기 전용으로 만들고 나중에 참조할 수 있도록 데이터를 보존합니다.

프로젝트를 보관하면:

• 프로젝트가 비활성 상태가 되고 Archived 배지가 표시됩니다
• 저장소, 이슈, 병합 요청, 패키지를 포함한 대부분의 기능이 읽기 전용이 됩니다
• 포크 관계가 제거되고 포크의 열린 병합 요청이 닫힙니다
• 배포된 Pages가 사용자 지정 도메인과 함께 제거됩니다
• 예약된 CI/CD 파이프라인이 실행을 중지합니다
• 풀 미러링이 중지됩니다

사전 요건:

• 관리자이거나 프로젝트에 대한 Owner 역할이 있어야 합니다.

프로젝트를 보관하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced를 펼칩니다.
4. Archive project 섹션에서 Archive를 선택합니다.

Your work 목록 뷰에서 직접 프로젝트를 보관하려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. 드롭다운에서 View all my projects를 선택합니다.
3. Member 탭에서 보관하려는 프로젝트를 찾고 세로 줄임표 (⋮)를 선택합니다.
4. Archive를 선택합니다.

이 작업은 다른 목록 페이지에서도 사용할 수 있습니다.

프로젝트 보관 취소#

프로젝트를 보관 취소하면:

• 읽기 전용 제한이 제거됩니다
• 프로젝트가 더 이상 비활성으로 표시되지 않습니다
• 예약된 CI/CD 파이프라인이 자동으로 재개됩니다
• 풀 미러링이 자동으로 재개됩니다

그룹 보관의 일부로 보관된 프로젝트는 개별적으로 보관 취소할 수 없습니다. 모든 프로젝트 및 하위 그룹을 보관 취소하려면 상위 그룹을 보관 취소해야 합니다.

사전 요건:

• 관리자이거나 프로젝트에 대한 Owner 역할이 있어야 합니다.

프로젝트를 보관 취소하려면:

1. 보관된 프로젝트를 찾습니다.
   1. 상단 표시줄에서 Search or go to를 선택합니다.
   2. 드롭다운에서 View all my projects를 선택합니다.
   3. Inactive 탭에서 프로젝트를 선택합니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced 아래에서 Expand를 선택합니다.
4. Unarchive project 섹션에서 Unarchive를 선택합니다.

Your work 목록 뷰에서 직접 프로젝트를 보관 취소하려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. 드롭다운에서 View all my projects를 선택합니다.
3. Inactive 탭에서 보관 취소하려는 프로젝트를 찾고 세로 줄임표 (⋮)를 선택합니다.
4. Unarchive를 선택합니다.

이 작업은 다른 목록 페이지에서도 사용할 수 있습니다.

프로젝트 이전#

히스토리

• GitLab 17.7에서 transfer_project_with_tags라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.7에서 GitLab.com에서 활성화되었습니다. 기능 플래그가 제거되었습니다.

프로젝트를 다른 그룹으로 이동하려면 이전합니다. 프로젝트 이전은 동일한 GitLab 인스턴스의 모든 네임스페이스 간에 개별 프로젝트를 이동합니다.

프로젝트를 다음에서 이전할 수 있습니다:

• 개인 네임스페이스에서 그룹으로
• 그룹에서 다른 그룹으로
• 그룹에서 개인 네임스페이스로

사전 요건:

• 대상 그룹에 대한 Maintainer 또는 Owner 역할.
• 이전하려는 프로젝트의 Owner 역할.
• 대상 그룹에 대한 프로젝트 생성 활성화.

프로젝트를 이전하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Advanced를 펼칩니다.
4. Transfer project 아래에서 프로젝트를 이전할 네임스페이스를 선택합니다.
5. Transfer project를 선택합니다.
6. 프로젝트 이름을 입력하고 Confirm을 선택합니다.

새 프로젝트 페이지로 이동하고 이전 URL이 새 프로젝트 URL로 리디렉션됩니다.

프로젝트를 이전한 후 다음을 수행해야 합니다:

• 로컬 저장소 원격을 새 URL로 업데이트합니다.
• 프로젝트 구성원 액세스 및 권한을 확인합니다.
• 필요한 경우 패키지 구성을 업데이트하고 다시 게시합니다.
• CI/CD 파이프라인 및 통합을 테스트합니다.
• 필요한 경우 보안 정책을 검토하고 재할당합니다.

관리자는 관리 영역에서 프로젝트를 이전할 수 있습니다.

이전되는 데이터#

프로젝트 이전에는 다음이 포함됩니다:

• 프로젝트 구성 요소:
  • 이슈, 병합 요청, 이슈 스레드
  • CI/CD 파이프라인 및 구성
  • 대시보드 및 위키
  • 저장소 코드 및 Git 기록
  • 프로젝트 액세스 토큰
• 프로젝트 구성원:
  • 직접 프로젝트 구성원 및 역할
  • 대기 중인 구성원 초대
• 자동화된 조정:
  • 일치하는 그룹 레이블이 없으면 새 프로젝트 레이블이 생성됩니다
  • 필요한 경우 대상 그룹에 에픽 복사본이 생성되며 프로젝트별로 별도의 복사본이 만들어집니다
    • 동일한 에픽에 할당된 이슈가 있는 여러 프로젝트를 이전하면 각 프로젝트에 대해 대상 그룹에 해당 에픽의 별도 복사본이 생성됩니다.

알려진 이슈#

프로젝트를 이전할 때 다음 제한 사항을 염두에 두십시오.

상속된 멤버십이 있는 프로젝트의 경우:

• 프로젝트에 상속된 멤버십이 있는 구성원은 대상 그룹의 구성원이 아닌 경우 액세스를 잃습니다.
• 프로젝트는 대상 그룹에서 새 구성원 권한을 상속합니다.

컨테이너 레지스트리가 활성화된 프로젝트의 경우:

• GitLab.com에서: 같은 최상위 그룹 내에서만 프로젝트를 이전할 수 있습니다.
• GitLab Self-Managed에서: 프로젝트에 컨테이너 이미지가 포함되어 있지 않아야 합니다.
• 1,000개 이상의 컨테이너 저장소가 있는 프로젝트는 이전할 수 없습니다. 자세한 내용은 컨테이너 레지스트리 저장소 이동 또는 이름 변경을 참조하십시오.

패키지 레지스트리를 사용하는 프로젝트의 경우:

• 루트 네임스페이스가 변경되면 명명 규칙을 따르는 npm 패키지를 프로젝트에서 제거해야 합니다. 프로젝트를 이전한 후 다음 중 하나를 수행할 수 있습니다:
  • 새 루트 네임스페이스 경로로 패키지 범위를 업데이트하고 프로젝트에 다시 게시합니다.
  • 루트 네임스페이스 경로를 업데이트하지 않고 프로젝트에 패키지를 다시 게시하면 패키지가 더 이상 명명 규칙을 따르지 않게 됩니다. 루트 네임스페이스 경로를 업데이트하지 않고 패키지를 다시 게시하면 인스턴스 엔드포인트에서 사용할 수 없게 됩니다.

보안 정책이 있는 프로젝트의 경우:

• 프로젝트에 보안 정책이 없어야 합니다. 프로젝트에 보안 정책이 할당된 경우 이전 중에 자동으로 할당이 취소됩니다.

프로젝트를 이전할 때:

• 프로젝트 경로가 변경됩니다. 필요한 경우 프로젝트 구성 요소의 URL을 변경해야 합니다.

GitLab.com 프로젝트를 다른 구독 티어로 이전#

GitLab.com Premium 또는 Ultimate 라이선스가 있는 네임스페이스에서 GitLab Free로 프로젝트를 이전하면:

• 프로젝트 액세스 토큰이 취소됩니다.
• 파이프라인 구독 및 테스트 케이스가 삭제됩니다.

Actions 메뉴로 프로젝트 관리#

모든 프로젝트 목록을 보고 Actions 메뉴로 관리할 수 있습니다.

사전 요건:

• 작업을 수행하려면 필요한 프로젝트 권한이 있어야 합니다.

Actions 메뉴로 프로젝트를 관리하려면:

1. 상단 표시줄에서 Search or go to를 선택합니다.
2. 드롭다운에서 View all my projects를 선택합니다.
3. Projects 페이지에서 프로젝트를 찾고 세로 줄임표 (⋮)를 선택합니다.
4. 작업을 선택합니다.

프로젝트 상태에 따라 다음 작업을 사용할 수 있습니다:

프로젝트에 컴플라이언스 프레임워크 추가#

컴플라이언스 프레임워크가 있는 그룹의 프로젝트에 컴플라이언스 프레임워크를 추가할 수 있습니다.

LDAP 그룹을 통해 프로젝트 액세스 관리#

LDAP를 사용하여 그룹 멤버십을 관리할 수 있습니다.

LDAP 그룹을 사용하여 프로젝트 액세스를 관리할 수 없지만 다음 해결 방법을 사용할 수 있습니다.

사전 요건:

• LDAP를 GitLab과 통합해야 합니다.
• 관리자여야 합니다.

1. 프로젝트의 멤버십을 추적하기 위한 그룹을 만듭니다.
2. 해당 그룹에 대한 LDAP 동기화를 설정합니다.
3. LDAP 그룹을 사용하여 프로젝트 액세스를 관리하려면 LDAP 동기화된 그룹을 구성원으로 추가합니다.

프로젝트 별칭#

GitLab 저장소는 일반적으로 네임스페이스와 프로젝트 이름으로 액세스합니다. 그러나 자주 액세스하는 저장소를 GitLab으로 마이그레이션할 때 프로젝트 별칭을 사용하여 원래 이름으로 해당 저장소에 액세스할 수 있습니다. 프로젝트 별칭을 통해 저장소에 액세스하면 이러한 저장소 마이그레이션과 관련된 위험이 줄어듭니다.

이 기능은 SSH를 통한 Git에서만 사용할 수 있습니다. 또한 GitLab 관리자만 프로젝트 별칭을 만들 수 있으며 API를 통해서만 만들 수 있습니다. 자세한 내용은 프로젝트 별칭 API 문서를 참조하십시오.

관리자가 프로젝트에 대한 별칭을 만든 후 별칭을 사용하여 저장소를 클론할 수 있습니다. 예를 들어 관리자가 프로젝트 https://gitlab.com/gitlab-org/gitlab에 대해 별칭 gitlab을 만들면 git clone git@gitlab.com:gitlab-org/gitlab.git 대신 git clone git@gitlab.com:gitlab.git을 사용하여 프로젝트를 클론할 수 있습니다.

관련 주제#

• GitLab으로 가져오기 및 마이그레이션.
• 외부 저장소를 GitLab CI/CD에 연결.
• 프로젝트 포크.
• 프로젝트 가시성 및 권한 조정.
• 프로젝트 및 그룹 이름 규칙