Admin в 10:39, 15 октября 2025

2025-10-15T10:39:06Z

Admin: Новая страница: «= Настройка системы контроля версий (GitLab) = == 1. Подготовка системы == * Войдите в систему п…»

2025-10-15T08:34:30Z

Новая страница: «= Настройка системы контроля версий (GitLab) = == 1. Подготовка системы == * Войдите в систему п…»

Новая страница

= Настройка системы контроля версий (GitLab) =

== 1. Подготовка системы ==

* Войдите в систему под учетной записью с правами '''root''' или пользователя с правами '''sudo'''.
* Убедитесь, что у вас есть доступ к серверу через SSH или консоль.

== 2. Установка зависимостей ===

=== Обновление системы ===

1. Обновите систему:
<code>sudo apt update</code>

2. Установите необходимые пакеты:
<code>sudo apt install -y curl wget ca-certificates gnupg lsb-release</code>

=== Установка Docker ===

1. Установите Docker:
<code>curl -fsSL https://get.docker.com -o get-docker.sh</code>
<code>sudo sh get-docker.sh</code>

2. Добавьте пользователя в группу docker:
<code>sudo usermod -aG docker $USER</code>

3. Запустите и включите Docker:
<code>sudo systemctl start docker</code>
<code>sudo systemctl enable docker</code>

4. Проверьте установку:
<code>docker --version</code>

=== Установка Docker Compose ===

1. Скачайте Docker Compose:
<code>sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose</code>

2. Установите права:
<code>sudo chmod +x /usr/local/bin/docker-compose</code>

3. Проверьте установку:
<code>docker-compose --version</code>

== 3. Установка GitLab ===

=== Создание директорий ===

1. Создайте директорию для GitLab:
<code>sudo mkdir -p /srv/gitlab</code>

2. Создайте поддиректории:
<code>sudo mkdir -p /srv/gitlab/config</code>
<code>sudo mkdir -p /srv/gitlab/logs</code>
<code>sudo mkdir -p /srv/gitlab/data</code>

3. Установите права доступа:
<code>sudo chown -R 1000:1000 /srv/gitlab</code>

=== Создание Docker Compose файла ===

1. Создайте docker-compose.yml:
<code>sudo nano /srv/gitlab/docker-compose.yml</code>

2. Добавьте конфигурацию:
<code>version: '3.8'

services:
gitlab:
image: gitlab/gitlab-ce:latest
container_name: gitlab
restart: always
hostname: 'gitlab.example.com'
environment:
GITLAB_OMNIBUS_CONFIG: |
external_url 'https://gitlab.example.com'
gitlab_rails['gitlab_shell_ssh_port'] = 2224
nginx['listen_port'] = 80
nginx['listen_https'] = false
nginx['proxy_set_headers'] = {
"X-Forwarded-Proto" => "https",
"X-Forwarded-Ssl" => "on"
}
ports:
- '80:80'
- '443:443'
- '2224:22'
volumes:
- '/srv/gitlab/config:/etc/gitlab'
- '/srv/gitlab/logs:/var/log/gitlab'
- '/srv/gitlab/data:/var/opt/gitlab'
shm_size: '256m'
</code>

=== Запуск GitLab ===

1. Перейдите в директорию GitLab:
<code>cd /srv/gitlab</code>

2. Запустите GitLab:
<code>sudo docker-compose up -d</code>

3. Проверьте статус:
<code>sudo docker-compose ps</code>

4. Просмотр логов:
<code>sudo docker-compose logs -f gitlab</code>

== 4. Первоначальная настройка ===

=== Ожидание запуска ===

1. GitLab может занять несколько минут для полного запуска
2. Проверьте статус:
<code>sudo docker-compose logs gitlab | grep "Puma starting"</code>

3. Дождитесь сообщения о готовности

=== Получение пароля root ===

1. Получите пароль root:
<code>sudo docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password</code>

2. Сохраните пароль в безопасном месте

=== Первый вход ===

