• 프로젝트 개요
  • 프로젝트 ID를 사용하여 프로젝트에 접근하기
• 인스턴스의 모든 프로젝트 보기
• 자신이 멤버인 프로젝트 보기
• 개인 프로젝트 보기
• 스타 프로젝트 보기
• 프로젝트 이름, 설명 및 아바타 편집
• 프로젝트에 스타 추가하기
• 프로젝트 삭제하기
  • 프로젝트 삭제 지연
  • 프로젝트를 즉시 삭제
  • 삭제 대기 중인 프로젝트 보기
• 프로젝트 복원
• 프로젝트 보관
• 프로젝트 보관 해제
• 프로젝트 활동 보기
• 프로젝트 검색
  • 언어별로 프로젝트 필터링
  • 소유한 프로젝트만 보기
• 저장소 이름 바꾸기
• 프로젝트 탈퇴하기
• 프로젝트에 준수 프레임워크 추가
• LDAP 그룹을 통해 프로젝트 액세스 관리
• 프로젝트 별칭
• 관련 주제

프로젝트 관리

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

프로젝트 개요

• 프로젝트 생성 날짜 소개됨 GitLab 16.10에서.

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

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

공개 프로젝트와 프로젝트 코드 보기 권한이 있는 내부 및 비공개 프로젝트의 구성원에게
프로젝트 개요 페이지에는 다음이 표시됩니다:

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

프로젝트 코드 보기 권한이 없는 사용자에게는 개요 페이지에 다음이 표시됩니다:

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

프로젝트 ID를 사용하여 프로젝트에 접근하기

• 프로젝트 ID 이동됨 GitLab 16.7의 작업 메뉴로.

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

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

프로젝트 ID를 복사하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 프로젝트 개요 페이지의 오른쪽 상단에서 작업 ()을 선택합니다.
3. 프로젝트 ID 복사를 선택합니다.

인스턴스의 모든 프로젝트 보기

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
2. 탐색을 선택합니다.

왼쪽 사이드바에서 프로젝트가 선택됩니다. 오른쪽에는 인스턴스의 모든 프로젝트 목록이 표시됩니다.

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

자신이 멤버인 프로젝트 보기

자신이 멤버인 프로젝트를 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
2. 내 모든 프로젝트 보기를 선택합니다.

왼쪽 사이드바에서 프로젝트가 선택됩니다. 목록의 내 프로젝트 탭에서
당신이 멤버인 모든 프로젝트가 표시됩니다.

개인 프로젝트 보기

개인 프로젝트는 개인 네임스페이스 아래에 생성된 프로젝트입니다.

예를 들어, 사용자 이름이 alex인 계정을 만들고, 사용자 이름 아래에 my-project라는 프로젝트를 생성하면, 프로젝트는 https://gitlab.example.com/alex/my-project에 생성됩니다.

개인 프로젝트를 보려면:

1. 왼쪽 사이드바에서 Search or go to를 선택합니다.
2. View all my projects를 선택합니다.
3. Personal 탭을 선택합니다.

또는

1. 왼쪽 사이드바에서 아바타를 선택한 다음 사용자 이름을 선택합니다.
2. 왼쪽 사이드바에서 Personal projects를 선택합니다.

스타 프로젝트 보기

스타를 부여한 프로젝트를 보려면:

1. 왼쪽 사이드바에서 Search or go to를 선택합니다.
2. View all my projects를 선택합니다.
3. Starred 탭을 선택합니다.

또는

1. 왼쪽 사이드바에서 아바타를 선택한 다음 사용자 이름을 선택합니다.
2. 왼쪽 사이드바에서 Starred projects를 선택합니다.

프로젝트 이름, 설명 및 아바타 편집

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

사전 조건:

• 프로젝트에 대해 최소한 Maintainer 역할이 있어야 합니다.

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. Settings > General을 선택합니다.
3. Project name 텍스트 상자에 프로젝트 이름을 입력합니다. 프로젝트 이름에 대한 제한 사항을 참조하세요.
4. 선택 사항. Project description 텍스트 상자에 프로젝트 설명을 입력합니다. 설명은 2,000자로 제한됩니다. CI/CD 카탈로그에 게시된 구성 요소는 프로젝트 설명이 필요합니다.
5. 선택 사항. Project avatar 아래에서 프로젝트 아바타를 변경하려면 Choose file을 선택합니다. 이상적인 이미지 크기는 192 x 192 픽셀이며 최대 파일 크기는 200 KB입니다.
6. Save changes를 선택합니다.

프로젝트에 스타 추가하기

자주 사용하는 프로젝트에 스타를 추가하여 찾기 쉽게 만들 수 있습니다.

프로젝트에 스타를 추가하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 페이지의 오른쪽 상단에서 Star를 선택합니다.

프로젝트 삭제하기

