Установка и настройка GitLab Server

+-------------------------------------------------------------------+
|                        GITLAB SERVER                              |
|                                                                   |
|  +----------+    +-----------+    +------------+    +-----------+ |
|  |          |    |           |    |            |    |           | |
|  |  Nginx   |--->| Workhorse |--->|    Puma    |--->|  Sidekiq  | |
|  | (Proxy)  |    | (Fayllar) |    |  (Asosiy   |    | (Fon      | |
|  |          |    |           |    |   ilova)   |    |  ishlar)  | |
|  +----------+    +-----------+    +------+-----+    +-----------+ |
|                                         |                         |
|                  +----------------------+----+                    |
|                  |                      |    |                    |
|           +------+-----+    +----------+-+  +-------+------+     |
|           |            |    |            |  |              |     |
|           | PostgreSQL |    |   Redis    |  |    Gitaly    |     |
|           |   (DB)     |    |  (Cache)   |  | (Git repos)  |     |
|           |            |    |            |  |              |     |
|           +------------+    +------------+  +--------------+     |
|                                                                   |
+-------------------------------------------------------------------+

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl openssh-server ca-certificates tzdata perl

sudo apt install -y postfix

sudo cat /etc/gitlab/initial_root_password

sudo nano /etc/gitlab/gitlab.rb

# /etc/gitlab/gitlab.rb
 
letsencrypt['auto_renew'] = true
letsencrypt['auto_renew_hour'] = "12"
letsencrypt['auto_renew_minute'] = "30"
letsencrypt['auto_renew_day_of_month'] = "*/7"
letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'

sudo gitlab-ctl reconfigure

sudo nano /etc/gitlab/gitlab.rb

# /etc/gitlab/gitlab.rb — Production tuning
 
# Количество Puma worker'ов — каждый потребляет ~1 ГБ RAM
# Формула: количество ядер CPU + 1, но корректируйте с учётом RAM
# Для сервера с 8 ГБ RAM и 4 CPU:
puma['worker_processes'] = 4
 
# Sidekiq — worker для фоновых задач
# По умолчанию 1, при большом количестве пользователей увеличьте до 2-3
sidekiq['max_concurrency'] = 20
 
# PostgreSQL — shared_buffers рекомендуется устанавливать на 25% от RAM
# Для сервера с 8 ГБ:
postgresql['shared_buffers'] = "2048MB"
 
# Мониторинг — Prometheus и Grafana
# Состояние сервера можно отслеживать через gitlab.helm.uz/-/grafana
prometheus_monitoring['enable'] = true
grafana['enable'] = true
 
# Container Registry — для хранения Docker-образов
# Доступен через gitlab.helm.uz:5050
registry_external_url 'https://gitlab.helm.uz:5050'
 
# Настройки резервного копирования
gitlab_rails['backup_keep_time'] = 604800  # 7 дней (в секундах)

sudo gitlab-ctl reconfigure

+------------------------------------------------------------------+
|                      GITLAB SERVER                                |
|                                                                   |
|   +-------------------+     +-------------------+                 |
|   |    Project A      |     |    Project B      |                 |
|   +--------+----------+     +--------+----------+                 |
|            |                         |                            |
+------------------------------------------------------------------+
             |                         |
    +--------v----------+    +---------v---------+
    |  Shared Runner    |    | Specific Runner   |
    |  (Barcha loyihalar |    | (Faqat bitta      |
    |   uchun umumiy)   |    |  loyiha uchun)    |
    +--------+----------+    +---------+---------+
             |                         |
    +--------v----------+    +---------v---------+
    |   Docker          |    |   Shell            |
    |   Executor        |    |   Executor         |
    +-------------------+    +--------------------+

# Скачиваем бинарный файл
sudo curl -L --output /usr/local/bin/gitlab-runner \
  https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
 
# Даём права на выполнение
sudo chmod +x /usr/local/bin/gitlab-runner
 
# Создаём отдельного пользователя для GitLab Runner
sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
 
# Устанавливаем и запускаем как сервис
sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

gitlab-runner register \
  --url https://gitlab.helm.uz \
  --token glrt-xxxxxxxxxxxxxxxxxxxx

sudo gitlab-runner run

sudo nano /etc/gitlab-runner/config.toml

# /etc/gitlab-runner/config.toml
 
concurrent = 4          # Сколько job'ов может выполняться одновременно
check_interval = 0      # Интервал опроса GitLab для получения новых job'ов (0 = по умолчанию 3 сек)
shutdown_timeout = 0    # Время ожидания перед завершением работы
 
[session_server]
  session_timeout = 1800  # Таймаут для интерактивного веб-терминала (в секундах)
 
[[runners]]
  name = "runner1"
  url = "https://gitlab.helm.uz/"
  token = "glrt-xxxxxxxxxxxxxxxxxxxx"
  executor = "docker"
  [runners.docker]
    tls_verify = false
    image = "ubuntu:latest"        # Docker-образ по умолчанию
    privileged = true              # Необходимо для Docker-in-Docker
    disable_entrypoint_overwrite = false
    oom_kill_disable = false
    disable_cache = false
    volumes = ["/cache"]           # Кеш между job'ами
    shm_size = 0

sudo usermod -aG docker gitlab-runner

sudo gitlab-runner restart

+----------+     +-----------+     +------------+     +----------+
|          |     |           |     |            |     |          |
|   Dev    |---->|   GitLab  |---->|   GitLab   |---->|  Natija  |
| (git push)|    |  (pipeline |    |   Runner   |     | (pass/   |
|          |     |   yaratadi)|    | (job bajara-|    |   fail)  |
+----------+     +-----------+     |    di)     |     +----------+
                      |            +------------+
                      |                  |
                      |   .gitlab-ci.yml |
                      +------------------+

