GDK 개발 환경 설치
GitLab 코드 기여를 원하고 변경 사항을 테스트할 개발 환경이 필요한 경우, GitLab Development Kit (GDK)을 사용할 수 있습니다. 이는 플레이할 수 있는 로컬 버전의 GitLab인 GDK로, 설치된 자체 관리 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
- 메시지
GDK를 어디에 설치하시겠습니까? [./gitlab-development-kit]
에 대해 Enter를 눌러 기본 위치를 수락하세요. -
메시지
GitLab 리포지토리 URL을 입력하세요.
에 대해 GitLab 커뮤니티 포크 URL을 입력하세요.https://gitlab.com/gitlab-community/gitlab.git
-
메시지
GitLab은 기본 오류 및 사용 데이터를 수집하고자 합니다.
에 대해 프롬프트에 따라 옵션 선택하세요.설치가 진행되는 동안 표시된 모든 메시지를 복사하세요. 설치에 문제가 있는 경우 이 출력물을 문제 해결의 일부로 사용할 수 있습니다.
-
설치가 완료되면 메시지에서 셸에 해당하는
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
-
http://127.0.0.1:3000
에서GitLab available at
메시지가 나타날 때까지 기다리고 제공된 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 문제 해결 섹션으로 이동하세요.
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로 코드 기여하기를 계속하세요.