자체 컴파일 설치

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

이것은 소스 파일을 사용하여 프로덕션 GitLab 서버를 설정하는 공식 설치 가이드입니다. Debian/Ubuntu 운영 체제에서 생성되었으며 테스트되었습니다. 하드웨어 및 운영 체제 요구 사항에 대해서는 requirements.md를 참조하십시오. RHEL/CentOS에서 설치하려는 경우 Linux 패키지를 사용해야 합니다. 다양한 설치 옵션에 대해서는 main installation page에서 확인하세요.

이 가이드는 많은 경우를 다루고 필요한 모든 명령을 포함하므로 길지만, 이는 상자에서 바로 작동하는 몇 안 되는 설치 스크립트 중 하나입니다. 다음 단계는 작동하는 것으로 알려져 있습니다. 이러한 안내에서 벗어날 때 주의하여 사용하세요. GitLab이 환경에 대한 가정을 위반하지 않도록 하세요. 예를 들어, 많은 사람들이 디렉토리의 위치를 변경하거나 잘못된 사용자로 서비스를 실행하여 권한 문제에 직면합니다.

이 가이드에서 버그/오류를 찾으신 경우, 기여 가이드를 따라 병합 요청을 제출해주세요.

Linux 패키지 설치를 고려하십시오

자체 컴파일 설치는 많은 작업을 필요로 하며 오류가 발생하기 쉬우므로 신속하고 안정적인 Linux 패키지 설치 (deb/rpm)를 강력히 권장합니다.

Linux 패키지가 더 안정적인 이유 중 하나는, GitLab 프로세스 중 하나가 비정상 종료되었을 경우 runit을 사용하여 다시 시작한다는 것입니다. 많이 사용되는 GitLab 인스턴스의 경우 Sidekiq 백그라운드 워커의 메모리 사용량이 시간이 지남에 따라 증가합니다. Linux 패키지는 이를 해결하기 위해 Sidekiq가 너무 많은 메모리를 사용하면 우아하게 종료시키고, 이 종료 후 runit이 Sidekiq가 실행되지 않음을 감지하고 시작시킵니다. 자체 컴파일 설치는 프로세스 감독을 위해 runit을 사용하지 않기 때문에 Sidekiq를 종료시키지 못하고 메모리 사용량이 계속 증가할 수 있습니다.

설치할 버전 선택

이 페이지의 지침을 따르면 설치하려는 GitLab 버전(예: 16-0-stable)으로부터 이 설치 가이드를 확인해야 합니다. GitLab 상단 왼쪽 모서리(메뉴 바 아래)의 버전 드롭다운 목록에서 버전을 선택할 수 있습니다.

가장 높은 번호의 안정적인 브랜치가 명확하지 않은 경우, 버전별 GitLab 블로그에서 설치 가이드 링크를 확인하세요.

소프트웨어 요구 사항

소프트웨어 최소 버전 참고
Ruby 3.1.x GitLab 16.7부터 Ruby 3.1이 필요합니다. 표준 MRI Ruby 구현을 사용해야 합니다. 우리는 JRuby와 Rubinius를 사랑하지만, GitLab에는 네이티브 확장을 가진 여러 Gems가 필요합니다.
RubyGems 3.4.x 특정 RubyGems 버전이 완전히 필요한 것은 아니지만, 알려진 성능 향상을 누릴 수 있도록 업데이트하는 것이 좋습니다.
Go 1.20.x GitLab 16.4부터 Go 1.20 이상이 필요합니다.
Git 2.42.x GitLab 16.5부터 Git 2.42.x 이상이 필요합니다. Gitaly에서 제공하는 Git 버전을 사용해야 합니다.
Node.js 18.17.x GitLab 16.3부터 Node.js 18.17 이상이 필요합니다.

GitLab 디렉터리 구조

이 페이지의 지침을 따르면, 다음과 같은 디렉토리 구조가 생성됩니다: 

|-- home
|   |-- git
|       |-- .ssh
|       |-- gitlab
|       |-- gitlab-shell
|       |-- repositories
  • /home/git/.ssh - OpenSSH 설정을 포함합니다. 구체적으로 GitLab Shell에서 관리하는 authorized_keys 파일이 있습니다.
  • /home/git/gitlab - GitLab 핵심 소프트웨어
  • /home/git/gitlab-shell - GitLab의 핵심 애드온 컴포넌트. SSH 클론 및 기타 기능을 유지합니다.
  • /home/git/repositories - 모든 프로젝트의 네임스페이스별로 구성된 베어 저장소가 있습니다. 이곳은 모든 프로젝트에 대해 푸시/풀하는 Git 저장소가 유지되는 곳입니다. 프로젝트에 대한 중요 데이터가 있는 영역입니다. 백업을 유지해야 합니다.

저장소의 기본 위치는 GitLab의 config/gitlab.yml 및 GitLab Shell의 config.yml에서 구성할 수 있습니다.

더 자세한 개요는 GitLab 아키텍처 문서를 참조하세요.

개요

GitLab 설치는 다음 구성 요소를 설정하는 것으로 구성됩니다:

  1. 패키지 및 종속성.
  2. Ruby.
  3. RubyGems.
  4. Go.
  5. Node.
  6. 시스템 사용자.
  7. 데이터베이스.
  8. Redis.
  9. GitLab.
  10. NGINX.

1. 패키지 및 종속성

sudo

Debian에는 기본적으로 sudo가 설치되어있지 않습니다. 시스템이 최신 상태이고 설치되어 있는지 확인하세요. 

# root로 실행!
apt-get update -y
apt-get upgrade -y
apt-get install sudo -y

빌드 종속성

필요한 패키지를 설치합니다(Ruby를 컴파일하고 Ruby 젬의 네이티브 익스텐션에 필요). 

sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libre2-dev \
  libreadline-dev libncurses5-dev libffi-dev curl openssh-server libxml2-dev libxslt-dev \
  libcurl4-openssl-dev libicu-dev libkrb5-dev logrotate rsync python3-docutils pkg-config cmake \
  runit-systemd

