GDK-in-a-box 구성하기

컨테이너 기반 GDK-in-a-box를 사용하여 GitLab 코드베이스 기여를 위한 개발 환경을 설정하는 방법을 설명합니다.

GitLab 코드베이스에 기여하고 변경 사항을 테스트할 개발 환경이 필요하다면, GDK-in-a-box 를 사용할 수 있습니다. GDK-in-a-box는 GitLab Development Kit(GDK) 가 사전 구성된 멀티 플랫폼 컨테이너 이미지로 제공됩니다. GDK-in-a-box 가상 머신(VM) 이미지는 더 이상 지원되지 않으며, 컨테이너 기반 이미지로 대체되어 사용 중단(deprecated)되었습니다. GDK는 GitLab Self-Managed 설치본, 샘플 프로젝트, 그리고 기능을 테스트할 수 있는 관리자 접근 권한을 포함하는 로컬 개발 환경입니다. 30 GB의 디스크 공간이 필요합니다. 컨테이너 없이 로컬에서 GDK를 사용하려면 GDK 개발 환경 설치 단계를 따르세요. GDK-in-a-box 다운로드 # 컨테이너 런타임을 설치합니다. Docker Desktop , Docker Engine , Rancher Desktop 등 여러 옵션을 사용할 수 있습니다. Docker Desktop은 Homebrew 와 같은 패키지 매니저를 통해서도 설치할 수 있습니다. 참고 : Rancher Desktop에서는 "Preferences"에서 Kubernetes를 비활성화하는 것이 좋을 수 있습니다. Docker 호환 명령어를 지원하는 다른 컨테이너 런타임도 사용할 수 있습니다. 컨테이너 이미지를 Pull합니다. 이미지는 8 GB 이상의 다운로드가 필요하며 시간이 걸릴 수 있습니다. docker pull registry.gitlab.com/gitlab-org/gitlab-development-kit/gitlab-gdk-in-a-box:latest 이미지에서 컨테이너를 생성합니다: docker run -d -h gdk.local --name gdk \ -p 2022:2022 \ -p 2222:2222 \ -p 3000:3000 \ -p 3005:3005 \ -p 3010:3010 \ -p 3038:3038 \ -p 5100:5100 \ -p 5778:5778 \ -p 9000:9000 \ registry.gitlab.com/gitlab-org/gitlab-development-kit/gitlab-gdk-in-a-box:latest VS Code를 사용하여 GDK에 연결하기 로 계속 진행합니다. VS Code를 사용하여 GDK에 연결하기 # 이 단계의 데모 영상 보기 . 컨테이너 런타임을 시작하기 전에 CPU 코어 수와 RAM 등 시스템 구성을 변경해야 할 수 있습니다. 권장 구성은 최소 12 GB RAM, 4코어입니다. 컨테이너를 시작합니다. VS Code에서 Terminal > New terminal 을 선택한 후, 다음 curl 명령어를 실행하여 SSH 키를 로컬 ~/.ssh/config 에 추가합니다: curl "https://gitlab.com/gitlab-org/gitlab-development-kit/-/raw/main/support/gdk-in-a-box/setup-ssh-key" | bash 스크립트에 대해 더 알아보려면 set