프로젝트 생성

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

프로젝트를 생성하는 다양한 옵션이 있습니다. 빈 프로젝트를 만들 수 있고, 내장된 또는 사용자 정의 템플릿을 사용하여 프로젝트를 만들거나 git push로 프로젝트를 만들 수 있습니다.

빈 프로젝트 만들기

빈 프로젝트를 만들려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 맨 위에 새로 만들기(플러스 아이콘)와 새 프로젝트/저장소를 선택합니다.
  2. 빈 프로젝트 만들기를 선택합니다.
  3. 프로젝트 세부 정보를 입력합니다:
    1. 프로젝트 이름: 프로젝트 이름을 입력합니다. 프로젝트 이름에 대한 제약 사항을 확인하세요.
    2. 프로젝트 슬러그: 프로젝트의 경로를 입력합니다. GitLab은 URL 경로로 슬러그를 사용합니다.
    3. 프로젝트 배포 대상 (선택 사항): 프로젝트를 특정 환경에 배포하려면 관련 배포 대상을 선택합니다.
    4. 가시성 레벨: 적합한 가시성 레벨을 선택합니다. 사용자의 보기 및 액세스 권한을 확인하세요.
    5. README로 리포지토리 초기화: Git 리포지토리를 초기화하고 기본 브랜치를 만들며 이 프로젝트의 리포지토리를 복제할 수 있도록 이 옵션을 선택합니다.
    6. 정적 응용프로그램 보안 테스트(SAST) 사용: 소스 코드를 알려진 보안 취약점에 대해 분석하려면 이 옵션을 선택합니다.
  4. 프로젝트 만들기를 선택합니다.

내장 템플릿을 사용하여 프로젝트 만들기

내장된 템플릿은 새로운 프로젝트에 시작하기 위한 파일로 채워집니다. 이러한 템플릿은 project-templates 및 pages 그룹에서 가져옵니다. 누구나 내장된 프로젝트 템플릿에 기여할 수 있습니다.

내장 템플릿을 사용하여 프로젝트를 만들려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 맨 위에 새로 만들기(플러스 아이콘)와 새 프로젝트/저장소를 선택합니다.
  2. 템플릿에서 만들기를 선택합니다.
  3. 내장된 탭을 선택합니다.
  4. 템플릿 목록에서:
    • 템플릿을 미리 보려면 미리 보기를 선택합니다.
    • 템플릿을 사용하려면 템플릿 사용을 선택합니다.
  5. 프로젝트 세부 정보를 입력합니다:
    • 프로젝트 이름: 프로젝트 이름을 입력합니다.
    • 프로젝트 슬러그: 프로젝트의 경로를 입력합니다. GitLab은 URL 경로로 슬러그를 사용합니다.
    • 프로젝트 설명 (선택 사항): 프로젝트에 대한 설명을 입력합니다. 글자 제한은 500자입니다.
    • 가시성 레벨: 적합한 가시성 레벨을 선택합니다. 사용자의 보기 및 액세스 권한을 확인하세요.
  6. 프로젝트 만들기를 선택합니다.

참고: 사용자가 템플릿에서 프로젝트를 생성하거나 프로젝트를 가져오면, 이들은 가져온 항목의 작성자로 표시되며, 템플릿 또는 가져오기의 원래 타임스탬프가 유지됩니다. 이로 인해 항목이 사용자의 계정이 존재하기 전에 생성된 것처럼 보일 수 있습니다.

가져온 객체는 <사용자 이름>이(가) <타임스탬프>에 의해로 표시됩니다. GitLab 17.1 이전에는 레이블이 (GitLab에서 가져옴)으로 뒤에 붙었습니다.

HIPAA 감사 프로토콜 템플릿에서 프로젝트 만들기

HIPAA 감사 프로토콜 템플릿에는 미국 건강 및 인간 서비스 부서가 발행한 HIPAA 감사 프로토콜의 감사 문의 사항이 포함되어 있습니다.