참고: GitLab은 OpenSSL 버전 1.1이 필요합니다. 만약 Linux 배포판에 다른 버전의 OpenSSL이 포함되어 있다면, 수동으로 1.1 버전을 설치해야 합니다.

Git

GitLab 13.6부터는 GitLab에서 제공하는 Git 버전 을 사용하는 것이 좋습니다. 이 Git 버전은:

  • GitLab에서 필요로 하는 버전과 항상 일치합니다.
  • 적절한 작동을 위해 필요한 사용자 정의 패치가 포함될 수 있습니다.

  1. 필요한 종속성을 설치합니다: 

    sudo apt-get install -y libcurl4-openssl-dev libexpat1-dev gettext libz-dev libssl-dev libpcre2-dev build-essential git-core

  2. Gitaly 저장소를 클론하고 Git을 컴파일합니다. <X-Y-stable>를 설치하려는 GitLab 버전에 맞는 stable 브랜치로 대체하세요. 예를 들어, GitLab 13.6을 설치하려면 13-6-stable 브랜치 이름을 사용하세요: 

    git clone https://gitlab.com/gitlab-org/gitaly.git -b <X-Y-stable> /tmp/gitaly
cd /tmp/gitaly
sudo make git GIT_PREFIX=/usr/local

  3. 선택적으로, 시스템 Git과 해당 종속성을 제거할 수 있습니다: 

    sudo apt remove -y git-core
sudo apt autoremove

나중에 config/gitlab.yml 편집을 할 때, Git 경로를 변경해야 합니다:

  • 다음과 같이: 

    git:
  bin_path: /usr/bin/git

  • 다음과 같이: 

    git:
  bin_path: /usr/local/bin/git

GraphicsMagick

사용자 정의 아이콘을 사용하려면 GraphicsMagick이 설치되어 있어야 합니다. 

sudo apt-get install -y graphicsmagick

메일 서버

메일 알림을 받으려면 메일 서버를 설치하세요. 기본적으로 Debian에는 exim4가 포함되어 있지만 이것은 문제가 있습니다 Ubuntu에는 기본적으로 포함되어 있지 않습니다. 권장하는 메일 서버는 postfix이며 다음과 같이 설치할 수 있습니다: 

sudo apt-get install -y postfix

그런 다음 ‘인터넷 사이트’를 선택하고 호스트 이름을 확인하려면 Enter 키를 누르세요.

ExifTool

GitLab Workhorse 은 업로드된 이미지에서 EXIF 데이터를 제거하기 위해 exiftool가 필요합니다. 

sudo apt-get install -y libimage-exiftool-perl

2. Ruby

GitLab을 실행하려면 Ruby 인터프리터가 필요합니다. 최소한의 Ruby 요구 사항은 요구 사항 섹션을 참조하세요(software-requirements).

GitLab을 프로덕션 환경에서 사용할 때, RVM, rbenv, chruby와 같은 Ruby 버전 관리자를 사용하는 것은 진단하기 어려운 문제로 이어질 수 있습니다. 버전 관리자는 지원되지 않으며, 시스템 Ruby를 사용하려면 아래 지침을 따르는 것을 강력히 권장합니다.

일반적으로 Linux 배포판에는 오래된 버전의 Ruby가 포함되어 있으므로 이러한 지침은 공식 소스 코드에서 Ruby를 설치하도록 설계되었습니다.

Ruby 설치.

3. RubyGems

때로는 Ruby와 번들로 제공되는 것보다 더 최신 버전의 RubyGems가 필요합니다.

특정 버전으로 업데이트하려면: 

gem update --system 3.4.12

또는 최신 버전으로: 

gem update --system

4. Go

GitLab에는 Go로 작성된 여러 개의 데몬이 있습니다. GitLab을 설치하려면 Go 컴파일러가 필요합니다. 아래 지침은 64비트 리눅스를 사용한다고 가정합니다. 다른 플랫폼용 다운로드는 Go 다운로드 페이지에서 찾을 수 있습니다. 

# 이전 Go 설치 폴더 제거하기
sudo rm -rf /usr/local/go

curl --remote-name --location --progress-bar "https://go.dev/dl/go1.20.8.linux-amd64.tar.gz"
echo 'cc97c28d9c252fbf28f91950d830201aa403836cbed702a05932e63f7f0c7bc4  go1.20.8.linux-amd64.tar.gz' | shasum -a256 -c - && \
  sudo tar -C /usr/local -xzf go1.20.8.linux-amd64.tar.gz
sudo ln -sf /usr/local/go/bin/{go,gofmt} /usr/local/bin/
rm go1.20.8.linux-amd64.tar.gz

5. Node

GitLab은 JavaScript 자산을 컴파일하기 위해 Node를 사용하고, JavaScript 종속성을 관리하기 위해 Yarn을 필요로 합니다. 현재 이들의 최소 요구 사항은 다음과 같습니다:

  • node 18.x 릴리스 (v18.17.0 이상). Node.js의 다른 LTS 버전은 자산을 빌드할 수 있지만, 우리는 Node.js 18.x만을 보장합니다.
  • yarn = v1.22.x (아직은 Yarn 2는 지원되지 않습니다)

많은 배포판에서 공식 패키지 저장소에서 제공하는 버전이 오래되어 있으므로, 다음 명령을 통해 설치해야 합니다: 

# node v18.x 설치
curl --location "https://deb.nodesource.com/setup_18.x" | sudo bash -
sudo apt-get install -y nodejs

npm install --global yarn

이 단계에 문제가 있는 경우 공식 웹 사이트인 Node와 Yarn을 방문해 보세요.

6. 시스템 사용자

GitLab을 위해 git 사용자를 생성하세요: 

sudo adduser --disabled-login --gecos 'GitLab' git

7. 데이터베이스

