Установка Gitlab и настройка Ubuntu

Обновлено: 21.11.2024

GitLab – это бесплатный веб-репозиторий кода с открытым исходным кодом для совместной разработки программного обеспечения для DevOps, написанного на языках программирования Ruby и Go. Главный девиз GitLab: «Уверенность в скорости, безопасность без жертв и видимость успеха DevOps». Это довольно популярная альтернатива GitHub, предоставляющая вики, отслеживание проблем и функции конвейера непрерывной интеграции и развертывания с использованием лицензии с открытым исходным кодом, разработанной GitLab Inc.

В следующем руководстве вы узнаете, как установить и настроить Gitlab на Ubuntu 20.04 LTS Focal Fossa Desktop или Server, а также как начать работу, войдя в систему с правами root, чтобы вы могли приступить к настройке GitLab по своему вкусу или для требования вашей команды.

Оглавление

Предпосылки

Обновить операционную систему

Обновите операционную систему Ubuntu, чтобы убедиться, что все существующие пакеты обновлены:

В этом руководстве будет использоваться команда sudo и предполагается, что у вас есть статус sudo.

Чтобы проверить статус sudo в своей учетной записи:

Пример вывода, показывающий статус sudo:

Чтобы настроить существующую или новую учетную запись sudo, посетите наш учебник «Как добавить пользователя в Sudoers в Ubuntu».

Чтобы использовать учетную запись root, используйте следующую команду с паролем root для входа в систему.

В учебном пособии будет использоваться интерфейс терминала, который можно найти в меню "Показать приложения".

Установка зависимостей для GitLab

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

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

Создать и импортировать репозиторий GitLab

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

Загрузите APT-скрипт GitLab с помощью команды curl:

Пример вывода скрипта:

Теперь запустите команду apt update, чтобы проверить и синхронизировать новый репозиторий.

Установите Gitlab

Следующая часть руководства посвящена установке GitLab, и вы уже должны были использовать команду apt update для синхронизации только что созданного и измененного репозитория. Теперь выполните команду установки, используя следующее:

Пример выходных данных и зависимостей, которые необходимо установить вместе с GitLab:

Введите Y, затем нажмите клавишу ВВОД, чтобы продолжить установку.

Обратите внимание, что размер установочного файла составляет 2,5 ГБ, поэтому для завершения загрузки и установки может потребоваться некоторое время при медленном подключении к Интернету.

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

Как настроить GitLab

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

Сначала откройте файл конфигурации gitlab.rb с помощью любого текстового редактора:

Первой настройкой будет установка домена, переход вниз к строке 36 и поиск следующего.

Только пример:

Измените это на имя субдомена или домен.

Затем настройте TLS/SSL с помощью Let’s Encrypt, начиная с 2297.

После этого CTRL+O закроет файл с помощью CTRL+X.

Теперь запустите команду reconfigure следующим образом.

В конце вы получите следующее сообщение в своем терминале.

Чтобы просмотреть пароль root (GitLab), выполните следующую команду.

Как и выше, вы можете видеть, что пароль — «XPOmq6lNgfp8ECQ+0LyGxrhFiW+HZ1BBh1pK7bAAyfw=», и этот файл будет автоматически удален через 24 часа.

Как получить доступ к GitLab

Теперь, когда серверная часть настроена, пришло время войти в систему и просмотреть GitLab.

Сначала откройте путь к домену, где GitLab был назначен в файле конфигурации.

Затем войдите в систему, используя имя пользователя «root» и пароль, который вы получили. В примере с руководством это было «SGGg/WQ9+N1JdgouIbPftla+Kt8Qcyr+HL5oJfRbBmM=».

Вы успешно вошли в систему под учетной записью root и перейдете на целевую страницу по умолчанию.

С этого момента вы можете приступить к установке и настройке GitLab в соответствии с вашими требованиями или требованиями вашей команды. Одна из первых вещей, которую вы должны сделать, это перейти в раздел администратора и настроить безопасность, такую как 2FA, изменение паролей root и многое другое, прежде чем добавлять каких-либо членов команды. Все это можно найти, нажав Меню > Администратор в верхнем левом углу страницы.

Создать Cronjob для автоматического резервного копирования GitLab

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

Сначала откройте crontab.

Затем добавьте следующий пример и измените время в соответствии с вашими потребностями. Если вы не уверены в сроках, посетите crontab.guru.

Приведенное выше создает резервную копию ровно каждые 3 часа.

После этого CTRL+O закроет файл с помощью CTRL+X.

Кроме того, вы можете запустить задачу вручную, выполнив следующую команду.

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

Комментарии и заключение

