라즈베리 파이에서 실행

Tier: Free, Premium, Ultimate Offering: Self-Managed

GitLab Community Edition을 라즈베리 파이에서 실행하기 위해서는 최소 4GB RAM이 장착된 새로운 Pi 4가 필요합니다. Pi 2 이상의 하위 리소스에서도 GitLab을 실행할 수 있지만 권장하지는 않습니다. CPU와 RAM이 충분하지 않기 때문에 오래된 Pi에 대한 패키지는 제공되지 않습니다.

지원되는 아키텍처는 armhf뿐입니다. arm64 지원을 원하신다면 이 epic을 참조하세요.

스왑 구성

새로운 Pi라도 메모리를 확보하기 위해 첫 번째로 변경해야 할 설정은 스왑 공간을 4GB로 확장하는 것입니다.

Raspbian에서는 스왑을 /etc/dphys-swapfile에서 구성할 수 있습니다. 사용 가능한 설정에 대해서는 맨페이지를 참조하세요.

GitLab 설치

GitLab을 설치하는 권장되는 방법은 GitLab 공식 리포지터리를 사용하는 것입니다.

공식 라즈베리 파이 배포만 지원됩니다.(여기 참조)

공식 리포지터리를 통한 GitLab 설치

설치 페이지를 방문하여 라즈베리 Pi OS를 선택하고 GitLab을 설치하는 지침에 따르세요.

매뉴얼으로 GitLab 다운로드

선택한 배포판이 Raspbian이 아닌 Debian 기반인 경우 매뉴얼으로 GitLab을 다운로드하고 설치할 수 있습니다.

실행 중인 프로세스 줄이기

라즈베리 파이가 GitLab을 실행하는 데 어려움을 겪는다면 다음과 같이 실행 중인 프로세스를 줄일 수 있습니다.

  1. /etc/gitlab/gitlab.rb을 열고 다음 설정을 변경하세요.

    # 메모리 사용량을 줄이기 위해 실행 중인 워커 수를 최소로 줄입니다
    puma['worker_processes'] = 2
    sidekiq['concurrency'] = 9
    # 유휴 CPU 및 디스크 사용량을 줄이기 위해 모니터링을 끕니다
    prometheus_monitoring['enable'] = false
    
  2. GitLab을 다시 구성합니다.

    sudo gitlab-ctl reconfigure
    

추가 권장 사항

몇 가지 설정으로 GitLab 성능을 향상시킬 수 있습니다.

적절한 하드 드라이브 사용

/var/opt/gitlab과 스왑 파일을 SD 카드가 아닌 하드 드라이브에 마운트하면 GitLab이 최적의 성능을 발휘합니다. USB 인터페이스를 통해 외장 하드 드라이브를 Pi에 연결할 수 있습니다.

외부 서비스 사용

GitLab 성능을 향상시키기 위해 GitLab을 외부 데이터베이스Redis 인스턴스에 연결할 수 있습니다.