참고: GitLab 12.1 이상 버전에서는 PostgreSQL만 지원됩니다. GitLab 16.0 이상 버전에서는 PostgreSQL 13+를 필요로 합니다.

  1. 데이터베이스 패키지를 설치하세요.

    Ubuntu 22.04 이상의 경우: 

    sudo apt install -y postgresql postgresql-client libpq-dev postgresql-contrib

    Ubuntu 20.04 이하의 경우에는 사용 가능한 PostgreSQL 버전이 최소 요구 사항을 충족시키지 못합니다. 따라서 PostgreSQL의 저장소를 추가해야 합니다: 

    sudo sh -c 'echo "deb https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get -y install postgresql-14

  2. 설치한 PostgreSQL 버전이 설치하려는 GitLab 버전에서 지원되는지 확인하세요: 

    psql --version

  3. PostgreSQL 서비스를 시작하고 서비스가 실행 중인지 확인하세요: 

    sudo service postgresql start
sudo service postgresql status

  4. GitLab을 위한 데이터베이스 사용자를 생성하세요: 

    sudo -u postgres psql -d template1 -c "CREATE USER git CREATEDB;"

  5. pg_trgm 확장 기능을 생성하세요: 

    sudo -u postgres psql -d template1 -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"

  6. btree_gist 확장 기능을 생성하세요 (GitLab 13.1+에서 필요합니다): 

    sudo -u postgres psql -d template1 -c "CREATE EXTENSION IF NOT EXISTS btree_gist;"

  7. plpgsql 확장 기능을 생성하세요: 

    sudo -u postgres psql -d template1 -c "CREATE EXTENSION IF NOT EXISTS plpgsql;"

  8. GitLab 프로덕션 데이터베이스를 생성하고 데이터베이스에 대한 모든 권한을 부여하세요: 

    sudo -u postgres psql -d template1 -c "CREATE DATABASE gitlabhq_production OWNER git;"

  9. 새로운 사용자로 새 데이터베이스에 연결해 보세요: 

    sudo -u git -H psql -d gitlabhq_production

  10. pg_trgm 확장 기능이 활성화되었는지 확인하세요: 

    SELECT true AS enabled
FROM pg_available_extensions
WHERE name = 'pg_trgm'
AND installed_version IS NOT NULL;

    확장 기능이 활성화되었다면 다음 출력이 생성됩니다: 

    enabled
---------
 t
(1 row)

  11. btree_gist 확장 기능이 활성화되었는지 확인하세요: 

    SELECT true AS enabled
FROM pg_available_extensions
WHERE name = 'btree_gist'
AND installed_version IS NOT NULL;

    확장 기능이 활성화되었다면 다음 출력이 생성됩니다: 

    enabled
---------
 t
(1 row)

  12. plpgsql 확장 기능이 활성화되었는지 확인하세요: 

    SELECT true AS enabled
FROM pg_available_extensions
WHERE name = 'plpgsql'
AND installed_version IS NOT NULL;

    확장 기능이 활성화되었다면 다음 출력이 생성됩니다: 

    enabled
---------
 t
(1 row)

  13. 데이터베이스 세션을 종료하세요: 

    gitlabhq_production> \q

8. Redis

요구 사항 페이지에서 최소 Redis 요구 사항을 확인하세요.

다음을 사용하여 Redis를 설치하세요: 

sudo apt-get install redis-server

완료되면 Redis를 구성할 수 있습니다. 

# Redis를 소켓을 사용하도록 구성
sudo cp /etc/redis/redis.conf /etc/redis/redis.conf.orig

# 'port'를 0으로 설정하여 Redis의 TCP 수신을 비활성화
sudo sed 's/^port .*/port 0/' /etc/redis/redis.conf.orig | sudo tee /etc/redis/redis.conf

# 기본 Debian / Ubuntu 경로에 대한 Redis 소켓을 활성화
echo 'unixsocket /var/run/redis/redis.sock' | sudo tee -a /etc/redis/redis.conf

# 소켓에 대한 권한을 redis 그룹의 모든 구성원에게 부여
echo 'unixsocketperm 770' | sudo tee -a /etc/redis/redis.conf

# git을 redis 그룹에 추가
sudo usermod -aG redis git

systemd로 Redis 관리

시스템이 systemd init을 사용하고 다음 명령의 출력이 notify인 경우, 변경하면 안 됩니다. 

systemctl show --value --property=Type redis-server.service

출력이 notify가 아닌 경우 다음을 실행하세요: 

# Redis를 백그라운드에서 동작하지 않고 systemd에서 감시하도록 구성하고 pidfile을 비활성화
sudo sed -i \
         -e 's/^daemonize yes$/daemonize no/' \
         -e 's/^supervised no$/supervised systemd/' \
         -e 's/^pidfile/# pidfile/' /etc/redis/redis.conf
sudo chown redis:redis /etc/redis/redis.conf

# systemd 유닛 파일에 동일한 변경 사항 적용
sudo mkdir -p /etc/systemd/system/redis-server.service.d
sudo tee /etc/systemd/system/redis-server.service.d/10fix_type.conf <<EOF
[Service]
Type=notify
PIDFile=
EOF

# redis 서비스 다시 로드
sudo systemctl daemon-reload

# redis.conf 변경사항 활성화
sudo systemctl restart redis-server.service

Redis 감시하지 않고 둘 때

시스템이 SysV init을 사용하는 경우 다음 명령을 실행하세요: 

# 소켓을 포함하는 디렉터리 생성
sudo mkdir -p /var/run/redis
sudo chown redis:redis /var/run/redis
sudo chmod 755 /var/run/redis

# 적용 가능하다면 소켓을 포함하는 디렉터리 유지하기
if [ -d /etc/tmpfiles.d ]; then
  echo 'd  /var/run/redis  0755  redis  redis  10d  -' | sudo tee -a /etc/tmpfiles.d/redis.conf
fi

# redis.conf 변경사항 활성화
sudo service redis-server restart

9. GitLab 

# GitLab을 "git" 사용자의 홈 디렉터리에 설치합니다.
cd /home/git

