Погружение в DevOps: запускаем GitLab и GitLab Runners локально

В этой статье мы рассмотрим, как развернуть собственный GitLab сервер и GitLab Runners с использованием Docker Compose. Это руководство поможет вам создать локальную среду для изучения и практики GitLab CI/CD. Мы пройдем через все этапы: от настройки контейнеров до регистрации раннеров и создания примера CI/CD пайплайна. Независимо от того, новичок вы в CI/CD или опытный разработчик, этот гайд предоставит вам ценные знания для улучшения вашего процесса разработки.

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

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

Основная часть статьи:

Зачем нужен собственный GitLab сервер?

Собственный GitLab сервер позволяет:

1. Изучить GitLab CI/CD в безопасной среде

2. Экспериментировать с настройками без риска для производственных систем

3. Создать тестовую площадку для отработки CI/CD практик

4. Получить полный контроль над инфраструктурой и данными

Как запустить свой сервер GitLab в контейнере?

1. Подготовка файловой структуры:

mkdir -p ./data/docker/gitlab/{var/opt/gitlab,var/log/gitlab,etc/gitlab-runner,var/run/docker.sock} mkdir -p ./config touch ./config/config.toml

2. Запуск Docker Compose:

Ссылка на docker-compose.yml

docker-compose up --build

3. Доступ к веб-интерфейсу GitLab:

• URL: http://localhost:8000/

• Логин: root

• Пароль: CHANGEME123

4. Настройка SSH-ключа:

1. Перейдите на http://localhost:8000/-/user_settings/ssh_keys

2. Добавьте содержимое вашего ~/.ssh/id_rsa.pub

Регистрация GitLab Runner для выполнения задач в Docker

1. Создайте в одной папке с docker-compose.yml файл .env:

RUNNER_NAME=ИмяПроекта REGISTRATION_TOKEN=ВашТокенРегистрации

REGISTRATION_TOKEN — Его можно получить в http://localhost:8000/root/${Проект}/-/settings/ci_cd в разделе Runner's-> Project runners -> : -> Скопировать

2. Перезапустите сервис register-runner:

docker-compose restart register-runner

Управление GitLab Runner

Для выполнения команд войдите в контейнер register-runner:

# Запуск всех раннеров gitlab-runner run  # Список раннеров gitlab-runner list  # Проверка раннеров gitlab-runner verify  # Удаление всех раннеров gitlab-runner unregister --all-runners  # Удаление конкретного раннера gitlab-runner unregister --name ${name_runner}  # Файл с конфигурациями раннеров vim /etc/gitlab-runner/config.toml

Пример настройки проекта с GitLab CI/CD

1. Создайте новый проект в GitLab, по имени test

2. Зарегистрируйте runner. Как это сделать было написано выше

3. Клонируйте проект: git clone ssh://git@localhost:8822/root/test.git

4. Создайте ветку: git checkout -b test_ci

5. Добавьте файл main.py:

def main():     print('Hello World')  main()

4. Создайте файл .gitlab-ci.yml:

stages:     - linting  variables:     COMMIT_MESSAGE_PATTERN: "^.{0,10}:[[:space:]]#[0-9]{5,6}[[:space:]].{5,150}$"  .default_rules: &default_rules     rules:         - if: '$CI_COMMIT_BRANCH != "main" && $CI_PIPELINE_SOURCE == "merge_request_event"'  commit-name-test:     stage: linting     <<: *default_rules     script:         - |             if [[ "$CI_COMMIT_MESSAGE" =~ $COMMIT_MESSAGE_PATTERN ]]; then               echo "Корректный формат сообщения коммита"             else               echo "Некорректный формат: $CI_COMMIT_MESSAGE"               exit 1             fi  pylint:     stage: linting     <<: *default_rules     image: python:3.9     before_script:         - pip install pylint     script:         - pylint **/*.py 

5. Закоммитьте изменения: git add -A && git commit -m "feat: #12345 Добавлен CI пайплайн"

6. Отправьте изменения: git push -u origin test_ci

7. Создайте Merge Request в GitLab

8. Проверьте выполнение пайплайна на вкладке «Сборочная линия»

Этот гайд поможет вам настроить локальную среду GitLab CI/CD для изучения и экспериментов. Помните, что для продакшен-среды потребуются дополнительные настройки безопасности и производительности.