Site icon OS CONFIG

Запуск git сервера на CentOS Stream 8

Краткое руководство по быстрому развёртыванию собственного git сервера с веб-интерфейсом в связке git + Apache HTTP Server + gitweb на ОС CentOS Stream 8.

Перед тем, как начинать разворачивать сервер, необходимо убедиться в наличии полных имён хостов в файле /etc/hosts

# vi /etc/hosts

После строки

127.0.0.1 localhost

дописать такую:

127.0.1.1 cvm35.homenet.local cvm35

Также отключим SELinux. Открываем файл /etc/selinux/config

# vi /etc/selinux/config

и изменим значение SELINUX на

SELINUX=disabled

Теперь установим пакеты git, httpd и httpd-tools

# yum install git httpd httpd-tools

В файрволле откроем сервис http

# firewall-cmd --add-service=http --zone=public --permanent
# firewall-cmd --reload

Запустим службу httpd и включим её в автозагрузку

# systemctl start httpd
# systemctl enable httpd

Теперь отключим страницу по умолчанию в Apache. Для этого в директории /etc/httpd/conf.d/ переименуем файл welcome.conf в welcome.conf.bak

# cd /etc/httpd/conf.d/
# mv welcome.conf welcome.conf.bak

Затем создадим каталог /var/lib/git/, в котором будут храниться проекты

# mkdir /var/lib/git/

Далее создадим каталог /etc/httpd/gitusers/ для хранения логинов и паролей пользователей git

# mkdir /etc/httpd/gitusers/

После этого создадим файл конфигурации apache для git

# touch /etc/httpd/conf.d/git.conf

откроем его

# vi /etc/httpd/conf.d/git.conf

и внесём такие строки:

SetEnv GIT_PROJECT_ROOT /var/lib/git
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias /git/ /usr/libexec/git-core/git-http-backend/

<Location /git>
    Options ExecCGI
    AuthName "Login to Git"
    AuthType Basic
    AuthUserFile /etc/httpd/gitusers/.htpasswd
    Require valid-user
</Location>

Теперь создадим пользователя gituser

# htpasswd -c /etc/httpd/gitusers/.htpasswd gituser

и перезапустим apache

# systemctl restart httpd

Затем создадим репозиторий gitproject.git и инициализируем его

# mkdir /var/lib/git/gitproject.git/
# cd /var/lib/git/gitproject.git/
# git init --bare --shared

В консоли должно появиться такое сообщение:

подсказка: Using 'master' as the name for the initial branch. This default branch name
подсказка: is subject to change. To configure the initial branch name to use in all
подсказка: of your new repositories, which will suppress this warning, call:
подсказка:
подсказка:      git config --global init.defaultBranch <name>
подсказка:
подсказка: Names commonly chosen instead of 'master' are 'main', 'trunk' and
подсказка: 'development'. The just-created branch can be renamed via this command:
подсказка:
подсказка:      git branch -m <name>
Инициализирован пустой общий репозиторий Git в /var/lib/git/gitproject.git/

Далее дадим права группе apache для этого репозитория

# chgrp -R apache /var/lib/git/gitproject.git/

После этого создадим проект в директории /var/lib/git/gitproject.git/ и инициализируем его

# mkdir project/
# cd project/
# git init

В консоли должно появиться такое сообщение:

подсказка: Using 'master' as the name for the initial branch. This default branch name
подсказка: is subject to change. To configure the initial branch name to use in all
подсказка: of your new repositories, which will suppress this warning, call:
подсказка:
подсказка:      git config --global init.defaultBranch <name>
подсказка:
подсказка: Names commonly chosen instead of 'master' are 'main', 'trunk' and
подсказка: 'development'. The just-created branch can be renamed via this command:
подсказка:
подсказка:      git branch -m <name>
Инициализирован пустой репозиторий Git в /var/lib/git/gitproject.git/project/.git/

Теперь в директории /var/lib/git/gitproject.git/hooks/ скопируем (или переименуем) файл post-update.sample в post-update

# cp /var/lib/git/gitproject.git/hooks/post-update.sample /var/lib/git/gitproject.git/hooks/post-update

Затем настраиваем пользователя gituser

# git config --global user.email "gituser@homenet.local"
# git config --global user.name "gituser"

После этого создадим новую запись для нового подключения к репозиторию

# git remote add origin http://gituser@cvm35.homenet.local/git/gitproject.git

Также создадим некоторые данные, например, директорию text с файлом example.txt

# mkdir text/
# touch text/example.txt
# vi text/example.txt

запишем какой-нибудь текст в этот файл:

Welcome to Git Server

Добавим содержимое рабочего каталога в индекс

# git add .

Сохраним изменения в рабочем каталоге

# git commit -a -m "Test Commit"

В консоли должен отобразиться такой текст:

[master (корневой коммит) 168c071] Test Commit
 1 file changed, 1 insertion(+)
 create mode 100644 text/example.txt

Выгружаем содержимое локального репозитория в удалённый

# git push origin master

появится запрос пароля, который необходимо будет ввести:

Password for 'http://gituser@cvm35.homenet.local':

В консоли должны отобразиться данные о выгрузке:

Перечисление объектов: 4, готово.
Подсчет объектов: 100% (4/4), готово.
Запись объектов: 100% (4/4), 276 байтов | 276.00 КиБ/с, готово.
Всего 4 (изменений 0), повторно использовано 0 (изменений 0), повторно использовано пакетов 0
To http://cvm35.homenet.local/git/gitproject.git
 * [new branch]      master -> master

Обновляем данные

# git update-server-info

Далее переходим к клиенту.

Склонируем удалённый репозиторий

# git clone http://gituser@cvm35.homenet.local/git/gitproject.git

В консоли появится сообщение:

Cloning into 'gitproject'...
remote: Enumerating objects: 4, done.
remote: Counting objects: 100% (4/4), done.
remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (4/4), 256 bytes | 0 bytes/s, done.

Затем перейдём в каталог gitproject/

# cd gitproject/

откроем файл text/example.txt

# nano text/example.txt

и внесём в него какой-нибудь текст:

Thank you very much!

Также в директории text создадим файл newfile.txt и откроем его

# touch text/newfile.txt
# nano text/newfile.txt

и в нём тоже напишем что-нибудь:

Good job!

Теперь добавим содержимое в индекс

# git add .

сохраним изменения

# git commit -a -m "Commit from client"

консоль покажет нам такое сообщение:

 [master ec6ea0d] Commit from client
 2 files changed, 5 insertions(+)
 create mode 100644 text/newfile.txt

и отправим на сервер в удалённый репозиторий

# git push

в консоли отобразится такое сообщение:

Enumerating objects: 8, done.
Counting objects: 100% (8/8), done.
Delta compression using up to 2 threads
Compressing objects: 100% (2/2), done.
Writing objects: 100% (5/5), 380 bytes | 63.00 KiB/s, done.
Total 5 (delta 0), reused 0 (delta 0), pack-reused 0
To http://cvm35.homenet.local/git/gitproject.git
   168c071..ec6ea0d  master -> master

Это значит, что наш git-сервер настроен и готов к использованию.

После этого установим веб-интерфейс gitweb

# yum install gitweb

Откроем файл конфигурации /etc/gitweb.conf

# vi /etc/gitweb.conf

после строки

# our $projectroot = "/var/lib/git";

пропишем

$projectroot = "/var/lib/git";

Проверим наличие конфигурационного файла apache /etc/httpd/conf.d/gitweb.conf

если нет, то создаём

# touch /etc/httpd/conf.d/gitweb.conf
# vi /etc/httpd/conf.d/gitweb.conf

и внесём в него такое содержимое:

Alias /gitweb /var/www/git

<Directory /var/www/git>
  Options +ExecCGI
  AddHandler cgi-script .cgi
  DirectoryIndex gitweb.cgi
</Directory>

Перезапускаем службу httpd

# systemctl restart httpd

Если ошибок нет, то веб-интерфейс настроен.

На другой машине в сети в строке браузера вводим адрес http://cvm35.homenet.local/gitweb/ и мы должны будем увидеть список созданных проектов:

Здесь он пока один.

Кликнув на проект можно увидеть историю его коммитов

Exit mobile version