소스 복제

커뮤니티 에디션 복제: 

# GitLab 리포지토리 복제
sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab-foss.git -b <X-Y-stable> gitlab

엔터프라이즈 에디션 복제: 

# GitLab 리포지토리 복제
sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab.git -b <X-Y-stable-ee> gitlab

설치하려는 버전과 일치하는 stable 브랜치로 <X-Y-stable>을 교체하세요. 예를 들어, 11.8을 설치하려면 브랜치 이름을 11-8-stable로 사용합니다.

경고: bleeding edge 버전을 원하는 경우 <X-Y-stable>을 master로 변경할 수 있지만, 생산 서버에는 절대 master를 설치하지 마십시오!

구성 

# GitLab 설치 폴더로 이동
cd /home/git/gitlab

# 예제 GitLab 구성 복사
sudo -u git -H cp config/gitlab.yml.example config/gitlab.yml

# GitLab 구성 파일 업데이트 - 파일 상단의 지침을 따르세요
sudo -u git -H editor config/gitlab.yml

# 예제 시크릿 파일 복사
sudo -u git -H cp config/secrets.yml.example config/secrets.yml
sudo -u git -H chmod 0600 config/secrets.yml

# GitLab이 log/ 및 tmp/ 디렉터리에 쓸 수 있도록 허용
sudo chown -R git log/
sudo chown -R git tmp/
sudo chmod -R u+rwX,go-w log/
sudo chmod -R u+rwX tmp/

# GitLab이 tmp/pids/ 및 tmp/sockets/ 디렉터리에 쓸 수 있도록 허용
sudo chmod -R u+rwX tmp/pids/
sudo chmod -R u+rwX tmp/sockets/

# public/uploads/ 디렉터리 생성
sudo -u git -H mkdir -p public/uploads/

# public/uploads/ 디렉터리에는 이제 gitlab-workhorse에서 서비스되는 파일만 액세스할 수 있도록 합니다
sudo chmod 0700 public/uploads

# CI 작업 로그를 저장하는 디렉터리의 권한 변경
sudo chmod -R u+rwX builds/

# CI 아티팩트를 저장하는 디렉터리의 권한 변경
sudo chmod -R u+rwX shared/artifacts/

# GitLab Pages를 저장하는 디렉터리의 권한 변경
sudo chmod -R ug+rwX shared/pages/

# 예제 Puma 구성 복사
sudo -u git -H cp config/puma.rb.example config/puma.rb

# https://github.com/puma/puma#configuration를 참조하세요.
# CPU 코어 수에 기초하여 Puma 워커 및 스레드를 확장하십시오. `nproc` 명령어를 사용하여 해당 숫자를 얻을 수 있습니다.
sudo -u git -H editor config/puma.rb

# Redis 연결 설정 구성
sudo -u git -H cp config/resque.yml.example config/resque.yml
sudo -u git -H cp config/cable.yml.example config/cable.yml

# 기본 Debian / Ubuntu 구성을 사용하지 않는 경우 Redis 소켓 경로를 변경하십시오.
sudo -u git -H editor config/resque.yml config/cable.yml

설정을 위해 gitlab.yml과 puma.rb를 수정하세요. HTTPS를 사용하려는 경우 추가 단계는 HTTPS 사용를 참조하세요.

GitLab DB 설정 구성

참고: GitLab 15.9부터는 database.yml에 main: 섹션만 있는 것이 사용되지 않습니다. GitLab 17.0 이상에서는 database.yml에 main: 및 ci: 섹션이 두 개 모두 있어야 합니다. 

sudo -u git cp config/database.yml.postgresql config/database.yml

# config/database.yml에서 host, username 및 password 줄을 제거합니다.
# 수정한 후 `production` 설정은 다음과 같을 것입니다:
#
#   production:
#     main:
#       adapter: postgresql
#       encoding: unicode
#       database: gitlabhq_production
#     ci:
#       adapter: postgresql
#       encoding: unicode
#       database: gitlabhq_production
#       database_tasks: false
#
sudo -u git -H editor config/database.yml

# 원격 PostgreSQL 전용:
# config/database.yml에서 username/password를 업데이트합니다.
# production 설정(첫 번째 부분) 만을 수정해야 합니다.
# 데이터베이스 가이드를 따랐다면, 다음과 같이 진행하십시오:
# '안전한 비밀번호'를 $password에 할당한 값으로 변경하십시오.
# 암호 주변의 이중 인용부호는 유지할 수 있습니다.
sudo -u git -H editor config/database.yml

# config/database.yml에서 `ci:` 섹션을 주석 처리 해제합니다.
# `ci:`의 `database` 값이 `main:`의 `database` 값과 일치하는지 확인합니다.

# config/database.yml을 git만 읽을 수 있도록 만듭니다
sudo -u git -H chmod o-rwx config/database.yml

database.yml에는 main: 및 ci: 두 개의 섹션이 있어야 합니다. ci: connection은 동일한 데이터베이스여야 합니다. 어떠한 이유로든 하나의 데이터베이스 연결을 유지하고 싶다면, config/database.yml에서 ci: 섹션을 제거하십시오.

Gems 설치

참고: Bundler 1.5.2 이후로 bundle install -jN (여기서 N은 프로세서 코어의 수입니다)를 호출하여 병렬 젬 설치를 사용할 수 있으며 완료 시간에 측정 가능한 차이가 있습니다 (~60% 빠름). nproc로 코어 수를 확인하십시오. 자세한 정보는 포스트를 참조하십시오.

bundle이 설치되었는지 확인하십시오 (bundle -v로 실행하십시오):

  • >= 1.5.2, 왜냐하면 1.5.2에서 일부 issues가 수정되었기 때문입니다.
  • < 2.x.

젬을 설치합니다 (사용자 인증에 Kerberos를 사용하려면 아래 --without 옵션에서 kerberos를 제외하십시오): 

