nadejnei.net

Лабораторная работа: Развертывание GitLab в Docker Цель работы

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

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

GitLab - это комплексное веб-приложение для управления жизненным циклом разработки программного обеспечения. Оно предоставляет систему контроля версий Git, отслеживание ошибок, непрерывную интеграцию/непрерывную доставку (CI/CD), вики и многие другие функции, охватывая весь цикл DevOps. Необходимое оборудование и программное обеспечение

Компьютер с установленной операционной системой (Windows, macOS, Linux).
Установленный Docker Desktop (для Windows/macOS) или Docker Engine (для Linux).
Доступ к интернету для загрузки образов Docker.

Ход работы Шаг 1: Подготовка окружения Docker

Убедитесь, что Docker запущен. Откройте терминал или командную строку и выполните команду:
Bash

docker info

Если Docker работает корректно, вы увидите информацию о вашей установке. В противном случае, запустите Docker Desktop или Docker Engine.

Проверьте доступные ресурсы. GitLab достаточно ресурсоемкое приложение. Рекомендуется выделить не менее 4GB оперативной памяти для Docker. Вы можете настроить это в параметрах Docker Desktop.

Шаг 2: Создание директорий для хранения данных GitLab

Чтобы данные GitLab (конфигурации, данные репозиториев, логи) сохранялись даже после удаления контейнера, мы будем использовать монтирование внешних томов Docker. Создайте следующие директории на вашем хосте (например, в домашней директории): Bash

mkdir -p $HOME/gitlab/config mkdir -p $HOME/gitlab/logs mkdir -p $HOME/gitlab/data

Примечание: Замените $HOME на актуальный путь к вашей домашней директории. Например, на Windows это может быть C:\Users\YourUser\gitlab. Шаг 3: Запуск контейнера GitLab

Мы будем использовать официальный образ GitLab из Docker Hub. Запустите контейнер с помощью следующей команды: Bash

docker run –detach \

1. -hostname your.gitlab.example.com \
2. -publish 443:443 –publish 80:80 \
3. -name gitlab \
4. -restart always \
5. -volume $HOME/gitlab/config:/etc/gitlab \
6. -volume $HOME/gitlab/logs:/var/log/gitlab \
7. -volume $HOME/gitlab/data:/var/opt/gitlab \

gitlab/gitlab-ce:latest

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

--detach или -d: Запускает контейнер в фоновом режиме.
--hostname your.gitlab.example.com: Устанавливает имя хоста для GitLab. Обязательно замените your.gitlab.example.com на реальное доменное имя или IP-адрес вашего хоста, по которому вы будете обращаться к GitLab. Для локальной работы обычно достаточно localhost или 127.0.0.1.
--publish 443:443: Пробрасывает порт HTTPS (443) хоста на порт 443 контейнера.
--publish 80:80: Пробрасывает порт HTTP (80) хоста на порт 80 контейнера.
--name gitlab: Присваивает имя контейнеру gitlab.
--restart always: Контейнер будет автоматически перезапускаться при остановке или перезагрузке Docker-демона.
--volume $HOME/gitlab/config:/etc/gitlab: Монтирует директорию config хоста в /etc/gitlab внутри контейнера для хранения конфигурационных файлов.
--volume $HOME/gitlab/logs:/var/log/gitlab: Монтирует директорию logs хоста в /var/log/gitlab внутри контейнера для хранения логов.
--volume $HOME/gitlab/data:/var/opt/gitlab: Монтирует директорию data хоста в /var/opt/gitlab внутри контейнера для хранения данных GitLab (репозитории, базы данных и т.д.).
gitlab/gitlab-ce:latest: Указывает использовать последний образ GitLab Community Edition.

Дождитесь запуска GitLab. Первый запуск GitLab может занять довольно много времени (до 10-15 минут), так как происходит инициализация всех компонентов. Вы можете отслеживать логи контейнера: Bash

docker logs -f gitlab

Дождитесь появления сообщений, указывающих на успешный запуск всех сервисов GitLab, например, GitLab Reconfigured!. Шаг 4: Доступ к GitLab через веб-интерфейс

Откройте веб-браузер и перейдите по адресу, который вы указали в --hostname (например, http://localhost).

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

docker exec -it gitlab grep 'Password:' /etc/gitlab/initial_root_password

Скопируйте полученный пароль.

Используйте имя пользователя root и полученный пароль для входа в GitLab.

После первого входа система попросит вас установить новый пароль для пользователя root. Установите надежный пароль и запомните его.

Шаг 5: Создание первого проекта

После входа в GitLab вы попадете на домашнюю страницу.
Нажмите кнопку "New project" или "Create a project".
Выберите "Create blank project".
Введите "Project name" (например, MyFirstProject).
(Опционально) Установите "Visibility Level" на "Public" или "Private".
Нажмите "Create project".

Поздравляем, вы успешно развернули GitLab и создали свой первый проект! Шаг 6: Остановка и удаление контейнера (необязательно, для очистки)

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

Остановка контейнера:
Bash

docker stop gitlab

Удаление контейнера: Bash

docker rm gitlab

Примечание: Это удалит только контейнер, но не данные, хранящиеся в монтированных томах ($HOME/gitlab/config, $HOME/gitlab/logs, $HOME/gitlab/data).

Удаление данных GitLab (если хотите полностью очистить): Bash

rm -rf $HOME/gitlab

Будьте осторожны! Эта команда безвозвратно удалит все данные GitLab.