1. Откройте браузер и перейдите по адресу:
<code>http://your-server-ip</code>

2. Войдите с учетными данными:
* Username: root
* Password: [пароль из предыдущего шага]

3. Смените пароль root в настройках

== 5. Настройка SSL ===

=== Установка Certbot ===

1. Установите Certbot:
<code>sudo apt install -y certbot</code>

2. Получите SSL сертификат:
<code>sudo certbot certonly --standalone -d gitlab.example.com</code>

=== Настройка SSL в GitLab ===

1. Отредактируйте конфигурацию GitLab:
<code>sudo nano /srv/gitlab/config/gitlab.rb</code>

2. Добавьте SSL настройки:
<code>external_url 'https://gitlab.example.com'
nginx['redirect_http_to_https'] = true
nginx['ssl_certificate'] = "/etc/letsencrypt/live/gitlab.example.com/fullchain.pem"
nginx['ssl_certificate_key'] = "/etc/letsencrypt/live/gitlab.example.com/privkey.pem"
</code>

3. Перезапустите GitLab:
<code>sudo docker-compose restart</code>

== 6. Настройка резервного копирования ===

=== Создание скрипта резервного копирования ===

1. Создайте скрипт резервного копирования:
<code>sudo nano /usr/local/bin/gitlab-backup.sh</code>

2. Добавьте содержимое:
<code>#!/bin/bash

BACKUP_DIR="/backup/gitlab"
DATE=$(date +%Y%m%d_%H%M%S)

# Создание директории для бэкапа
mkdir -p $BACKUP_DIR

# Создание резервной копии GitLab
sudo docker exec gitlab gitlab-backup create