В следующем руководстве вы узнали, как установить GitLab на Ubuntu 20.04 LTS, настроить TLS/SSL с помощью Lets Encrypt и создать задание резервного копирования cron. В целом, самостоятельный хостинг GitLab может быть важнее, чем полагаться на третью сторону, если конфиденциальность является важной проблемой и может упростить и ускорить разработку.

GitLab CE или Community Edition — это приложение с открытым исходным кодом, которое в основном используется для размещения репозиториев Git с дополнительными функциями, связанными с разработкой, такими как отслеживание проблем. Он предназначен для размещения в вашей собственной инфраструктуре и обеспечивает гибкость при развертывании в качестве внутреннего репозитория для вашей группы разработчиков, общедоступного способа взаимодействия с пользователями или средства для размещения участниками собственных проектов.

Проект GitLab упрощает настройку экземпляра GitLab на собственном оборудовании благодаря простому механизму установки. В этом руководстве мы расскажем, как установить и настроить GitLab на сервере Ubuntu 18.04.

Предпосылки

Для этого урока вам понадобятся:

Сервер Ubuntu 18.04 с пользователем sudo без полномочий root и базовым брандмауэром. Чтобы настроить это, следуйте нашему руководству по первоначальной настройке сервера Ubuntu 18.04.

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

Шаг 1 — Установка зависимостей

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

Поскольку мы впервые используем apt во время этого сеанса, мы можем обновить локальный индекс пакета, а затем установить зависимости, набрав:

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

Шаг 2 — Установка GitLab

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

Перейдите в каталог /tmp и загрузите сценарий установки:

Убедившись в безопасности скрипта, запустите программу установки:

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

При этом в вашей системе будут установлены необходимые компоненты.

Шаг 3. Настройка правил брандмауэра

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

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

Еще раз проверьте статус ufw; вы должны увидеть доступ, настроенный как минимум к этим двум службам:

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

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

Прежде чем вы сможете использовать приложение, вам необходимо обновить файл конфигурации и выполнить команду перенастройки. Сначала откройте файл конфигурации Gitlab:

Затем найдите параметр letsencrypt['contact_emails']. Этот параметр определяет список адресов электронной почты, которые проект Let’s Encrypt может использовать для связи с вами в случае возникновения проблем с вашим доменом. Это хорошая идея, чтобы раскомментировать и заполнить это, чтобы вы знали о любых проблемах:

Сохраните и закройте файл. Выполните следующую команду, чтобы перенастроить Gitlab:

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

Шаг 5. Выполнение начальной настройки через веб-интерфейс

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

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

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

При первом посещении вы должны увидеть первоначальный запрос на установку пароля для учетной записи администратора:

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

Вы будете перенаправлены на обычную страницу входа в GitLab:

Имя пользователя: root
Пароль: [установленный вами пароль]

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

Теперь вы можете внести несколько простых изменений, чтобы настроить GitLab так, как вам нужно.

Изменение настроек профиля

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

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

Вы попадете в раздел настроек «Профиль»:

Когда закончите, нажмите кнопку «Обновить настройки профиля» внизу:

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

Изменение имени вашей учетной записи

Затем нажмите на элемент «Учетная запись» в левой строке меню:

Здесь вы можете найти свой частный токен API или настроить двухфакторную аутентификацию. Тем не менее, функция, которая нас сейчас интересует, — это раздел «Изменить имя пользователя».

По умолчанию первой учетной записи администратора присваивается имя root. Поскольку это известное имя учетной записи, более безопасно изменить его на другое имя. У вас по-прежнему будут административные привилегии; единственное, что изменится, это имя. Замените root своим предпочтительным именем пользователя:

Нажмите кнопку «Обновить имя пользователя», чтобы внести изменения:

При следующем входе в GitLab не забудьте использовать новое имя пользователя.

Добавление ключа SSH к вашей учетной записи

В большинстве случаев вам потребуется использовать ключи SSH с Git для взаимодействия с вашими проектами GitLab. Для этого вам нужно добавить открытый ключ SSH в свою учетную запись GitLab.

Если у вас уже есть пара ключей SSH, созданная на вашем локальном компьютере, вы обычно можете просмотреть открытый ключ, набрав:

Вы должны увидеть большой фрагмент текста, например:

Скопируйте этот текст и вернитесь на страницу настроек профиля в веб-интерфейсе GitLab.

Если вместо этого вы получаете сообщение, похожее на это, на вашем компьютере еще не настроена пара ключей SSH:

В этом случае вы можете создать пару ключей SSH, набрав:

Примите значения по умолчанию и при необходимости укажите пароль для локальной защиты ключа:

Получив это, вы можете отобразить свой открытый ключ, как указано выше, набрав:

Скопируйте отображаемый блок текста и вернитесь в настройки своего профиля в веб-интерфейсе GitLab.