HIPAA 감사 프로토콜 템플릿에서 프로젝트를 생성하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 맨 위에 새로 만들기(플러스 아이콘)와 새 프로젝트/저장소를 선택합니다.
  2. 템플릿에서 만들기를 선택합니다.
  3. 내장된 탭을 선택합니다.
  4. HIPAA 감사 프로토콜 템플릿을 찾습니다:
    • 템플릿을 미리 보려면 미리 보기를 선택합니다.
    • 템플릿을 사용하려면 템플릿 사용을 선택합니다.
  5. 프로젝트 세부 정보를 입력합니다:
    • 프로젝트 이름: 프로젝트 이름을 입력합니다.
    • 프로젝트 슬러그: 프로젝트의 경로를 입력합니다. GitLab은 URL 경로로 슬러그를 사용합니다.
    • 프로젝트 설명 (선택 사항): 프로젝트에 대한 설명을 입력합니다. 글자 제한은 500자입니다.
    • 가시성 레벨: 적합한 가시성 레벨을 선택합니다. 사용자의 보기 및 액세스 권한을 확인하세요.
  6. 프로젝트 만들기를 선택합니다.

사용자 정의 템플릿에서 프로젝트 만들기

사용자 정의 프로젝트 템플릿은 인스턴스 및 그룹에서 사용할 수 있습니다.

사용자 정의 템플릿에서 프로젝트를 만들려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 맨 위에 새로 만들기(플러스 아이콘)와 새 프로젝트/저장소를 선택합니다.
  2. 템플릿에서 만들기를 선택합니다.
  3. 인스턴스 또는 그룹 탭을 선택합니다.
  4. 템플릿 목록에서:
    • 템플릿을 미리 보려면 미리 보기를 선택합니다.
    • 템플릿을 사용하려면 템플릿 사용을 선택합니다.
  5. 프로젝트 세부 정보를 입력합니다:
    • 프로젝트 이름: 프로젝트 이름을 입력합니다.
    • 프로젝트 슬러그: 프로젝트의 경로를 입력합니다. GitLab은 URL 경로로 슬러그를 사용합니다.
    • 프로젝트 설명 (선택 사항): 프로젝트에 대한 설명을 입력합니다. 글자 제한은 500자입니다.
    • 가시성 레벨: 적합한 가시성 레벨을 선택합니다. 사용자의 보기 및 액세스 권한을 확인하세요.
  6. 프로젝트 만들기를 선택합니다.

SHA-256 해싱을 사용하는 프로젝트 만들기

Status: Experiment
이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 정보는 히스토리를 참조하세요. 이 기능은 테스트용으로 제공되지만 운영 환경에서 사용할 준비가 되지 않았습니다.

프로젝트를 만들 때만 프로젝트에 대해 SHA-256 해싱을 선택할 수 있습니다. 이후에 SHA-256로 마이그레이션하거나 SHA-1로 마이그레이션하는 것은 Git에서 지원하지 않습니다.

SHA-256 해싱을 사용하는 프로젝트를 만들려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 맨 위에 새로 만들기(플러스 아이콘)와 새 프로젝트/저장소를 선택합니다.
  2. 프로젝트 세부 정보를 입력합니다:
    • 프로젝트 이름: 프로젝트 이름을 입력합니다.
    • 프로젝트 슬러그: 프로젝트의 경로를 입력합니다. GitLab은 URL 경로로 슬러그를 사용합니다.
    • 프로젝트 설명 (선택 사항): 프로젝트에 대한 설명을 입력합니다. 글자 제한은 500자입니다.
    • 가시성 레벨: 적합한 가시성 레벨을 선택합니다. 사용자의 보기 및 액세스 권한을 확인하세요.
  3. 프로젝트 구성 영역에서 실험 설정을 확장합니다.
  4. 저장소 해싱 알고리즘으로 SHA-256 사용을 선택합니다.
  5. 프로젝트 만들기를 선택합니다.

왜 SHA-256을 사용하는가?