• Premium 및 Ultimate 티어의 프로젝트에 대한 기본 삭제 동작이 GitLab 16.0에서 지연된 프로젝트 삭제로 변경되었습니다.
• GitLab.com에서 Premium 및 Ultimate 티어에 대한 기본 삭제 동작이 지연된 삭제로 변경되었습니다. 또한 자체 관리에서도 마찬가지입니다.

프로젝트를 삭제하도록 표시할 수 있습니다. 프로젝트를 삭제하면:

• 개인 네임스페이스의 프로젝트는 즉시 삭제됩니다.
• 그룹의 프로젝트는 보존 기간 후에 삭제됩니다.

사전 조건:

• 프로젝트에 대해 Owner 역할이 있어야 합니다.
• Owner는 프로젝트 삭제를 허용받아야 합니다.

프로젝트를 삭제하려면:

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

이 작업은 프로젝트와 모든 관련 리소스(예: 이슈 및 병합 요청)를 삭제합니다.

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

프로젝트 삭제 지연

• GitLab 15.1에서 개인 네임스페이스의 프로젝트에 대해 사용 가능.
• GitLab 15.3에서 개인 네임스페이스의 프로젝트에 대해 비활성화.
• GitLab 16.0에서 GitLab.com 및 self-managed에서 기본적으로 지연 삭제를 활성화하고 즉시 삭제 옵션 제거.

Prerequisites:

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

그룹(개인 네임스페이스가 아님)의 프로젝트는 지연 기간 후에 삭제할 수 있습니다.

Self-managed 인스턴스에서 그룹 관리자는 1일부터 90일 사이의 삭제 지연 기간을 정의할 수 있습니다.
SaaS에서는 7일의 조정 불가능한 기본 보존 기간이 있습니다.

삭제 대기 중인 프로젝트 보기와 Rails 콘솔을 사용하여
삭제 대기 중인 프로젝트 찾기할 수 있습니다.

프로젝트를 즉시 삭제

• GitLab 16.0에서 GitLab.com 및 self-managed에서 관리자 영역 및 그룹 설정에서 프로젝트를 즉시 삭제하는 옵션 제거.

Prerequisites:

• 프로젝트에 대한 소유자 역할이 있어야 합니다.
• 프로젝트는 삭제를 위해 표시되어야 합니다.

지연 삭제를 기다리고 싶지 않다면, 프로젝트를 즉시 삭제할 수 있습니다. 이를 위해 프로젝트 삭제 단계를 다시 수행하세요.

프로젝트를 삭제하는 첫 번째 사이클에서 프로젝트는 지연 삭제 큐로 이동되며 보존 기간이 지난 후 자동으로 삭제됩니다.
지연 삭제 시간 동안 두 번째 삭제 사이클을 실행하면 프로젝트가 즉시 삭제됩니다.

삭제를 위해 표시된 프로젝트를 즉시 삭제하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 일반을 선택합니다.
3. 고급을 확장합니다.
4. 이 프로젝트 삭제 섹션에서 프로젝트 삭제를 선택합니다.
5. 확인 대화 상자에서 프로젝트 이름을 입력하고 예, 프로젝트 삭제를 선택합니다.

삭제 대기 중인 프로젝트 보기

삭제 대기 중인 모든 프로젝트 목록을 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
2. 내 모든 프로젝트 보기를 선택합니다.
3. 삭제 대기 중 탭을 선택합니다.

목록에 있는 각 프로젝트는 다음을 보여줍니다:

• 프로젝트가 삭제를 위해 표시된 시간.
• 프로젝트가 최종 삭제될 예정인 시간.
• 프로젝트의 삭제를 중단할 수 있는 복원 링크.

프로젝트 복원

필수 조건:

• 프로젝트에 대한 소유자 역할이 있어야 합니다.
• 프로젝트는 삭제를 위해 표시되어야 합니다.

삭제를 위해 표시된 프로젝트를 복원하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 일반을 선택합니다.
3. 고급을 확장합니다.
4. 프로젝트 복원 섹션에서 프로젝트 복원을 선택합니다.

프로젝트 보관

• 페이지 제거 도입됨 GitLab 17.5에서.

프로젝트를 보관하면 일부 기능이 읽기 전용이 됩니다.
이 기능은 여전히 접근 가능하지만, 쓰기가 불가능합니다.

• 저장소
• 패키지
• 이슈
• 병합 요청
• 기능 플래그
• 모든 기타 프로젝트 기능

보관된 프로젝트의 활성 파이프라인 일정은 읽기 전용이 되지 않습니다.

프로젝트에 배포된 페이지가 있는 경우, 이들은 모든 사용자 정의 도메인과 함께 제거되고,
페이지 링크는 더 이상 접근할 수 없습니다.

보관된 프로젝트는:

• 프로젝트 페이지에 archived 배지를 표시합니다.
• 그룹 페이지, 내 작업 페이지 및 탐색 페이지의 비활성 탭에 나열됩니다.
• 읽기 전용입니다.

필수 조건:

• 프로젝트에 대한 모든 활성 파이프라인 일정을 비활성화하거나 삭제합니다.
  

