프로젝트 관리

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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

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

GitLab 인스턴스의 모든 프로젝트를 보려면 다음을 수행하세요:

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

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

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

회원으로 참여 중인 프로젝트 보기

회원으로 참여 중인 프로젝트를 보려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
  2. 당신의 작업을 선택합니다.

왼쪽 사이드바에서 프로젝트가 선택되어 있습니다. 목록에서 Yours 탭에는 회원으로 참여 중인 모든 프로젝트가 표시됩니다.

개인 프로젝트 보기

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

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

개인 프로젝트를 보려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 아바타를 선택한 다음 사용자 이름을 선택합니다.
  2. 왼쪽 사이드바에서 개인 프로젝트를 선택합니다.

즐겨찾는 프로젝트 보기

자주 사용하는 프로젝트를 쉽게 찾기 위해 해당 프로젝트에 별표를 추가할 수 있습니다.

프로젝트에 별표를 추가하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 페이지 오른쪽 상단에서 별표를 선택합니다.

프로젝트 이름 및 설명 편집

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

전제 조건:

  • 프로젝트의 유지관리자(Maintainer) 역할 이상이어야 합니다.
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 프로젝트 이름 텍스트 상자에 프로젝트 이름을 입력합니다. 프로젝트 이름에 대한 제한 사항을 확인하세요.
  4. 프로젝트 설명 텍스트 상자에 프로젝트 설명을 입력합니다. 설명은 2,000자로 제한됩니다.
  5. 프로젝트 아바타에서 파일 선택을 선택하여 프로젝트 아바타를 변경합니다.

프로젝트에 별표 추가

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

프로젝트에 별표를 추가하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 페이지 오른쪽 상단에서 별표를 선택합니다.

프로젝트 삭제

  • GitLab 12.6에서 프로젝트의 기본 삭제 동작이 지연된 프로젝트 삭제로 변경되었습니다.
  • GitLab 13.2에서 프로젝트의 기본 삭제 동작이 즉시 삭제로 변경되었습니다.
  • GitLab 16.0에서 프리미엄 및 얼티밋 티어의 프로젝트의 기본 삭제 동작이 지연된 프로젝트 삭제로 변경되었습니다.
  • GitLab 16.0에서 GitLab.com 및 Self-managed의 프리미엄 및 얼티밋 티어에서 기본 삭제 동작이 지연 삭제로 변경되었습니다.

프로젝트를 삭제할 수 있습니다. 프로젝트를 삭제한 후:

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

전제 조건:

  • 프로젝트의 소유자(Owner) 역할이어야 합니다.

프로젝트를 삭제하려면 다음을 수행하세요:

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

이 작업은 프로젝트뿐만 아니라 모든 관련 리소스(이슈와 병합 요청 등)를 삭제합니다.

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

지연된 프로젝트 삭제

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

전제 조건:

  • 프로젝트의 소유자(Owner) 역할이어야 합니다.

개인 네임스페이스가 아닌 그룹(개인 네임스페이스가 아닌 경우) 내의 프로젝트는 일정 기간이 지난 후에 삭제할 수 있습니다.

자체 관리되는 인스턴스에서 그룹 관리자는 삭제 지연 기간을 1에서 90일 사이로 정의할 수 있습니다. SaaS에서는 7일이 기본 보존 기간입니다.

삭제 대기 중인 프로젝트를 보고 레일즈 콘솔을 사용하여 삭제 대기 중인 프로젝트를 찾을 수 있습니다.

프로젝트 즉시 삭제

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

- GitLab 14.1에서 도입됨. - 옵션: GitLab.com 및 온 프레미스에서 즉시 프로젝트를 삭제하는 기능은 GitLab 16.0에서 제거됨.

필수 조건:

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

지연된 삭제를 기다리지 않으려면 프로젝트를 즉시 삭제할 수 있습니다. 이를 위해 프로젝트를 삭제하는 단계를 다시 수행하십시오.

프로젝트를 삭제하는 첫 번째 주기에서 프로젝트는 지연된 삭제 대기열로 이동되어 유지 기간이 경과한 후 자동으로 삭제됩니다. 이 지연된 삭제 기간 동안 두 번째 삭제 주기를 실행하면 프로젝트가 즉시 삭제됩니다.

삭제되도록 표시된 프로젝트를 즉시 삭제하려면:

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

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

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

- 관리자를 위해 GitLab 13.3에 도입됨. - 탭 이름이 GitLab 14.6에서 삭제된 프로젝트로 이름이 변경되었습니다. - 기본적으로 모든 사용자에게 사용 가능하며 14.8부터 기능 플래그project_owners_list_project_pending_deletion로 사용 가능합니다. - GitLab 14.9에서 일반적으로 사용 가능합니다. 기능 플래그 project_owners_list_project_pending_deletion이 제거되었습니다.

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

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

목록의 각 프로젝트에는 다음이 표시됩니다:

  • 프로젝트가 삭제로 표시된 시간
  • 프로젝트가 최종 삭제 예정인 시간
  • 프로젝트를 최종적으로 삭제되지 않도록 하는 복원 링크

프로젝트 복원

Tier: 프리미엄, 얼티밋 Offering: GitLab.com, Self-managed, GitLab Dedicated

필수 조건:

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

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

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

프로젝트 아카이브