기본적으로 Git은 커밋, 블롭, 트리, 태그와 같은 객체에 대해 40자의 ID를 생성하기 위해 SHA-1 해싱 알고리즘을 사용합니다. 그러나 Google이 해시 충돌을 생성할 수 있었을 때, SHA-1 알고리즘이 보안에 취약하다는 사실이 밝혀졌습니다. Git 프로젝트는 SHA-1과 같은 공격으로부터 아직 영향을 받지 않았습니다. 왜냐하면 Git이 객체를 저장하는 방식 때문입니다.

SHA-256 저장소에서 알고리즘은 40자 대신 64자 ID를 생성합니다. Git 프로젝트는 SHA-256 기능이 안전하게 사용될 수 있다고 판단하여 실험 라벨을 제거했습니다.

NIST 및 CISA 지침과 같은 연방 규정은 2030년까지 SHA-1 사용을 중단하도록 하고, 가능하다면 더 빨리 SHA-1을 사용하지 않도록 기권하고 있습니다.

git push로 프로젝트 생성하기

git push를 사용하여 로컬 프로젝트 저장소를 GitLab에 추가합니다. 저장소를 추가한 후, GitLab은 선택한 네임스페이스에 프로젝트를 생성합니다.

git push를 사용하여 이전에 사용되었거나 이름이 변경된 경로의 프로젝트를 생성할 수 없습니다.

이전에 사용된 프로젝트 경로에는 리디렉션이 있습니다. 새 프로젝트를 생성하는 대신, 리디렉션은 프로젝트 위치로의 요청을 다시 보냅니다. 이전에 사용된 또는 이름이 변경된 프로젝트를 위해 새 프로젝트를 생성하려면 UI나 프로젝트 API를 사용하세요.

필수 조건:

  • SSH로 푸시하려면 GitLab 계정에 추가된 SSH 키를 가져야 합니다.

  • 네임스페이스에 새로운 프로젝트를 추가할 권한이 있어야 합니다. 권한이 있는지 확인하려면:

    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으세요.
    2. 오른쪽 상단에서 새 프로젝트가 표시되는지 확인하세요.

필요한 권한이 없는 경우 GitLab 관리자에게 문의하십시오.

git push로 프로젝트를 생성하려면:

  1. 로컬 저장소에서 다음 중 하나를 푸시하세요:

    • SSH를 사용하는 경우 다음을 실행하세요: 

       # 프로젝트가 표준 포트 22를 사용하는 경우에 사용합니다
 $ git push --set-upstream git@gitlab.example.com:네임스페이스/내프로젝트.git main

 # 프로젝트가 비표준 포트 번호를 요구하는 경우에 사용합니다
 $ git push --set-upstream ssh://git@gitlab.example.com:00/네임스페이스/내프로젝트.git main

    • HTTP를 사용하는 경우 다음을 실행하세요: 

       git push --set-upstream https://gitlab.example.com/네임스페이스/내프로젝트.git master

      위 명령에서:

      • gitlab.example.com을 Git 저장소를 호스팅하는 기계 도메인 이름으로 교체하세요.
      • 네임스페이스 이름으로 네임스페이스를 교체하세요.
      • 프로젝트 이름으로 내프로젝트를 교체하세요.
      • 포트를 지정하는 경우에는 00을 프로젝트가 요구하는 포트 번호로 변경하세요.
      • 기존 저장소 태그를 내보내려면 --tags 플래그를 git push 명령에 추가하세요.

  2. 선택 사항. 원격 저장소 구성: 

    git remote add origin https://gitlab.example.com/네임스페이스/내프로젝트.git

푸시가 완료되면 GitLab은 다음 메시지를 표시합니다: 

remote: 비공개 프로젝트 네임스페이스/내프로젝트가 생성되었습니다.

새 프로젝트를 보려면 https://gitlab.example.com/네임스페이스/내프로젝트로 이동하세요. 기본적으로 프로젝트의 가시성이 비공개로 설정되어 있지만, 프로젝트의 가시성을 변경할 수 있습니다.

관련 주제