Какая конструкция в Git Lab начинается с точки?

GitLab CI/CD: Конфигурационный файл .gitlab-ci.yml

Конструкция в GitLab, которая обязательно начинается с точки (.), — это файл конфигурации для встроенной системы непрерывной интеграции и доставки (CI/CD) — .gitlab-ci.yml. Этот файл определяет весь пайплайн автоматизации: сборку, тестирование, развертывание и другие этапы жизненного цикла ПО.

Назначение и ключевые особенности .gitlab-ci.yml

Это YAML-файл (.yml — расширение, а . — часть имени файла), который должен располагаться в корне репозитория вашего проекта. GitLab автоматически обнаруживает его при каждом пуше (push) в репозиторий и запускает пайплайн на основе заданных инструкций.

Основные аспекты:

• Точка в имени файла — это стандартное соглашение для "скрытых" или конфигурационных файлов в Unix-подобных системах. Она указывает, что файл служебный.
• Обязательное наличие — без этого файла встроенный CI/CD GitLab не активируется для проекта.
• YAML-синтаксис — критически важна правильная структура отступов (пробелы, а не табы).

Базовая структура файла .gitlab-ci.yml

Файл описывает стадии (stages) и задания (jobs), которые выполняются на раннерах (runners) — агентах, обрабатывающих задачи CI/CD.

# Простейший пример .gitlab-ci.yml
stages:
  - build
  - test
  - deploy

build_job:
  stage: build
  script:
    - echo "Собираем проект..."
    - make build

test_job:
  stage: test
  script:
    - echo "Запускаем тесты..."
    - make test

deploy_to_staging:
  stage: deploy
  script:
    - echo "Развертывание на staging-сервер..."
    - scp ./output user@staging-server:/path
  only:
    - main # Это задание выполнится только для коммитов в ветку main

Важные разделы конфигурации

• stages: Определяет последовательность этапов пайплайна (например, build, test, deploy). Задания выполняются в рамках указанной стадии.
• variables: Глобальные переменные окружения для всех заданий. Можно переопределять на уровне задания.

  variables:
    DEPLOY_URL: "https://example.com"
    DOCKER_IMAGE: "my-app:latest"
  

• before_script / after_script: Команды, выполняемые до и после основного script каждого задания соответственно.
• cache и artifacts: Ключевые механименты для передачи данных между заданиями.

    *   **`cache`**: Для ускорения повторных сборок (кеширование зависимостей, например, `node_modules`).
    *   **`artifacts`**: Для сохранения результатов сборки (бинарные файлы, отчеты) и передачи их на следующие стадии.

    ```yaml
    build:
      stage: build
      script:
        - npm ci
        - npm run build
      artifacts:
        paths:
          - dist/ # Папка с собранным приложением будет передана в test-стадию
        expire_in: 1 week
    ```

• Правила запуска (only/except, rules): Современный и гибкий способ rules определяет условия выполнения задания (например, по ветке, тегу, наличию конкретного файла).

  deploy_prod:
    stage: deploy
    script: ./deploy-prod.sh
    rules:
      - if: $CI_COMMIT_TAG # Запуск только для тегов
      - if: $CI_COMMIT_BRANCH == "main" && $CI_PIPELINE_SOURCE == "merge_request_event"
        when: manual # Развертывание в prod будет ручным действием из MR
  

Расширенные возможности

GitLab CI/CD поддерживает:

• Динамические пайплайны с помощью include (подключение конфигов из других файлов или URL) и extends (наследование конфигурации заданий).
• Параллельное и матричное выполнение заданий.
• Секреты (secrets) через защищенные переменные (CI/CD Variables), помеченные флажками Protected и Masked.
• Авто DevOps — готовые пайплайны для стандартных сценариев, которые можно кастомизировать.

Практическое значение

Наличие правильно настроенного .gitlab-ci.yml превращает GitLab из простого хостинга репозиториев в мощную платформу DevOps, обеспечивающую:

• Автоматизацию рутины: каждая интеграция изменений автоматически проверяется.
• Стандартизацию процессов: пайплайн — это исполняемая документация по сборке и развертке проекта.
• Раннее обнаружение ошибок благодаря запуску тестов в изолированной среде.
• Быструю и предсказуемую доставку (CD) артефактов в различные окружения.

Таким образом, файл .gitlab-ci.yml — это фундаментальная, обязательная к использованию точка конфигурации (в прямом и переносном смысле) для автоматизации жизненного цикла приложения в экосистеме GitLab. Его имя начинается с точки, следуя UNIX-конвенции, и это первый файл, который ищет GitLab для активации своих мощных CI/CD-возможностей.