GDK 개발 환경 설치

GitLab 코드 기여를 하고 변경 내용을 테스트할 개발 환경이 필요하다면 GitLab Development Kit (GDK)를 사용할 수 있습니다. GDK는 GitLab의 로컬 버전으로, 여러분의 테스트를 위한 환경을 제공합니다.

GDK는 로컬 개발 환경으로, Self-Managed형 GitLab 설치, 샘플 프로젝트, 그리고 관리자 액세스를 포함하여 기능을 테스트할 수 있습니다.

GDK

로컬 가상 머신에서 GDK를 사용하려면 GDK-in-a-box 구성 단계를 따르세요.

이 단계의 대화식 데모 보기.

GitLab Development Kit (GDK) 설치 및 구성

이미 작동 중인 GDK가 있다면, 커뮤니티 포크를 사용하도록 업데이트하세요.

GDK 설치에 약 2시간 정도 시간을 내어야 합니다. 모든 것이 순조롭게 진행되면, 설치에 약 1시간 정도 걸립니다.

가끔 설치에 조정이 필요할 수 있으므로 문제 해결에 시간을 내도록 하세요.

많은 작업처럼 보일 수 있지만, GDK를 실행한 후에는 어떤 변경이든 할 수 있습니다.

GDK에서 GitLab

GDK를 설치하려면 다음을 수행하세요.

  1. 지원되는 플랫폼 중 하나에 있는지 확인하세요.
  2. Git이 설치되어 있고 소스 코드 편집기가 있는지 확인하세요.
  3. GDK를 설치할 디렉터리를 선택하세요. 설치 스크립트는 응용 프로그램을 gitlab-development-kit이라는 새 하위 디렉터리에 설치합니다.

    디렉터리 이름을 짧게 유지하세요. 일부 사용자는 긴 디렉터리 이름으로 인해 문제가 발생하는 경우가 있습니다.

  4. 명령줄에서 해당 디렉터리로 이동하세요. 다음 예제와 같이 dev 디렉터리를 만들고 변경하세요.

    mkdir ~/dev && cd "$_"
    
  5. 다음의 한 줄 설치 명령을 실행하세요.

    curl "https://gitlab.com/gitlab-org/gitlab-development-kit/-/raw/main/support/install" | bash
    

    설치 메시지 Where would you like to install the GDK? [./gitlab-development-kit]에 대해 Enter를 눌러 기본 위치를 수락합니다.

    GitLab 풀 URL을 입력하라는 메시지 Which GitLab repo URL would you like to clone?에 공동체 포크 URL을 입력하세요.

    https://gitlab.com/gitlab-community/gitlab.git
    
  6. GitLab would like to collect basic error and usage data 메시지에서 프롬프트에 따라 옵션을 선택하세요.

    설치 중에 표시된 메시지를 복사하세요. 설치에 문제가 있는 경우 이 출력물을 문제 해결의 부분으로 사용할 수 있습니다.

  7. 설치가 완료되면, 귀하의 셸에 해당하는 메시지에서 source 명령을 복사하세요.

    source ~/.asdf/asdf.sh
    
  8. GDK가 설치된 디렉터리로 이동하세요.

    cd gitlab-development-kit
    
  9. gdk truncate-legacy-tables를 실행하여 메인 및 CI 데이터베이스의 데이터가 잘린 후 gdk doctor를 실행하여 GDK 설치를 확인하세요.

    gdk truncate-legacy-tables && gdk doctor
    
    • gdk doctor가 오류를 반환하면 GDK 문제 해결 섹션을 참고하세요.
    • gdk doctorYour GDK is healthy를 반환하면 다음 단계로 진행하세요.
  10. GDK를 시작하세요.

    gdk start
    
  11. GitLab available at http://127.0.0.1:3000를 기다리고, 제공된 URL을 사용하여 GDK에 연결하세요.

  12. 사용자 이름 root와 비밀번호 5iveL!fe로 로그인하세요. 첫 로그인 시 비밀번호를 재설정하라는 메시지가 나타날 것입니다.

  13. GDK로 코드 변경을 계속하세요.

기존 GDK 설치 업데이트

기존 GDK 설치가 있는 경우, 커뮤니티 포크를 사용하도록 업데이트해야 합니다.

  1. 기존 gitlab-development-kit/gitlab 디렉터리를 삭제하세요.
  2. 커뮤니티 포크를 해당 위치에 복제하세요.

    cd gitlab-development-kit
    git clone https://gitlab.com/gitlab-community/gitlab.git
    

    성공적으로 실행되었는지 확인하세요.

  3. gitlab-development-kit/gitlab 디렉터리가 있는지 확인하세요.
  4. 최상위 gitlab-development-kit 디렉터리로 가서 gdk stopgdk start를 실행하세요.

오류가 발생하면 gdk doctor를 실행하여 문제를 해결하세요. 더 고급 문제 해결을 위해 문제 해결 섹션을 계속하세요.

GDK 문제 해결

문제가 발생하면 gitlab-development-kit/gitlab 디렉터리로 이동하여 gdk doctor를 실행하세요.

gdk doctor가 Node 또는 Ruby 관련 오류를 반환하면 다음을 실행하세요.

yarn install && bundle install
bundle exec rails db:migrate RAILS_ENV=development

더 고급 문제 해결을 위해서는 문제 해결 문서Discord의 #contribute 채널를 참고하세요.

코드 변경

GDK가 준비되었으면, GDK로 코드 기여를 계속하세요.