======Установка GitLab в Ubuntu 22.04======

=====Введение=====

[[https://gitlab.com/gitlab-org/gitlab|GitLab]] — это приложение с открытым исходным кодом, которое в основном используется для размещения репозиториев Git, с дополнительными функциями, связанными с разработкой, такими как отслеживание проблем. Он предназначен для размещения с использованием вашей собственной инфраструктуры и обеспечивает гибкость при развертывании в качестве внутреннего хранилища репозитория для вашей команды разработчиков, общедоступного способа взаимодействия с пользователями или средства для участников для размещения своих собственных проектов.

Проект GitLab позволяет вам создать экземпляр GitLab на вашем собственном оборудовании с минимальным механизмом установки. Это руководство научит вас, как установить и настроить GitLab Community Edition на сервере Ubuntu.

=====Предварительные условия=====

Если вы используете Ubuntu версии 16.04 или ниже, мы рекомендуем вам обновиться до более последней версии, поскольку Ubuntu больше не поддерживает эти версии. Этот [[http://example.com|сборник руководств]] поможет вам обновить версию Ubuntu.

Чтобы следовать этому руководству, вам понадобится:

Сервер под управлением Ubuntu вместе с пользователем без полномочий **root** с **sudo** привилегиями и активным брандмауэром. Для получения инструкций по их настройке выберите свой дистрибутив из этого списка и следуйте нашему [[http://example.com|Руководству по первоначальной настройке сервера.]]

Опубликованные [[https://docs.gitlab.com/ee/install/requirements.html#hardware-requirements|требования к оборудованию GitLab]] рекомендуют использовать сервер как минимум с:

  * 4 ядра для вашего процессора
  * 4 ГБ ОЗУ для памяти

Хотя вы можете обойтись заменой оперативной памяти некоторым пространством подкачки, это не рекомендуется. Следующие примеры в этом руководстве будут использовать эти минимальные ресурсы.

Доменное имя, указывающее на ваш сервер. Для получения дополнительной информации прочтите нашу документацию о том, как [[https://docs.digitalocean.com/products/networking/dns/getting-started/quickstart/|начать работу с DNS в DigitalOcean]]. В этом руководстве мы будем использовать его **your_domain** в качестве примера, но обязательно замените его своим доменным именем.

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

Перед установкой GitLab важно установить программное обеспечение, которое он использует во время установки и на постоянной основе. Необходимое программное обеспечение можно установить из репозиториев пакетов Ubuntu по умолчанию.

Сначала обновите индекс локального пакета:

<code>
sudo apt update
</code>

Затем установите зависимости, введя эту команду:

<code>
sudo apt install ca-certificates curl openssh-server postfix tzdata perl
</code>

Вероятно, часть этого программного обеспечения у вас уже установлена. Для postfix установки выберите Интернет-сайт при появлении запроса. На следующем экране введите доменное имя вашего сервера, чтобы настроить способ отправки почты системой.

Теперь, когда у вас установлены зависимости, вы готовы установить GitLab.

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

Имея зависимости, вы можете установить GitLab. В этом процессе используется сценарий установки для настройки вашей системы с помощью репозиториев GitLab.

Сначала перейдите в **/tmp** каталог:

<code>
cd /tmp
</code>

Затем скачайте скрипт установки:

<code>
curl -LO https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh
</code>

Не стесняйтесь изучить загруженный скрипт, чтобы убедиться, что вам понятны действия, которые он будет выполнять. Вы также можете найти размещенную версию скрипта в инструкции по установке GitLab :

<code>
less /tmp/script.deb.sh
</code>

Как только вы будете удовлетворены безопасностью скрипта, запустите установщик:

<code>
sudo bash /tmp/script.deb.sh
</code>

Скрипт настраивает ваш сервер для использования репозиториев, поддерживаемых GitLab. Это позволяет вам управлять GitLab с помощью тех же инструментов управления пакетами, которые вы используете для других системных пакетов. После завершения вы можете установить фактическое приложение GitLab с помощью **apt**:

<code>
sudo apt install gitlab-ce
</code>

Это приведет к установке необходимых компонентов в вашу систему и может занять некоторое время.

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

Прежде чем настраивать GitLab, вам необходимо убедиться, что правила вашего брандмауэра достаточно разрешающие, чтобы разрешать веб-трафик. Если вы следовали руководству, указанному в предварительных условиях, у вас уже **ufw** включен брандмауэр.

Просмотрите текущий статус вашего активного брандмауэра, выполнив:

<code>
sudo ufw status
</code>



Текущие правила разрешают трафик SSH, но доступ к другим сервисам ограничен. Поскольку GitLab — это веб-приложение, вам необходимо разрешить доступ по HTTP. Поскольку вы воспользуетесь возможностью GitLab запрашивать и включать бесплатный сертификат TLS/SSL от [[https://letsencrypt.org/|Let's Encrypt]], также разрешите доступ по HTTPS.

Протокол сопоставления портов для HTTP и HTTPS доступен в **/etc/service** sфайле, поэтому вы можете разрешить этот трафик по имени. Если у вас еще не включен трафик OpenSSH, вам следует разрешить этот трафик:

<code>
sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH
</code>

Вы можете проверить **ufw status** еще раз, чтобы убедиться, что вы предоставили доступ как минимум к этим двум службам:

<code>
sudo ufw status
</code>

Этот вывод указывает на то, что веб-интерфейс GitLab теперь доступен после настройки приложения.

См. [[software:linux_server:ubuntu_server_setting_Firewall_UFW|Hастройка брандмауэра с помощью UFW Ubuntu Server]]

=====Редактирование файла конфигурации GitLab=====

Прежде чем вы сможете использовать приложение, обновите файл конфигурации и запустите команду реконфигурации. Сначала откройте файл конфигурации GitLab в предпочитаемом вами текстовом редакторе. В этом примере используется **nano:**

<code>
sudo nano /etc/gitlab/gitlab.rb
</code>

Найдите **external_url** строку конфигурации. Обновите его, чтобы он соответствовал вашему домену:

<file code ip.exsample>
Примеры external_url 'http(s)://your_domain':
external_url 'http://192.168.1.145'
external_url 'https://book51.ru'
external_url 'http://192.168.1.145:7575'
</file>

{{:software:linux_server:gitlab_install_linux_1.png?|}}

Если external_url указывается с номером порта отличным от 80, 443, при включенном брандмауэре, то необходимо прописать в настройках брандмауэра этот порт:

<code>
sudo ufw allow 7575/tcp
</code>

{{:software:linux_server:ufw_26.png?|}}

Запустите следующую команду, чтобы перенастроить GitLab:

<code>
sudo gitlab-ctl reconfigure
</code>

Это инициализирует GitLab, используя информацию, которую он сможет найти о вашем сервере. Это полностью автоматизированный процесс, поэтому вам не придется отвечать ни на какие подсказки.

Проверьте установку с помощью следующей команды:

<code>
sudo gitlab-rake gitlab:env:info
</code>

{{:software:linux_server:gitlab_install_linux_7.png?|}}

=====Первоначальные настройки через веб-интерфейс=====

При запущенном GitLab вы можете выполнить первоначальную настройку приложения через веб-интерфейс.

====Вход в систему в первый раз====

Посетите доменное, указанное вами в external_url, имя вашего сервера GitLab в веб-браузере:

Посетите доменное имя вашего сервера GitLab в веб-браузере:

<code>
http://192.168.1.145:7575
</code>

При первом посещении вас встретит страница входа:

{{:software:linux_server:gitlab_install_linux_2.png?|}}

GitLab генерирует для вас первоначальный безопасный пароль. Он хранится в папке, к которой вы можете получить доступ как администратор **sudo:**

<code>
sudo nano /etc/gitlab/initial_root_password
</code>

{{:software:linux_server:gitlab_install_linux_3.png?|}}

Вернувшись на страницу входа, введите следующее:

  * Имя пользователя: root
  * Пароль: [пароль указан на /etc/gitlab/initial_root_password]

Введите эти значения в поля и нажмите кнопку «Войти» . Вы войдете в приложение и попадете на целевую страницу, на которой вам будет предложено начать добавлять проекты:

{{:software:linux_server:gitlab_install_linux_4.png?|}}

Теперь вы можете точно настроить свой экземпляр GitLab.

====Обновление вашего пароля====

Первое, что вам следует сделать после входа в систему, — это сменить пароль. Чтобы внести это изменение, нажмите значок в правом верхнем углу панели навигации и выберите **«Редактировать профиль»:**

Затем вы попадете на страницу настроек пользователя. На левой панели навигации выберите «Пароль» , чтобы изменить пароль, сгенерированный GitLab, на безопасный пароль, а затем нажмите кнопку «Сохранить пароль» , когда закончите вносить обновления:

{{:software:linux_server:gitlab_install_linux_5.png?|}}

Вы вернетесь на экран входа в систему с уведомлением о том, что ваш пароль был изменен. Введите новый пароль, чтобы снова войти в свой экземпляр GitLab:

{{:software:linux_server:gitlab_install_linux_6.png?|}}

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

Теперь у вас есть работающий экземпляр GitLab, размещенный на вашем собственном сервере. Вы можете начать импортировать или создавать новые проекты и настраивать соответствующий уровень доступа для команды. GitLab регулярно добавляет функции и обновляет свою платформу, поэтому обязательно посещайте домашнюю страницу проекта, чтобы быть в курсе любых улучшений или важных уведомлений.

=====Ссылки и Дополнения=====

  * [[https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-gitlab-on-ubuntu|оригинальная статья]]
  * [[https://docs.digitalocean.com/products/networking/dns/getting-started/quickstart/|Краткое руководство по DNS]]
  * [[https://www.digitalocean.com/community/tutorials/how-to-setup-a-firewall-with-ufw-on-an-ubuntu-and-debian-cloud-server|Как настроить брандмауэр с помощью UFW]]
  * [[software:linux_server:ubuntu_server_setting_Firewall_UFW|Hастройка брандмауэра с помощью UFW Ubuntu Server]]
  * {{ :software:linux_server:gitlab-gitlab-ce_latest_.syno.tar |gitlab-ce_latest_.syno.tar 2.9GB }}
  * {{ :software:linux_server:gitlab-gitlab-ee_latest_.syno.tar |gitlab-ee_latest_.syno.tar 3.2GB }}