# .gitlab-ci.yml — простой вариант
 
stages:
  - build
 
build:
  stage: build
  image: node:20
  before_script:
    - npm install -g pnpm
  script:
    - pnpm install
    - pnpm next build
  cache:
    key: "$CI_COMMIT_REF_SLUG"
    paths:
      - node_modules/
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
  tags:
    - shared

# .gitlab-ci.yml — production вариант
 
stages:
  - install
  - test
  - build
  - docker
  - deploy
 
variables:
  DOCKER_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA
  DOCKER_IMAGE_LATEST: $CI_REGISTRY_IMAGE:latest
 
# Установка зависимостей — кешируется для последующих этапов
install:
  stage: install
  image: node:20
  script:
    - npm install -g pnpm
    - pnpm install --frozen-lockfile
  cache:
    key: "$CI_COMMIT_REF_SLUG"
    paths:
      - node_modules/
  tags:
    - shared
 
# Запуск тестов
test:
  stage: test
  image: node:20
  script:
    - npm install -g pnpm
    - pnpm test
  cache:
    key: "$CI_COMMIT_REF_SLUG"
    paths:
      - node_modules/
    policy: pull       # Только чтение, без записи (быстрее)
  tags:
    - shared
 
# Сборка проекта
build:
  stage: build
  image: node:20
  script:
    - npm install -g pnpm
    - pnpm build
  artifacts:
    paths:
      - .next/         # Передача результата сборки на следующий этап
    expire_in: 1 hour
  cache:
    key: "$CI_COMMIT_REF_SLUG"
    paths:
      - node_modules/
    policy: pull
  tags:
    - shared
 
# Сборка Docker-образа и push в GitLab Container Registry
docker:
  stage: docker
  image: docker:24
  services:
    - docker:24-dind
  before_script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
  script:
    - docker build -t $DOCKER_IMAGE -t $DOCKER_IMAGE_LATEST .
    - docker push $DOCKER_IMAGE
    - docker push $DOCKER_IMAGE_LATEST
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
  tags:
    - shared
 
# Деплой на сервер (через SSH)
deploy:
  stage: deploy
  image: alpine:latest
  before_script:
    - apk add --no-cache openssh-client
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | ssh-add -
    - mkdir -p ~/.ssh
    - echo "$SSH_KNOWN_HOSTS" >> ~/.ssh/known_hosts
  script:
    - ssh $DEPLOY_USER@$DEPLOY_HOST "
        docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY &&
        docker pull $DOCKER_IMAGE_LATEST &&
        docker compose -f /app/docker-compose.yml up -d
      "
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
  when: manual         # Деплой запускается только при ручном подтверждении
  tags:
    - shared

sudo ufw allow OpenSSH    # SSH (порт 22) — для доступа к серверу через терминал
sudo ufw allow 80/tcp     # HTTP — необходим для получения сертификата Let's Encrypt
sudo ufw allow 443/tcp    # HTTPS — веб-интерфейс GitLab
sudo ufw enable
sudo ufw status

# Создание резервной копии вручную
sudo gitlab-backup create
 
# Файлы резервных копий хранятся здесь:
ls /var/opt/gitlab/backups/
# Результат: 1710100800_2024_03_11_16.9.1_gitlab_backup.tar

sudo crontab -e

# Полное резервное копирование каждый день в 2:00
0 2 * * * /opt/gitlab/bin/gitlab-backup create CRON=1
 
# Отдельное резервное копирование конфигурационных файлов (каждый день в 2:30)
30 2 * * * cp /etc/gitlab/gitlab.rb /var/opt/gitlab/backups/gitlab.rb.$(date +\%F)
30 2 * * * cp /etc/gitlab/gitlab-secrets.json /var/opt/gitlab/backups/gitlab-secrets.json.$(date +\%F)

# Останавливаем сервисы GitLab (база данных и кеш остаются работать)
sudo gitlab-ctl stop puma
sudo gitlab-ctl stop sidekiq
 
# Восстанавливаем из резервной копии (укажите timestamp из имени файла)
sudo gitlab-backup restore BACKUP=1710100800_2024_03_11_16.9.1
 
# Восстанавливаем конфигурационные файлы
sudo cp /backup/gitlab.rb /etc/gitlab/gitlab.rb
sudo cp /backup/gitlab-secrets.json /etc/gitlab/gitlab-secrets.json
 
# Reconfigure и restart
sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

# Отключение git clone/push по паролю — только через SSH-ключ
gitlab_rails['gitlab_shell_ssh_port'] = 22

# Работа через SSH-ключ вместо пароля
git clone git@gitlab.helm.uz:devops/loyiha.git

# Перед обновлением создайте резервную копию!
sudo gitlab-backup create
 
# Обновление
sudo apt update && sudo apt upgrade gitlab-ee -y
sudo gitlab-ctl reconfigure
 
# Проверка
sudo gitlab-ctl status
sudo gitlab-rake gitlab:check SANITIZE=true

# /etc/gitlab/gitlab.rb
 
# Не более 10 запросов в минуту на страницу входа
gitlab_rails['rate_limiting_response_text'] = 'Retry later'

sudo gitlab-ctl tail              # Все логи (в реальном времени)
sudo gitlab-ctl tail puma         # Логи веб-приложения
sudo gitlab-ctl tail nginx        # Логи прокси
sudo gitlab-ctl tail sidekiq      # Логи фоновых задач
sudo gitlab-ctl tail gitaly       # Логи Git-операций
sudo gitlab-ctl tail postgresql   # Логи базы данных

sudo gitlab-rake gitlab:check SANITIZE=true