sudo -u git -H bundle config set --local deployment 'true'
sudo -u git -H bundle config set --local without 'development test kerberos'
sudo -u git -H bundle config path /home/git/gitlab/vendor/bundle
sudo -u git -H bundle install

GitLab Shell 설치

GitLab Shell은 GitLab 전용으로 개발된 SSH 액세스 및 저장소 관리 소프트웨어입니다. 

# gitlab-shell에 대한 설치 작업 실행:
sudo -u git -H bundle exec rake gitlab:shell:install RAILS_ENV=production

# 기본적으로 gitlab-shell 구성은 주 GitLab 구성에서 생성됩니다.
# 다음과 같이 gitlab-shell 구성을 검토(및 수정)할 수 있습니다:
sudo -u git -H editor /home/git/gitlab-shell/config.yml

HTTPS를 사용하려면 추가 단계에 대해 HTTPS 사용을 참조하십시오.

호스트 이름이 올바른 DNS 레코드이거나 /etc/hosts에 추가 라인(“127.0.0.1 hostname”)으로 기기에서 해결될 수 있는지 확인하십시오. 예를 들어, GitLab을 역방향 프록시 뒤에 설정한 경우가 있습니다. 호스트 이름이 해결되지 않으면 최종 설치 확인에서 Check GitLab API access: FAILED. code: 401이 실패하고 커밋을 푸싱할 때 [remote rejected] master -> master (hook declined)가 거부됩니다.

GitLab Workhorse 설치

GitLab-Workhorse는 GNU Make를 사용합니다. 다음 명령행은 GitLab-Workhorse를 권장되는 위치인 /home/git/gitlab-workhorse에 설치합니다. 

sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse]" RAILS_ENV=production

추가 매개변수로 다른 Git 저장소를 지정할 수 있습니다: 

sudo -u git -H bundle exec rake "gitlab:workhorse:install[/home/git/gitlab-workhorse,https://example.com/gitlab-workhorse.git]" RAILS_ENV=production

기업용 에디션에 GitLab-Elasticsearch-indexer 설치

Tier: Premium, Ultimate Offering: Self-Managed

GitLab-Elasticsearch-Indexer은 GNU Make을 사용합니다.
다음 명령줄은 GitLab-Elasticsearch-Indexer를 권장되는 위치인 /home/git/gitlab-elasticsearch-indexer에 설치합니다. 

sudo -u git -H bundle exec rake "gitlab:indexer:install[/home/git/gitlab-elasticsearch-indexer]" RAILS_ENV=production

추가 매개변수로 다른 Git 저장소를 지정할 수 있습니다. 

sudo -u git -H bundle exec rake "gitlab:indexer:install[/home/git/gitlab-elasticsearch-indexer,https://example.com/gitlab-elasticsearch-indexer.git]" RAILS_ENV=production

먼저 소스 코드가 첫 번째 매개변수에서 지정한 경로로 가져온 후 해당 경로의 bin 디렉토리에 바이너리가 빌드됩니다.
그런 다음 gitlab.yml의 production -> elasticsearch -> indexer_path 설정을 해당 바이너리를 가리키도록 업데이트해야 합니다.

GitLab Pages 설치

GitLab Pages는 GNU Make을 사용합니다. 이 단계는 선택 사항으로, GitLab 내에서 정적 사이트를 호스팅하려는 경우에만 필요합니다. 아래 명령은 GitLab Pages를 /home/git/gitlab-pages에 설치합니다. 추가 설정 단계에 대해서는, GitLab의 해당 버전에 대한 관리 가이드를 참조하세요. GitLab Pages 데몬은 여러 가지 다른 방법으로 실행될 수 있습니다. 

cd /home/git
sudo -u git -H git clone https://gitlab.com/gitlab-org/gitlab-pages.git
cd gitlab-pages
sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_PAGES_VERSION)
sudo -u git -H make

Gitaly 설치 

# git 저장소 데이터 디렉터리 생성 및 액세스 제한
sudo install -d -o git -m 0700 /home/git/repositories

# Git으로 Gitaly 소스 가져오기 및 Go로 컴파일
cd /home/git/gitlab
sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories]" RAILS_ENV=production

추가 매개변수로 다른 Git 저장소를 지정할 수 있습니다. 

sudo -u git -H bundle exec rake "gitlab:gitaly:install[/home/git/gitaly,/home/git/repositories,https://example.com/gitaly.git]" RAILS_ENV=production

다음으로 Gitaly가 구성되었는지 확인하세요. 

# Gitaly 소켓 액세스 제한
sudo chmod 0700 /home/git/gitlab/tmp/sockets/private
sudo chown git /home/git/gitlab/tmp/sockets/private

#기본 설정 이외의 설정을 사용하는 경우 config.toml 업데이트 필요
cd /home/git/gitaly
sudo -u git -H editor config.toml

Gitaly 구성에 대한 자세한 정보는 Gitaly 문서를 참조하세요.

서비스 설치

GitLab은 항상 널리 지원되고 휴대성이 좋은 SysV init 스크립트를 지원했지만, 현재 systemd가 서비스 감시의 표준이며 모든 주요 Linux 배포판에서 사용되고 있습니다. 자동 재시작, 보다 나은 샌드박싱 및 리소스 제어를위한 네이티브 systemd 서비스를 사용하는 것이 좋습니다.

systemd 유닛 설치

시스템을 init으로 사용하는 경우 이 단계를 사용하십시오. 그렇지 않으면 SysV init script steps를 따르십시오.

서비스를 복사하고 systemctl daemon-reload를 실행하여 systemd가 이를 선택하도록 하십시오. 