프로젝트를 아카이브하면 일부 기능이 읽기 전용으로 전환됩니다. 이러한 기능은 여전히 접근 가능하지만 쓰기 전용이 됩니다.

  • 저장소
  • 패키지
  • 이슈
  • MR(Merge requests)
  • 기능 플래그
  • 다른 모든 프로젝트 기능

아카이브된 프로젝트는:

  • 프로젝트 페이지에서 archived 배지로 표시됩니다.
  • 그룹 페이지의 아카이브된 프로젝트 탭에 나열됩니다.
  • 내 작업 및 탐색에서 프로젝트 목록에서 숨겨집니다.
  • 읽기 전용입니다.

필수 조건:

프로젝트를 아카이브하려면:

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

프로젝트 다시 보관하기

프로젝트를 다시 보관할 때 읽기 전용 제한이 해제되고, 프로젝트가 프로젝트 목록에서 사용 가능해집니다.

필수 조건:

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

프로젝트 활동 보기

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 관리 > 활동을 선택합니다.
  3. 선택 사항. 기여 유형에 따라 활동을 필터링하려면 탭을 선택합니다:
    • 모두: 프로젝트 구성원에 의한 모든 기여.
    • 푸시 이벤트: 프로젝트의 푸시 이벤트.
    • 병합 이벤트: 프로젝트에서 승인된 병합 요청.
    • 이슈 이벤트: 프로젝트에서 열린 이슈 및 닫힌 이슈.
    • 코멘트: 프로젝트 구성원이 게시한 코멘트.
    • 디자인: 프로젝트에서 추가, 업데이트 및 제거된 디자인.
    • 팀: 프로젝트에 참여한 멤버 및 이탈한 멤버.

프로젝트에서 검색

프로젝트를 검색하려면 왼쪽 사이드바에서 검색 또는 이동을 선택합니다. GitLab은 입력하는대로 필터링됩니다.

또한 별표 표시(별표 표시된 프로젝트)한 프로젝트를 찾을 수 있습니다.

GitLab.com에서 사용 가능한 모든 공개 및 내부 프로젝트를 탐색하여 가시성에 따라 필터링하고 여기서 인기 있는 것, 최고 평가를 받은 가장 많은 별표를 받은 것, 또는 모든 것을 확인할 수 있습니다.

프로젝트를 다음과 같이 정렬할 수 있습니다:

  • 이름
  • 생성된 날짜
  • 업데이트된 날짜
  • 소유자

또한 보관된 프로젝트를 숨기거나 표시할 수 있습니다.

언어로 프로젝트 필터링하기

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택합니다.
  2. 다음 중 하나를 선택합니다:
    • 내 모든 프로젝트 보기, 프로젝트를 필터링하려면.
    • 탐색, 액세스할 수 있는 모든 프로젝트를 필터링하려면.
  3. 언어 드롭다운 목록에서 필터링할 언어를 선택합니다.

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

깃 저장소 이름 바꾸기

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

필수 조건:

  • 프로젝트의 관리자이거나 유지 관리자 또는 소유자 역할이어야 합니다.

참고: 저장소 경로를 변경하면 사용자가 이전 URL로 푸시 또는 풀하는 경우 문제가 발생할 수 있습니다. 자세한 내용은 저장소 경로를 변경할 때 리디렉션을 참조하십시오.

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 고급을 확장합니다.
  4. 경로 변경 텍스트 상자에서 경로를 편집합니다.
  5. 경로 변경을 선택합니다.

프로젝트 ID를 사용하여 프로젝트 개요 페이지에 액세스하기

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

프로젝트 이름 대신 프로젝트 ID를 사용하여 프로젝트에 액세스하려면, https://gitlab.example.com/projects/<id>로 이동합니다.

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

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

예를 들어, 개인 네임스페이스 alex에서 ID가 123456인 my-project 프로젝트가 있다면, https://gitlab.example.com/alex/my-project 또는 https://gitlab.example.com/projects/123456에서 프로젝트에 액세스할 수 있습니다.

또한 GitLab API를 사용하여 해당 프로젝트와 상호 작용하려는 경우 프로젝트 ID가 필요할 수 있습니다.

프로젝트 개요 페이지를 볼 수 있는 사용자

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

공개 프로젝트 및 내부 및 비공개 프로젝트의 구성원들은 프로젝트 코드를 볼 수 있는 권한을 가진 사용자에게는 프로젝트 랜딩 페이지에 다음이 표시됩니다.

프로젝트 코드를 볼 수 없는 사용자는 랜딩 페이지에서 다음이 표시됩니다.

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

프로젝트 떠나기

  • 프로젝트를 떠날 수 있는 버튼이 GitLab 16.7에서 이동되었습니다 Actions 메뉴로 이동되었습니다.

프로젝트를 떠나면:

  • 프로젝트 구성원이 아니게 되며 기여할 수 없습니다.
  • 본인에게 할당된 모든 이슈 및 병합 요청이 할당 취소됩니다.

필수 조건:

프로젝트를 떠나려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 프로젝트 개요 페이지에서 오른쪽 상단에 있는 Actions ()를 선택합니다.
  3. 프로젝트 떠나기를 선택한 후 다시 프로젝트 떠나기를 선택합니다.

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

세부 정보: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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

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

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

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

필수 조건:

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

프로젝트 별칭

세부 정보: Tier: Premium, Ultimate Offering: Self-managed, GitLab Dedicated

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

이 기능은 GitLab SSH를 통해서만 사용할 수 있습니다. 또한 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로 프로젝트를 복제할 수 있습니다.

관련 주제