Заголовок:

Настройка собственного GitLab CI/CD сервера с помощью Docker Compose

Введение:

В этой статье мы рассмотрим, как развернуть собственный GitLab сервер и GitLab Runners с использованием Docker Compose. Это руководство поможет вам создать локальную среду для изучения и практики GitLab CI/CD. Мы пройдем через все этапы: от настройки контейнеров до регистрации раннеров и создания примера CI/CD пайплайна. Независимо от того, новичок вы в 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. Отредактируйте файл .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}

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

1. Создайте новый проект в GitLab, по имени test
2. Зарегистрируйте runner. Как это сделать было написано выше
3. Клонируйте проект: git clone ssh://git@localhost:8822/root/test.git
4. Добавьте файл 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 checkout -b test_ci
6. Закоммитьте изменения: git add -A && git commit -m "feat: #12345 Добавлен CI/CD пайплайн"
7. Отправьте изменения: git push -u origin test_ci
8. Создайте Merge Request в GitLab
9. Проверьте выполнение пайплайна на вкладке "Сборочная линия"

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

Привет. в разделе "Управление GitLab Runner" вроде ошибка

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

должно быть

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

Ещё почему-то при выполнении docker-compose restart register-runner у меня не подтянулись значения из .env. Такой вариант сработал:

docker compose stop register-runner
docker compose up -d register-runner