cd /home/git/gitlab
sudo mkdir -p /usr/local/lib/systemd/system
sudo cp lib/support/systemd/* /usr/local/lib/systemd/system/
sudo systemctl daemon-reload

GitLab이 설치된 위치 또는 기본값이 아닌 사용자로 GitLab을 설치한 경우, 단위의 이러한 값을 변경해야합니다.

예를 들어 GitLab에서 Redis 및 PostgreSQL을 동일한 컴퓨터에서 실행하는 경우 다음을 수행해야 합니다.

  • Puma 서비스 편집: 

    sudo systemctl edit gitlab-puma.service

    열리는 편집기에 다음을 추가하고 파일을 저장하세요. 

    [Unit]
Wants=redis-server.service postgresql.service
After=redis-server.service postgresql.service

  • Sidekiq 서비스 편집: 

    sudo systemctl edit gitlab-sidekiq.service

    다음을 추가하고 파일을 저장하세요. 

    [Unit]
Wants=redis-server.service postgresql.service
After=redis-server.service postgresql.service

systemctl edit는 /etc/systemd/system/<name of the unit>.d/override.conf에 드롭인 구성 파일을 설치하여 나중에 단위 파일을 업데이트 할 때 로컬 구성이 덮어쓰이지 않도록합니다. 드롭인 구성 파일을 분리하려면 .conf 파일에 위의 스니펫을 추가하십시오.

수동으로 단위 파일을 변경하거나 systemctl edit를 사용하지 않고 드롭인 구성 파일을 추가 한 경우 (사용하지 않은 경우), 해당 명령을 실행하여 이러한 파일이 적용되도록하십시오. 

sudo systemctl daemon-reload

부팅시 GitLab을 시작하도록 만듭니다. 

sudo systemctl enable gitlab.target

SysV 초기화 스크립트 설치

만일 SysV 초기화 스크립트를 사용 중이라면 이 단계를 따르세요. 만일 systemd를 사용 중이라면 systemd 유닛 단계를 따르세요.

초기화 스크립트를 다운로드합니다 (이는 /etc/init.d/gitlab에 위치합니다): 

cd /home/git/gitlab
sudo cp lib/support/init.d/gitlab /etc/init.d/gitlab

그리고 기본 폴더나 사용자가 아닌 다른 폴더나 사용자로 설치하는 경우, defaults 파일을 복사하고 편집하세요: 

sudo cp lib/support/init.d/gitlab.default.example /etc/default/gitlab

만일 GitLab을 다른 디렉토리에 설치하거나 기본 사용자가 아닌 사용자로 설치했다면 이러한 설정을 /etc/default/gitlab 파일에서 변경해야 합니다. 업그레이드 시 변경되므로 /etc/init.d/gitlab을 편집하지 마십시오.

부팅 시 GitLab을 시작하도록 설정하세요: 

sudo update-rc.d gitlab defaults 21
# 또는 systemd를 사용하는 기계에서 실행 중인 경우
sudo systemctl daemon-reload
sudo systemctl enable gitlab.service

Logrotate 설정 

sudo cp lib/support/logrotate/gitlab /etc/logrotate.d/gitlab

Gitaly 시작

다음 섹션을 진행하려면 Gitaly가 실행 중이어야 합니다.

  • systemd를 사용하여 Gitaly 시작: 

    sudo systemctl start gitlab-gitaly.service

  • SysV에서 수동으로 Gitaly 시작: 

    gitlab_path=/home/git/gitlab
gitaly_path=/home/git/gitaly

sudo -u git -H sh -c "$gitlab_path/bin/daemon_with_pidfile $gitlab_path/tmp/pids/gitaly.pid \
  $gitaly_path/_build/bin/gitaly $gitaly_path/config.toml >> $gitlab_path/log/gitaly.log 2>&1 &"

데이터베이스 초기화 및 고급 기능 활성화 

cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production
# 데이터베이스 테이블을 만들려면 'yes'를 입력하세요.

# 또는 force=yes를 추가하여 질문을 건너뛸 수 있습니다
sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production force=yes

# 완료되면 '관리자 계정이 생성됨:'을 볼 수 있습니다.

아래와 같이 환경 변수인 GITLAB_ROOT_PASSWORD와 GITLAB_ROOT_EMAIL을 입력하여 관리자/root 암호와 이메일을 설정할 수 있습니다. 암호를 설정하지 않은 경우(그리고 기본 설정값인 경우) 설치가 완료된 후 서버에 처음 로그인할 때까지 공개 인터넷에 GitLab을 노출시키지 마십시오. 첫 로그인 시 기본 암호를 변경해야 합니다. Enterprise Edition 구독 등록을 위해 활성화 코드를 GITLAB_ACTIVATION_CODE 환경 변수에 제공하여 이 시간에도 같이 활성화할 수 있습니다. 

sudo -u git -H bundle exec rake gitlab:setup RAILS_ENV=production GITLAB_ROOT_PASSWORD=yourpassword GITLAB_ROOT_EMAIL=youremail GITLAB_ACTIVATION_CODE=yourcode

secrets.yml 보안 설정

secrets.yml 파일은 세션 및 안전한 변수의 암호화 키를 저장합니다. secrets.yml을 안전한 곳에 백업하세요. 그러나 데이터베이스 백업과 함께 저장하지 마십시오. 그렇지 않으면 백업 중 하나가 노출된다면 보안이 취약해집니다.

애플리케이션 상태 확인

GitLab 및 환경이 올바르게 구성되었는지 확인하세요: 

sudo -u git -H bundle exec rake gitlab:env:info RAILS_ENV=production

에셋 컴파일 

sudo -u git -H yarn install --production --pure-lockfile
sudo -u git -H bundle exec rake gitlab:assets:compile RAILS_ENV=production NODE_ENV=production

rake가 JavaScript heap out of memory 오류로 실패하는 경우, 다음과 같이 NODE_OPTIONS를 설정하여 실행해 보세요. 

sudo -u git -H bundle exec rake gitlab:assets:compile RAILS_ENV=production NODE_ENV=production NODE_OPTIONS="--max_old_space_size=4096"

GitLab 인스턴스 시작 

# systemd를 사용하는 시스템의 경우
sudo systemctl start gitlab.target

# SysV init를 사용하는 시스템의 경우
sudo service gitlab start

10. NGINX

NGINX는 GitLab의 공식적으로 지원하는 웹 서버입니다. 만일 NGINX를 웹 서버로 사용할 수 없거나 원하지 않는다면 GitLab 레시피를 참조하세요.

설치 

sudo apt-get install -y nginx

사이트 설정

예제 사이트 설정을 복사하세요: 

sudo cp lib/support/nginx/gitlab /etc/nginx/sites-available/gitlab
sudo ln -s /etc/nginx/sites-available/gitlab /etc/nginx/sites-enabled/gitlab

설정 파일을 자신의 설치에 맞게 편집하세요. 특히, git 사용자가 아닌 다른 사용자를 위해 설치하는 경우 경로를 일치시키세요: 

# YOUR_SERVER_FQDN을 호스트 서빙하는 완전히 지정된 도메인 이름으로 변경하세요.
#
# 특히 'git' 사용자가 아닌 경우에는 GitLab 경로를 일치시키는 것을 잊지 마십시오.
#
# Ubuntu의 기본 nginx 설치를 사용하는 경우:
# listen 라인에서 default_server를 제거하거나
# 또는 sudo rm -f /etc/nginx/sites-enabled/default를 실행하세요
sudo editor /etc/nginx/sites-available/gitlab

GitLab Pages를 활성화하려면 별도의 NGINX 구성을 사용해야 합니다. 필요한 구성에 대해 자세히 읽으세요. GitLab Pages 관리 가이드에서 필요한 모든 구성 내용을 확인하세요.

HTTPS를 사용하려면 gitlab NGINX 구성을 gitlab-ssl로 대체하세요. HTTPS 구성 세부 정보는 HTTPS 사용를 참조하세요.

NGINX가 GitLab-Workhorse 소켓을 읽을 수 있도록 하려면 소켓이 GitLab 사용자가 소유한 것이므로 www-data 사용자가 읽을 수 있도록 해야 합니다. 이것은 기본값인 0755 권한이 있으므로 소켓이 전체적으로 읽을 수 있어야 합니다. www-data는 부모 디렉토리를 나열할 수 있어야 합니다.

테스트 구성

다음 명령어로 gitlab 또는 gitlab-ssl NGINX 구성 파일을 유효성 검사하세요: 

sudo nginx -t

syntax is okay와 test is successful 메시지를 받아야 합니다. 오류 메시지를 받으면 제공된 오류 메시지에 나온 대로 gitlab 또는 gitlab-ssl NGINX 구성 파일을 오타를 확인하세요.

설치된 버전이 1.12.1보다 큰지 확인하세요: 

nginx -v

만약 낮다면, 아래의 오류를 받을 수 있습니다: 

nginx: [emerg] unknown "start$temp=[filtered]$rest" variable
nginx: configuration file /etc/nginx/nginx.conf test failed

다시 시작 

# systemd를 실행 중인 시스템의 경우
sudo systemctl restart nginx.service

# SysV init를 실행 중인 시스템의 경우
sudo service nginx restart

설치 후 조치

애플리케이션 상태 다시 확인

누락된 사항이 없는지 확인하려면 더 철저한 확인을 실행하세요: 

sudo -u git -H bundle exec rake gitlab:check RAILS_ENV=production

모든 항목이 녹색이라면, GitLab을 성공적으로 설치한 것을 축하드립니다!

참고: SANITIZE=true 환경 변수를 gitlab:check에 제공하여 확인 명령어의 출력에서 프로젝트 이름을 생략할 수 있습니다.

초기 로그인

첫 번째 GitLab 로그인을 위해 웹 브라우저에서 YOUR_SERVER로 방문하세요.

만약 설정 과정 중에 루트 암호를 제공하지 않았다면, 초기 관리자 계정의 암호를 제공하기 위해 비밀번호 재설정 화면으로 이동합니다. 원하는 비밀번호를 입력한 후 로그인 화면으로 돌아갑니다.

기본 계정의 사용자 이름은 root입니다. 이전에 생성한 비밀번호를 제공하고 로그인하세요. 로그인 후, 원하신다면 사용자 이름을 변경할 수 있습니다.

즐겁게 사용하세요!

systemd 유닛을 사용할 경우 GitLab 시작 및 중지: sudo systemctl start gitlab.target 또는 sudo systemctl stop gitlab.target. SysV init 스크립트를 사용하는 경우 GitLab 시작 및 중지: sudo service gitlab start 또는 sudo service gitlab stop.

권장 다음 단계

설치를 완료한 후, 인증 옵션 및 가입 제한을 포함한 권장 다음 단계를 고려해보세요.

고급 설정 팁

상대 URL 지원

GitLab을 상대 URL로 구성하는 방법에 대한 자세한 내용은 상대 URL 문서를 참조하세요.

HTTPS 사용

HTTPS로 GitLab을 사용하려면:

  1. gitlab.yml에서:
    1. 섹션 1의 port 옵션을 443으로 설정하세요.
    2. 섹션 1의 https 옵션을 true로 설정하세요.
  2. GitLab Shell의 config.yml에서:
    1. gitlab_url 옵션을 GitLab의 HTTPS 엔드포인트로 설정하세요 (예: https://git.example.com).
    2. ca_file 또는 ca_path 옵션을 사용하여 인증서를 설정하세요.
  3. gitlab-ssl NGINX 예제 구성을 gitlab 구성 대신 사용하세요.
    1. YOUR_SERVER_FQDN을 업데이트하세요.
    2. ssl_certificate 및 ssl_certificate_key를 업데이트하세요.
    3. 구성 파일을 검토하고 다른 보안 및 성능 향상 기능을 적용하는 것을 고려하세요.

자체 서명 인증서 사용은 권장하지 않습니다. 사용해야 한다면, 표준 지침을 따르고 자체 서명 SSL 인증서를 생성하세요: 

   mkdir -p /etc/nginx/ssl/
   cd /etc/nginx/ssl/
   sudo openssl req -newkey rsa:2048 -x509 -nodes -days 3560 -out gitlab.crt -keyout gitlab.key
   sudo chmod o-r gitlab.key

이메일 답장 활성화

이를 설정하는 방법에 대한 자세한 내용은 “이메일로 답장” 문서를 참조하세요.

LDAP 인증

config/gitlab.yml에서 LDAP 인증을 구성할 수 있습니다. 이 파일을 편집한 후 GitLab을 다시 시작하세요.

사용자 지정 OmniAuth 제공자 사용

OmniAuth 통합 문서를 참조하세요.

프로젝트 빌드하기

GitLab은 프로젝트를 빌드할 수 있습니다. 이 기능을 활성화하려면 이를 대신해 실행해줄 실행자가 필요합니다. 설치 방법에 대해서는 GitLab Runner 섹션을 참조하세요.

신뢰하는 프록시 추가하기

별도의 장비에서 역방향 프록시를 사용한다면, 사용자가 해당 프록시의 IP 주소에서 로그인한 것처럼 표시되지 않도록 신뢰하는 프록시 목록에 프록시를 추가하는 것이 좋습니다.

config/gitlab.yml에 신뢰하는 프록시를 추가할 수 있습니다. 변경 사항이 적용되려면 파일을 저장하고 GitLab 다시 구성을 실행하세요.

사용자 정의 Redis 연결

비표준 포트나 다른 호스트에서 Redis 서버에 연결하려는 경우, config/resque.yml 파일을 통해 연결 문자열을 구성할 수 있습니다. 

# 예시
production:
  url: redis://redis.example.tld:6379

Redis 서버를 소켓을 통해 연결하려는 경우, config/resque.yml 파일에서 unix: URL scheme 및 Redis 소켓 파일의 경로를 사용하세요. 

# 예시
production:
  url: unix:/path/to/redis/socket

또한, config/resque.yml 파일에서 환경 변수를 사용할 수 있습니다. 

# 예시
production:
  url: <%= ENV.fetch('GITLAB_REDIS_URL') %>

사용자 정의 SSH 연결

SSH를 특정 포트에서 실행 중인 경우, GitLab 사용자의 SSH 구성을 변경해야 합니다. 

# /home/git/.ssh/config에 추가
host localhost          # 설정의 이름을 지정합니다 (여기서는 localhost를 재정의 함)
    user git            # 원격 git 사용자
    port 2222           # 포트 번호
    hostname 127.0.0.1; # 서버 이름 또는 IP

또한, config/gitlab.yml 파일에서 해당 옵션(예: ssh_user, ssh_host, admin_uri)을 변경해야 합니다.

추가 마크업 스타일

Markdown 스타일 외에도, GitLab이 표시할 수 있는 다른 리치 텍스트 파일이 있습니다. 그러나 이를 위해 종속성을 설치해야 할 수도 있습니다. 자세한 내용은 github-markup gem README를 참조하세요.

Prometheus 서버 설정

config/gitlab.yml에서 Prometheus 서버를 구성할 수 있습니다: 

# 예시
prometheus:
  enabled: true
  server_address: '10.1.2.3:9090'

문제 해결

“클론한 빈 저장소가 있는 것으로 보입니다.”

GitLab에서 호스팅하는 저장소를 클론하려고 할 때 이 메시지가 표시되는 경우, 이는 오래된 NGINX 또는 Apache 구성, 또는 누락되거나 잘못 구성된 GitLab Workhorse 인스턴스 때문일 수 있습니다. Go를 설치, GitLab Workhorse를 설치, 그리고 NGINX를 올바르게 구성했는지 다시 확인하세요.

google-protobuf “LoadError: /lib/x86_64-linux-gnu/libc.so.6: version ‘GLIBC_2.14’ not found”

일부 플랫폼에서 특정 버전의 google-protobuf gem의 경우 발생할 수 있습니다. 이 문제의 해결책은 이 젬의 소스 전용 버전을 설치하는 것입니다.

먼저, GitLab 설치에 필요한 정확한 google-protobuf 버전을 찾아야 합니다: 

cd /home/git/gitlab

# 아래 명령 중 하나만 출력합니다. 출력은 다음과 같을 것입니다: * google-protobuf (3.2.0)
bundle list | grep google-protobuf
bundle check | grep google-protobuf

아래에서는 3.2.0을 예시로 사용하였습니다. 여기서 찾은 버전 번호로 교체하세요: 

cd /home/git/gitlab
sudo -u git -H gem install google-protobuf --version 3.2.0 --platform ruby

마지막으로, google-protobuf이 올바르게 로드되는지 테스트할 수 있습니다. 다음은 ‘OK’를 출력해야 합니다. 

sudo -u git -H bundle exec ruby -rgoogle/protobuf -e 'puts :OK'

만약 gem install 명령이 실패한다면, OS의 개발 도구를 설치해야 할 수 있습니다.

Debian/Ubuntu의 경우: 

sudo apt-get install build-essential libgmp-dev

RedHat/CentOS의 경우: 

sudo yum groupinstall 'Development Tools'

GitLab 자산 컴파일 오류

자산을 컴파일하는 동안 다음과 같은 오류 메시지를 받을 수 있습니다: 

Killed
error Command failed with exit code 137.

이것은 Yarn이 메모리를 모두 소비하여 컨테이너를 종료시킬 때 발생할 수 있습니다. 이를 해결하기 위해 다음을 수행하세요:

  1. 시스템 메모리를 최소 8GB로 늘리세요.

  2. 자산을 정리하기 위해 다음 명령을 실행하세요: 

    sudo -u git -H bundle exec rake gitlab:assets:clean RAILS_ENV=production NODE_ENV=production

  3. 충돌을 해결하기 위해 yarn 명령을 다시 실행하세요: 

    sudo -u git -H yarn install --production --pure-lockfile

  4. 자산을 다시 컴파일하세요: 

    sudo -u git -H bundle exec rake gitlab:assets:compile RAILS_ENV=production NODE_ENV=production