Нажмите на пункт "Ключи SSH" в меню слева:

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

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

Шаг 6. Ограничение или отключение общедоступной регистрации (необязательно)

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

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

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

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

Отключение регистрации

Если вы хотите полностью отключить регистрацию (вы по-прежнему можете вручную создавать учетные записи для новых пользователей), прокрутите вниз до раздела «Ограничения регистрации».

Снимите флажок «Регистрация разрешена»:

Прокрутите вниз и нажмите кнопку Сохранить изменения:

Секция регистрации теперь должна быть удалена с целевой страницы GitLab.

Ограничение регистрации по домену

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

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

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

Прокрутите вниз и нажмите кнопку Сохранить изменения:

Секция регистрации теперь должна быть удалена с целевой страницы GitLab.

Ограничение создания проекта

По умолчанию новые пользователи могут создавать до 10 проектов. Если вы хотите разрешить новым пользователям извне видимость и участие, но хотите ограничить их доступ к созданию новых проектов, вы можете сделать это в разделе «Настройки учетной записи и ограничения».

Внутри вы можете изменить лимит проектов по умолчанию на 0, чтобы полностью запретить новым пользователям создавать проекты:

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

Прокрутите вниз и нажмите кнопку Сохранить изменения:

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

Обновление сертификатов Let’s Encrypt

По умолчанию в GitLab настроена запланированная задача для обновления сертификатов Let’s Encrypt после полуночи каждый четвертый день с указанием точной минуты на основе вашего external_url . Вы можете изменить эти настройки в файле /etc/gitlab/gitlab.rb. Например, если вы хотите обновлять каждый 7-й день в 12:30, вы можете настроить это следующим образом:

Вы также можете отключить автоматическое продление, добавив дополнительный параметр в /etc/gitlab/gitlab.rb:

С автоматическим продлением вам не нужно беспокоиться о перебоях в обслуживании.

Заключение

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

Хотите узнать больше? Присоединяйтесь к сообществу DigitalOcean!

Присоединяйтесь к нашему сообществу DigitalOcean, насчитывающему более миллиона разработчиков, бесплатно! Получайте помощь и делитесь знаниями в нашем разделе "Вопросы и ответы", находите руководства и инструменты, которые помогут вам расти как разработчику и масштабировать свой проект или бизнес, а также подписывайтесь на интересующие вас темы.

Добро пожаловать в наше руководство по установке GitLab CE в Ubuntu 20.04 и Ubuntu 18.04. GitLab — это полнофункциональная платформа для ускоренной разработки программного обеспечения. Он предоставляет самые современные функции, такие как интегрированная CI/CD, интеграция с Kubernetes, Auto DevOps, GitLab Container Registry и т. д.

В нашем предыдущем руководстве мы рассказали, как установить Gitlab CE на CentOS/Fedora. Выполните следующие шаги, чтобы установить Gitlab CE на Ubuntu 20.04 / Ubuntu 18.04.

Шаг 1. Обновите систему и установите зависимости

Начните установку, убедившись, что ваша система обновлена:

Установите зависимости GitLab ниже:

Шаг 2. Настройка SMTP-сервера Postfix только для отправки

GitLab должен иметь возможность отправлять вам электронные письма о действиях Git. Настройте SMTP-сервер Postfix, используя приведенное ниже руководство:

Шаг 3. Добавьте репозиторий GitLab CE

Установив все необходимые компоненты, добавьте репозиторий GitLab в Ubuntu 18.04 / Debian 9, выполнив команду:

Содержимое репозитория добавляется в:

Шаг 4. Установите GitLab CE в Ubuntu 20.04 / 18.04 Linux

После добавления репозитория установите GitLab CE в Ubuntu 20.04/18.04 с помощью команды диспетчера пакетов apt:

Отредактируйте файл конфигурации GitLab, указав имя хоста и другие параметры:

После этого запустите экземпляр GitLab, выполнив следующую команду:

Все службы GitLab должны быть запущены после настройки.

Шаг 5. Доступ к веб-интерфейсу GitLab CE

На первом экране вам будет предложено изменить пароль пользователя root.

Укажите новый пароль и подтвердите его, затем нажмите кнопку "Изменить пароль".

Войдите в систему с помощью имени пользователя и пароля root.

Панель управления GitLab должна выглядеть так, как показано ниже.

Шаг 5. Защитите Gitlab CE с помощью SSL-сертификата

Читы администрации GitLab

Всякий раз, когда вы редактируете файл конфигурации GitLab — /etc/gitlab/gitlab.rb, перенастройте службу GitLab, выполнив:

Чтобы проверить состояние всех служб GitLab, используйте:

Чтобы остановить все службы GitLab, используйте:

Чтобы перезапустить все сервисы GitLab, используйте:

Вы можете перезапустить конкретную службу, подтвердив имя службы в конце

Если вам нужна аутентификация LDAP на сервере GitLab, прочтите:

Наслаждайтесь запуском GitLab на сервере Ubuntu 18.04/Debian 9 и оставайтесь на связи для получения более информативных и практических руководств по Linux.

GitLab – это веб-инструмент, который предоставляет менеджер репозитория Git и инструмент жизненного цикла DevOps. Это многофункциональный инструмент, предлагающий отслеживание проблем, непрерывную интеграцию и конвейер развертывания.

GitLab поставляется с двумя дистрибутивами: Enterprise Edition и Community Edition. GitLab Community Edition имеет открытый исходный код. Корпоративная версия включает дополнительные функции.

В этом руководстве мы узнаем, как установить GitLab Community Edition на Ubuntu 20.04.

В основном есть два способа установить GitLab на Ubuntu.

Использование репозитория пакетов GitLab
Вручную загрузите и установите пакет .deb

Предпосылки

Узел Ubuntu 20.04
Минимум 4 ГБ ОЗУ (рекомендуется 8 ГБ)
Минимум 2 ядра ЦП (рекомендуется 4 ядра)
Минимум доступное место на диске – 10 ГБ.
Доступ к DNS для настройки домена для указания экземпляра GitLab.

Способ 1. Установите Gitlab CE с помощью репозитория пакетов

Рекомендуемым способом установки GitLab является установка с использованием репозитория пакетов.

Первое обновление Ubuntu, введите:

Теперь установите все необходимые зависимости пакета:

Установите Postfix, который вам нужен, чтобы GitLab отправлял уведомления (это необязательно):

Затем настройте postfix как smtp-сервер только для отправки.

Чтобы добавить репозиторий пакетов GitLab, введите:

Теперь вы можете установить пакет GitLab (этот пакет также известен как Omnibus):

Способ 2. Загрузите и установите пакет .deb вручную

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

Чтобы установить загруженный пакет GitLab, введите:

Настройка веб-интерфейса GitLab

Давайте настроим веб-интерфейс GitLab.

/opt/gitlab содержит код приложения для GitLab и его зависимости
/var/opt/gitlab содержит данные и файлы конфигурации, в которые записывает gilab-ctl-reconfigure
/var/log/gitlab содержит все данные журнала, созданные GitLab
/etc/gitlab содержит файлы конфигурации для GitLab

Убедитесь, что порты 80 и 433 разрешены в брандмауэре:

Чтобы настроить внешний URL, откройте файл конфигурации:

Укажите свое доменное имя для external_url в сценарии конфигурации и сохраните файл.

Обязательно укажите свое доменное имя для external_url в сценарии конфигурации и сохраните файл.

Настройка сервера GitLab с помощью Lets Encrypt SSL

Включить SSL можно либо с помощью Lets Encrypt, самозаверяющего сертификата, либо от доверенных поставщиков.

Чтобы включить Lets Encrypt SSL, установите для переменной letsencrypt[enable] значение true .

Чтобы настроить Gitlab для автоматического обновления SSL-сертификата Lets Encrypt через регулярные промежутки времени:

Запускайте команду gitlab-ctl reconfigure каждый раз после внесения любых изменений в файл конфигурации /etc/gitlab/gitlab.rb.

Теперь, чтобы запустить сервер GitLab, введите:

Перейдите по URL-адресу в браузере, чтобы настроить веб-интерфейс GitLab. Вам будет предложено установить новый пароль.

Начальная установка пароля

Имя пользователя по умолчанию — root. Войдите в учетную запись с паролем, который вы создали.

Домашняя страница GitLab

Чтобы проверить версию GitLab из графического интерфейса пользователя, щелкните значок в правом верхнем углу, показывающий ? и в раскрывающемся меню выберите Справка.

Вы также можете проверить версию GitLab с помощью командной строки, набрав:

Мы установили версию GitLab Community Edition 13.11.17.

По умолчанию GitLab разрешает новую регистрацию пользователя, для безопасного доступа рекомендуется отключить ее. Вы можете отключить его из веб-консоли: Меню > Администратор -> Снимите флажок Регистрация включена.

Вы можете выполнить следующие шаги после установки GitLab из официальной документации.

Заключение

В этом руководстве мы узнали, как установить GitLab Community Edition на Ubuntu 20.04.

Если у вас есть отзывы и предложения, оставьте комментарий ниже.

Теги AutomationGitlabRepositoriesUbuntu slug; $list = get_page_by_title('related', 'OBJECT', 'wp_show_posts'); wpsp_display($list->ID, 'tax_term="' . $cat_slug . '"' );*/ ?>

Читайте также: