프로젝트 관리

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

GitLab에서의 대부분의 작업은 프로젝트에서 수행됩니다. 파일 및 코드는 프로젝트에 저장되며 대부분의 기능은 프로젝트 범위 내에 있습니다.

프로젝트 개요

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

프로젝트를 선택하면 프로젝트 개요 페이지에서 프로젝트 내용을 확인할 수 있습니다.

  • 저장소에 있는 파일
  • 프로젝트 정보(설명)
  • 주제
  • 뱃지
  • 프로젝트의 별표, 포크, 커밋, 브랜치, 태그, 릴리스, 환경의 수
  • 프로젝트 저장 공간 크기
  • 선택 사항 파일 및 구성
  • README 또는 색인 파일
    • 위키 페이지
    • 라이선스
    • 변경 로그
    • 기여 가이드
    • 쿠버네티스 클러스터
    • CI/CD 구성
    • 통합
    • GitLab Pages
  • 작성 날짜

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

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

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

프로젝트 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 17.5부터이 엔드포인트에 https://gitlab.example.com/-/p/<id>를 사용할 수도 있습니다.

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

프로젝트 ID를 복사하는 방법:

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

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

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

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

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

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

멤버인 프로젝트 보기

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

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

왼쪽 사이드바에서 프로젝트가 선택되어 있습니다. 목록에서 **내 프로젝트 탭에서 멤버인 모든 프로젝트가 표시됩니다.

개인 프로젝트 보기

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

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

개인 프로젝트를 보려면:

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

또는

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

즐겨찾은 프로젝트 보기

프로젝트에 별표를 붙이려면:

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

또는

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

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

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

전제 조건:

  • 프로젝트에 대한 최소한의 Maintainer 역할이 있어야 합니다.
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 프로젝트 이름 텍스트 상자에 프로젝트 이름을 입력합니다. 프로젝트 이름에 대한 제한 사항을 확인하세요.
  4. 선택 사항. 프로젝트 설명 텍스트 상자에 프로젝트 설명을 입력합니다. 설명은 2,000자로 제한됩니다. CI/CD 카탈로그에 출판된 구성 요소는 프로젝트 설명이 필요합니다.
  5. 선택 사항. 프로젝트 아바타에서 파일 선택을 선택하여 프로젝트 아바타를 변경합니다. 이상적인 이미지 크기는 192 x 192 픽셀이며 최대 파일 크기는 200 KB입니다.
  6. 변경 사항 저장을 선택합니다.

프로젝트에 별표 붙이기

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

프로젝트에 별을 추가하려면:

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

프로젝트 삭제

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

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

전제 조건:

프로젝트를 삭제하려면:

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

이 작업은 프로젝트 및 관련 리소스(이슈 및 병합 요청과 같은)를 삭제합니다.

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

프로젝트 지연 삭제

등급: 프리미엄, 얼티밋 오퍼링: GitLab.com, 셀프 매니지드, GitLab 전용

전제조건:

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

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

셀프매니지드 인스턴스에서 그룹 관리자는 1일부터 90일까지의 삭제 지연 기간을 정의할 수 있습니다. SaaS의 경우 7일의 기본 보유기간이 있습니다.

지연 삭제 대기 프로젝트를 볼 수 있으며 레일스 콘솔을 사용하여 지연 삭제 대기 프로젝트를 찾을 수 있습니다.

즉시 프로젝트 삭제

등급: 프리미엄, 얼티밋 오퍼링: GitLab.com, 셀프 매니지드, GitLab 전용
  • GitLab 16.0에서 관리 영역 및 그룹 설정에서 프로젝트를 즉시 삭제하는 옵션이 제거됨

전제조건:

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

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

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

지연 삭제 대기 프로젝트를 즉시 삭제하려면:

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

삭제 대기 프로젝트 보기

등급: 프리미엄, 얼티밋 오퍼링: GitLab.com, 셀프 매니지드, GitLab 전용

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

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

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

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

프로젝트 복원

등급: 프리미엄, 얼티밋 오퍼링: GitLab.com, 셀프 매니지드, GitLab 전용

전제조건:

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

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

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

프로젝트 아카이브

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

  • 저장소
  • 패키지
  • 이슈
  • 머지 리퀘스트
  • 기능 플래그
  • 모든 다른 프로젝트 기능

아카이브된 프로젝트의 활성화된 파이프라인 일정은 읽기 전용으로 전환되지 않습니다.

프로젝트에 배포된 페이지가 있으면 사용자 정의 도메인과 함께 제거되며, 페이지 링크에 더 이상 액세스할 수 없습니다.

아카이브된 프로젝트는:

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

전제조건:

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

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

프로젝트 아카이브 해제

프로젝트를 아카이브 해제하면 읽기 전용 제한이 제거되며 프로젝트가 프로젝트 목록에서 사용할 수 있게 됩니다.

전제조건:

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

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

프로젝트 활동 보기

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

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

  3. 옵션. 기여 유형에 따라 활동을 필터링하려면 탭을 선택합니다:

    • 모두: 프로젝트 멤버에 의한 모든 기여 사항.
    • 푸시 이벤트: 프로젝트 내의 푸시 이벤트.
    • 병합 이벤트: 프로젝트 내의 승인된 병합 요청.
    • 이슈 이벤트: 프로젝트 내에서 열고 닫힌 이슈.
    • 댓글: 프로젝트 멤버가 게시한 댓글.
    • 디자인: 프로젝트 내에서 추가, 업데이트, 제거된 디자인.
    • 팀: 프로젝트에 참여하고 나간 멤버.

프로젝트에서 검색

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

또한 별표를 한 프로젝트를 찾을 수도 있습니다 (별표가 붙은 프로젝트).

GitLab.com에서 사용 가능한 모든 공개 및 내부 프로젝트를 탐색하여, 인기 있는 것, 가장 많이 별표가 붙은 것 또는 그 중 모두를 필터링할 수 있습니다.

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

  • 이름
  • 생성 날짜
  • 업데이트된 날짜
  • 스타 수

언어로 프로젝트 필터링

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

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

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

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

자신이 소유한 프로젝트만 보기

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

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

저장소 이름 변경하기

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

전제 조건:

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

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

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

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

프로젝트에서 나가기

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

프로젝트를 나가면:

  • 더 이상 프로젝트 멤버가 아니며 기여할 수 없습니다.
  • 귀하에게 할당된 모든 이슈 및 병합 요청이 할당 해제됩니다.

전제 조건:

  • 프로젝트가 그룹 네임스페이스 아래의 그룹의 일부인 경우에만이 방법으로 프로젝트를 떠날 수 있습니다.
  • 프로젝트의 직접 멤버여야 합니다.

프로젝트를 나가려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 프로젝트 개요 페이지에서 오른쪽 상단에 있는 작업 ()을 선택합니다.
  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으로 마이그레이션할 때 프로젝트 별칭을 사용하여 해당 저장소에 액세스할 수 있습니다. 프로젝트 별칭을 통해 리포지토리에 액세스하면 해당 리포지토리를 마이그레이션하는 데 관련된 위험을 줄일 수 있습니다.

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

관리자가 프로젝트에 대한 별칭을 생성한 후에 별칭을 사용하여 리포지토리를 복제할 수 있습니다. 예를 들어, 관리자가 gitlab을 https://gitlab.com/gitlab-org/gitlab 프로젝트에 대한 별칭으로 만든 경우에, 리포지토리를 다음과 같은 명령으로 복제할 수 있습니다: git clone git@gitlab.com:gitlab.git. 단순히 git clone git@gitlab.com:gitlab-org/gitlab.git 대신에 git clone git@gitlab.com:gitlab.git를 사용할 수 있습니다.

관련 주제