GDK-in-a-box 구성하기

GitLab 코드베이스에 기여하고 변경 사항을 테스트할 개발 환경을 원하신다면, GDK-in-a-box를 사용할 수 있습니다.

이는 GitLab 개발 키트(GDK)로 미리 구성된 가상 머신(VM)입니다.

GDK는 자체 관리 GitLab 설치, 샘플 프로젝트 및 기능을 테스트할 수 있는 관리자 액세스를 포함한 로컬 개발 환경입니다.

30GB의 디스크 공간이 필요합니다.

GDK

VM 없이 로컬에서 GDK를 사용하고 싶다면 GDK 개발 환경 설치 단계를 사용하세요.

GDK-in-a-box 다운로드

  1. 가상 머신을 실행하기 위해 가상화 소프트웨어를 다운로드하고 설치하세요:
    • Apple silicon이 탑재된 Mac 컴퓨터: UTM. Download from GitHub를 선택하세요.
    • Intel silicon이 탑재된 Linux / Windows / Mac 컴퓨터: VirtualBox
  2. GDK-in-a-box를 다운로드하고 압축을 풉니다. 파일 크기는 최대 15GB이며 다운로드에 시간이 걸릴 수 있습니다:
  3. 가상 머신 이미지를 더블 클릭하여 엽니다:
    • UTM: gdk.utm
    • VirtualBox: gdk.vbox
  4. VS Code를 사용하여 GDK에 연결을 계속 진행하세요.

VS Code를 사용하여 GDK에 연결

이 단계의 데모 비디오 보기.

참고:

가상 머신을 시작하기 전에 시스템 구성(CPU 코어 및 RAM)을 수정해야 할 수 있습니다.

  1. VM을 시작합니다(UTM 또는 VirtualBox를 최소화할 수 있습니다).

  2. VS Code에서 Terminal > New terminal을 선택한 후, SSH 키를 로컬 ~/.ssh/config에 추가하는 curl 명령을 실행합니다:

    curl "https://gitlab.com/gitlab-org/gitlab-development-kit/-/raw/main/support/gdk-in-a-box/setup-ssh-key" | bash

    스크립트에 대해 더 알아보려면 setup-ssh-key 코드를 확인할 수 있습니다.

  3. VS Code에서 Remote - SSH 확장을 설치합니다:
  4. VS Code를 VM에 연결합니다:
    • 명령 팔레트에서 Remote-SSH: Connect to host를 선택합니다.
    • SSH 호스트를 입력합니다: debian@gdk.local

  5. 새로운 VS Code 창이 열립니다.

    혼란을 피하기 위해 이전 창을 닫으세요.

    새로운 창에서 나머지 단계를 완료하세요.

  6. VS Code 터미널에서 Git을 GDK에 구성하는 curl 명령을 실행합니다:

    curl "https://gitlab.com/gitlab-org/gitlab-development-kit/-/raw/main/support/gdk-in-a-box/first_time_setup" | bash

    스크립트에 대해 더 알아보려면 first_time_setup 코드를 확인할 수 있습니다.

  7. VS Code에서 File > Open folder를 선택하고 다음으로 이동합니다: /home/debian/gitlab-development-kit/gitlab/.

  8. 브라우저에서 GitLab을 엽니다: http://gdk.local:3000.

  9. 사용자 이름 root와 비밀번호 5iveL!fe로 로그인합니다.

  10. GDK로 코드 변경하기로 계속 진행하세요.

GDK 종료

가상 머신을 종료하려면 전원 아이콘( )을 선택하거나 터미널에 shutdown 명령을 입력할 수 있습니다.

비밀번호는 debian입니다:

sudo shutdown now

GDK-in-a-box 업데이트

VS Code에서 debian@gdk.local에 연결된 상태에서 GDK-in-a-box를 업데이트할 수 있습니다.

VS Code 터미널에 입력하세요:

gdk update

코드 변경

GDK가 준비된 후, GDK로 코드 기여하기로 계속 진행하세요.