프로젝트를 보관하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 일반을 선택합니다.
3. 고급을 확장합니다.
4. 프로젝트 보관 섹션에서 프로젝트 보관을 선택합니다.
5. 확인하려면 확인을 선택합니다.

프로젝트 보관 해제

프로젝트의 보관을 해제하면 읽기 전용 제약이 제거되며,
프로젝트가 프로젝트 목록에서 사용할 수 있게 됩니다.

필수 조건:

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

1. 보관된 프로젝트를 찾습니다.
   1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
   2. 내 모든 프로젝트 보기를 선택합니다.
   3. 프로젝트 탐색을 선택합니다.
   4. 프로젝트 정렬 드롭다운 목록에서 보관된 프로젝트 표시를 선택합니다.
   5. 이름으로 필터링 필드에 프로젝트 이름을 입력합니다.
   6. 프로젝트 링크를 선택합니다.
2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
3. 고급 아래에서 확장을 선택합니다.
4. 프로젝트 보관 해제 섹션에서 프로젝트 보관 해제를 선택합니다.
5. 확인하려면 확인을 선택합니다.

배포된 페이지는 복원되지 않으며, 파이프라인을 다시 실행해야 합니다.

프로젝트 활동 보기

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 관리 > 활동을 선택합니다.

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

   • 모두: 프로젝트 구성원의 모든 기여.
   • 푸시 이벤트: 프로젝트의 푸시 이벤트.
   • 병합 이벤트: 프로젝트에서 수락된 병합 요청.
   • 이슈 이벤트: 프로젝트에서 열린 및 닫힌 이슈.
   • 댓글: 프로젝트 구성원이 게시한 댓글.
   • 디자인: 프로젝트에 추가, 업데이트 및 제거된 디자인.
   • 팀: 프로젝트에 참여 및 퇴사한 구성원.

프로젝트 검색

프로젝트를 검색하려면 왼쪽 사이드바에서 Search or go to를 선택하세요.

GitLab은 입력하는 내용에 따라 필터링합니다.

별표를 붙인 프로젝트를 찾을 수도 있습니다. 프로젝트에 별표 달기(Starred projects).

GitLab.com에서 사용할 수 있는 모든 공개 및 내부 프로젝트를 Explore하여 필터링할 수 있으며,

Trending, 별점이 가장 높은 Most stars, 또는 All로 필터링할 수 있습니다.

프로젝트를 다음과 같은 기준으로 정렬할 수 있습니다:

• 이름
• 생성일
• 업데이트 날짜
• 별점

언어별로 프로젝트 필터링

• 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. 다음 중 하나를 선택합니다:
   • View all your projects, 자신의 프로젝트를 필터링합니다.
   • Explore, 접근할 수 있는 모든 프로젝트를 필터링합니다.
3. 프로젝트 목록 위에서 Search or filter results를 선택하세요.
4. Role 드롭다운 목록에서 Owner를 선택합니다.

저장소 이름 바꾸기

프로젝트의 저장소 이름은 GitLab이 설치된 파일 디스크의 URL 및 위치를 정의합니다.

선행 조건:

• 프로젝트에 대한 유지 관리자 또는 소유자 역할이 있어야 합니다.

참고: 저장소 경로를 변경하면 사용자가 이전 URL로 푸시하거나 풀 때 문제가 발생할 수 있습니다. 더 많은 정보는 저장소 이름 변경 시 리디렉션를 참조하세요.

저장소 이름을 바꾸려면:

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

프로젝트 탈퇴하기

• 프로젝트 탈퇴 버튼이 GitLab 16.7의 작업 메뉴로 이동함.

프로젝트를 탈퇴하면:

• 더 이상 프로젝트 구성원이 아니며 기여할 수 없습니다.
• 당신에게 할당된 모든 이슈와 머지 요청이 할당 해제됩니다.

선행 조건:

• 프로젝트가 그룹 네임스페이스 아래에 있는 그룹의 일부일 때만 이런 방식으로 프로젝트를 탈퇴할 수 있습니다.
• 프로젝트의 직접 구성원이어야 합니다.

프로젝트를 탈퇴하려면:

1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 프로젝트 개요 페이지의 오른쪽 상단에서 Actions ()를 선택합니다.
3. Leave project를 선택한 후, 다시 Leave project를 선택합니다.

프로젝트에 준수 프레임워크 추가

그룹에 준수 프레임워크가 있는 경우 프로젝트에 준수 프레임워크를 추가할 수 있습니다.

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

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

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

사전 요구 사항:

• GitLab과 LDAP 통합을 해야 합니다.
• 관리자이어야 합니다.

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.git 명령으로 프로젝트를 복제할 수 있습니다. 기존의 git clone git@gitlab.com:gitlab-org/gitlab.git 대신 사용할 수 있습니다.

관련 주제

• 프로젝트 가져오기.
• 외부 저장소를 GitLab CI/CD에 연결.
• 프로젝트 포크.
• 프로젝트 가시성 및 권한 조정.
• 프로젝트 및 그룹 이름의 제한 사항