Обзор развертывания GitLab на сервере¶

Предварительные требования¶

Для успешной установки и работы приложения требуются следующие условия:

Операционная система: Ubuntu, Debian (deb-like дистрибутивы) или CentOS, Rocky Linux, AlmaLinux (rpm-like дистрибутивы).
Права доступа: Права суперпользователя (root) для установки пакетов и изменения системных конфигураций.
Сетевые требования: Доступ к репозиториям GitLab через интернет.

FDQN итоговой панели на домене hostkey.in¶

Доменное имя формируется автоматически на основе идентификатора сервера в системе управления.

Параметр	Значение
Префикс	`gl`
Домен	`hostkey.in`
Полный шаблон	`gl{Server_ID_from_Invapi}.hostkey.in`

Процесс установки приложения¶

Установка выполняется путем добавления официального репозитория GitLab CE и последующей компиляции/установки пакетов через системные менеджеры пакетов (apt или yum). После установки производится автоматическая конфигурация сервиса с применением параметров из файла gitlab.rb.

Права доступа и безопасность¶

В процессе развертывания выполняются следующие действия по обеспечению безопасности:

Брандмауэр: На дистрибутивах семейства Red Hat (CentOS, Rocky, AlmaLinux) служба firewalld останавливается и отключается.
Ключи репозиториев: Для Debian/Ubuntu используется современный метод добавления ключей в директорию /etc/apt/keyrings/.
Пароль администратора: Начальный пароль пользователя root для веб-интерфейса GitLab устанавливается автоматически (значение берется из переменных окружения установки).

Контейнеры Docker и их запуск¶

Приложение развертывается непосредственно в операционной системе как нативный сервис. Использование контейнеров Docker не предусмотрено.

Инструкция по обновлению приложения¶

Обновление выполняется через обновление системных пакетов:

Для Debian/Ubuntu: apt update && apt upgrade gitlab-ce
Для RHEL-подобных систем: yum update gitlab-ce

После обновления необходимо выполнить переконфигурацию сервиса командой: gitlab-ctl reconfigure

Расположение конфигурационных файлов и данных¶

Основные файлы управления и настройки расположены по следующим путям:

/etc/gitlab/gitlab.rb — основной файл конфигурации GitLab.
/etc/apt/keyrings/gitlab-ce.gpg — ключ репозитория (для Debian/Ubuntu).
/etc/apt/sources.list.d/gitlab_gitlab-ce.list — файл списка репозиториев (для Debian/Ubuntu).

Доступные порты для подключения¶

Приложение использует протокол HTTPS для доступа через веб-интерфейс по доменному имени, сформированному в разделе FDQN. Стандартный порт: 443.