# Копирование резервной копии
sudo cp /srv/gitlab/data/backups/* $BACKUP_DIR/

# Сжатие архива
tar -czf $BACKUP_DIR/gitlab-backup-$DATE.tar.gz -C $BACKUP_DIR .

# Удаление несжатых файлов
rm -f $BACKUP_DIR/*.tar

# Удаление старых бэкапов (старше 7 дней)
find $BACKUP_DIR -name "gitlab-backup-*.tar.gz" -mtime +7 -delete

echo "GitLab backup completed: $DATE"
</code>

3. Сделайте скрипт исполняемым:
<code>sudo chmod +x /usr/local/bin/gitlab-backup.sh</code>

=== Настройка автоматического резервного копирования ===

1. Добавьте задачу в crontab:
<code>sudo crontab -e</code>

2. Добавьте строку:
<code>0 2 * * * /usr/local/bin/gitlab-backup.sh</code>

== 7. Настройка пользователей и групп ===

=== Создание пользователей ===

1. В веб-интерфейсе GitLab:
* Перейдите в Admin Area → Users
* Нажмите "New User"
* Заполните данные пользователя

2. Настройте права доступа:
* Выберите уровень доступа
* Настройте уведомления
* Активируйте пользователя

=== Создание групп ===

1. Создайте группу:
* Перейдите в Groups → New Group
* Заполните название и описание
* Настройте видимость группы

2. Добавьте участников:
* Перейдите в Members
* Добавьте пользователей
* Настройте роли участников

== 8. Настройка проектов ===

=== Создание проекта ===

1. Создайте новый проект:
* Нажмите "New Project"
* Выберите тип проекта
* Заполните данные проекта

2. Настройте репозиторий:
* Выберите видимость репозитория
* Настройте инициализацию
* Добавьте README файл

=== Настройка CI/CD ===

1. Создайте .gitlab-ci.yml файл:
<code>nano .gitlab-ci.yml</code>

2. Добавьте базовую конфигурацию:
<code>stages:
- build
- test
- deploy

build:
stage: build
script:
- echo "Building application"
- make build

test:
stage: test
script:
- echo "Running tests"
- make test

deploy:
stage: deploy
script:
- echo "Deploying application"
- make deploy
only:
- master
</code>

== 9. Настройка интеграций ===

=== Настройка уведомлений ===

1. Настройте email уведомления:
* Перейдите в Admin Area → Settings → General
* Настройте SMTP сервер
* Протестируйте отправку

2. Настройте webhook:
* Перейдите в Project Settings → Integrations
* Добавьте URL webhook
* Настройте события

=== Настройка LDAP ===

1. В Admin Area → Settings → General:
<code>ldap:
enabled: true
servers:
main:
label: 'LDAP'
host: 'ldap.example.com'
port: 389
uid: 'sAMAccountName'
bind_dn: 'CN=GitLab,OU=Service Accounts,DC=example,DC=com'
password: 'password'
encryption: 'plain'
active_directory: true
allow_username_or_email_login: true
block_auto_created_users: false
base: 'OU=Users,DC=example,DC=com'
user_filter: ''
</code>

== 10. Мониторинг и обслуживание ===

=== Мониторинг производительности ===

1. Просмотр статистики:
* Перейдите в Admin Area → Monitoring
* Просмотрите метрики системы
* Настройте алерты

2. Настройка логирования:
* Перейдите в Admin Area → Settings → General
* Настройте уровень логирования
* Настройте ротацию логов

=== Обновление GitLab ===

1. Остановите GitLab:
<code>sudo docker-compose down</code>

2. Обновите образ:
<code>sudo docker-compose pull</code>

3. Запустите GitLab:
<code>sudo docker-compose up -d</code>

4. Проверьте статус:
<code>sudo docker-compose ps</code>

== 11. Настройка файрвола ===

=== Настройка UFW ===

1. Разрешите необходимые порты:
<code>sudo ufw allow 80/tcp</code>
<code>sudo ufw allow 443/tcp</code>
<code>sudo ufw allow 2224/tcp</code>

2. Проверьте статус:
<code>sudo ufw status</code>

=== Настройка iptables ===

1. Разрешите порты через iptables:
<code>sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT</code>
<code>sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT</code>
<code>sudo iptables -A INPUT -p tcp --dport 2224 -j ACCEPT</code>

2. Сохраните правила:
<code>sudo iptables-save > /etc/iptables/rules.v4</code>

== 12. Устранение неполадок ===

=== Частые проблемы ===

1. '''GitLab не запускается''':
* Проверьте логи: <code>sudo docker-compose logs gitlab</code>
* Проверьте доступное место на диске
* Проверьте права доступа к директориям

2. '''Проблемы с подключением''':
* Проверьте файрвол
* Проверьте DNS настройки
* Проверьте SSL сертификаты

3. '''Проблемы с производительностью''':
* Увеличьте ресурсы контейнера
* Оптимизируйте настройки GitLab
* Проверьте использование диска

=== Диагностика ===

1. '''Проверка статуса контейнера''':
<code>sudo docker-compose ps</code>

2. '''Проверка логов''':
<code>sudo docker-compose logs gitlab</code>

3. '''Проверка использования ресурсов''':
<code>sudo docker stats gitlab</code>

4. '''Проверка подключения''':
<code>curl -I http://your-server-ip</code>

== Заключение ==

GitLab успешно установлен и настроен! Теперь у вас есть полнофункциональная система контроля версий с возможностями CI/CD, управления проектами и командной работы.

'''Для размещения ваших GitLab серверов на надежном хостинге рекомендуем воспользоваться услугами [ARK-HOSTER.RU](https://ark-hoster.ru):'''

* '''[Выделенные серверы](https://ark-hoster.ru/dedicated/)''' - для высоконагруженных GitLab серверов
* '''[VPS/VDS серверы](https://ark-hoster.ru/vpsgame/)''' - для небольших и средних команд

Наши специалисты помогут с настройкой GitLab и оптимизацией производительности ваших систем контроля версий!

Настройка системы контроля версий GitLab - История изменений

Admin в 10:39, 15 октября 2025

Admin: Новая страница: «= Настройка системы контроля версий (GitLab) = == 1. Подготовка системы == * Войдите в систему п…»