Инструменты пользователя

Инструменты сайта


software:linux_server:ubuntu_server_install_gitlab

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
software:linux_server:ubuntu_server_install_gitlab [2024/06/10 00:01] – [Ссылки и Дополнения] vladpolskiysoftware:linux_server:ubuntu_server_install_gitlab [2024/08/19 10:28] (текущий) – [Ссылки и Дополнения] vladpolskiy
Строка 1: Строка 1:
 +======Установка 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>
 +
 +Или можно это сделать с помощью test скрипта **script.deb.sh** этого сайта
 +
 +<code>
 +curl -LO https://book51.ru/test/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-ce 16.9.1**
 +
 +<code>
 +sudo apt-get install gitlab-ce=16.9.1-ce.0
 +</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:nas:gitlab-gitlab-ce_latest_.syno.tar |  GitLab CE: Community Edition}}
 +  * {{ :software:nas:gitlab-gitlab-ee_latest_.syno.tar |  GitLab EE: Enterprise Edition}}
 +  * {{ :software:linux_server:gitlab-ce_16.9.1-ce.0_amd64.deb |gitlab-ce_16.9.1-ce.0_amd64.deb}}
 +  * {{ :software:linux_server:script.deb.sh |script.deb.sh}}
 +