GDK 개발 환경 설치
GitLab 코드 기여를 하고 변경 내용을 테스트할 개발 환경이 필요하다면 GitLab Development Kit (GDK)를 사용할 수 있습니다. GDK는 GitLab의 로컬 버전으로, 여러분의 테스트를 위한 환경을 제공합니다.
GDK는 로컬 개발 환경으로, Self-Managed형 GitLab 설치, 샘플 프로젝트, 그리고 관리자 액세스를 포함하여 기능을 테스트할 수 있습니다.
로컬 가상 머신에서 GDK를 사용하려면 GDK-in-a-box 구성 단계를 따르세요.
GitLab Development Kit (GDK) 설치 및 구성
이미 작동 중인 GDK가 있다면, 커뮤니티 포크를 사용하도록 업데이트하세요.
GDK 설치에 약 2시간 정도 시간을 내어야 합니다. 모든 것이 순조롭게 진행되면, 설치에 약 1시간 정도 걸립니다.
가끔 설치에 조정이 필요할 수 있으므로 문제 해결에 시간을 내도록 하세요.
많은 작업처럼 보일 수 있지만, GDK를 실행한 후에는 어떤 변경이든 할 수 있습니다.
GDK를 설치하려면 다음을 수행하세요.
- 지원되는 플랫폼 중 하나에 있는지 확인하세요.
- Git이 설치되어 있고 소스 코드 편집기가 있는지 확인하세요.
-
GDK를 설치할 디렉터리를 선택하세요. 설치 스크립트는 응용 프로그램을
gitlab-development-kit
이라는 새 하위 디렉터리에 설치합니다.디렉터리 이름을 짧게 유지하세요. 일부 사용자는 긴 디렉터리 이름으로 인해 문제가 발생하는 경우가 있습니다.
-
명령줄에서 해당 디렉터리로 이동하세요. 다음 예제와 같이
dev
디렉터리를 만들고 변경하세요.mkdir ~/dev && cd "$_"
-
다음의 한 줄 설치 명령을 실행하세요.
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
-
GitLab would like to collect basic error and usage data
메시지에서 프롬프트에 따라 옵션을 선택하세요.설치 중에 표시된 메시지를 복사하세요. 설치에 문제가 있는 경우 이 출력물을 문제 해결의 부분으로 사용할 수 있습니다.
-
설치가 완료되면, 귀하의 셸에 해당하는 메시지에서
source
명령을 복사하세요.source ~/.asdf/asdf.sh
-
GDK가 설치된 디렉터리로 이동하세요.
cd gitlab-development-kit
-
gdk truncate-legacy-tables
를 실행하여 메인 및 CI 데이터베이스의 데이터가 잘린 후gdk doctor
를 실행하여 GDK 설치를 확인하세요.gdk truncate-legacy-tables && gdk doctor
-
gdk doctor
가 오류를 반환하면 GDK 문제 해결 섹션을 참고하세요. -
gdk doctor
가Your GDK is healthy
를 반환하면 다음 단계로 진행하세요.
-
-
GDK를 시작하세요.
gdk start
-
GitLab available at http://127.0.0.1:3000
를 기다리고, 제공된 URL을 사용하여 GDK에 연결하세요. -
사용자 이름
root
와 비밀번호5iveL!fe
로 로그인하세요. 첫 로그인 시 비밀번호를 재설정하라는 메시지가 나타날 것입니다. - GDK로 코드 변경을 계속하세요.
기존 GDK 설치 업데이트
기존 GDK 설치가 있는 경우, 커뮤니티 포크를 사용하도록 업데이트해야 합니다.
- 기존
gitlab-development-kit/gitlab
디렉터리를 삭제하세요. -
커뮤니티 포크를 해당 위치에 복제하세요.
cd gitlab-development-kit git clone https://gitlab.com/gitlab-community/gitlab.git
성공적으로 실행되었는지 확인하세요.
-
gitlab-development-kit/gitlab
디렉터리가 있는지 확인하세요. - 최상위
gitlab-development-kit
디렉터리로 가서gdk stop
과gdk 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로 코드 기여를 계속하세요.