quiz_test/docs/DRONE_1.x_CONFIG.md

# Drone 1.x+ Pipeline Configuration

## 📋 Обзор

Pipeline был обновлен с Drone 0.8 на современный Drone 1.x+ синтаксис. Новая конфигурация предоставляет:

- ✅ Современный синтаксис Drone 1.x+
- 🚀 10 шагов CI/CD pipeline  
- 🔗 Правильные зависимости между шагами
- 🎯 Условное выполнение для разных веток
- 🐳 Docker-in-Docker для сборки образов

## 🔄 Ключевые изменения от Drone 0.8

### Новая структура конфигурации
```yaml
# Drone 1.x+ синтаксис
kind: pipeline
type: docker
name: quiz-bot-ci-cd

trigger: {...}
services: [...]
steps: [...]
```

### Services (было services:)
```yaml
# Drone 1.x+ - массив объектов
services:
  - name: docker
    image: docker:27-dind
    privileged: true
    command: [...]
    environment: {...}
```

### Steps (было pipeline:)
```yaml
# Drone 1.x+ - массив объектов со структурированными зависимостями
steps:
  - name: step_name
    image: image_name
    commands: [...]
    depends_on: [...]
    when: {...}
```

## 🎯 Trigger Configuration

Автоматический запуск pipeline при:
- **Branches**: `main`, `develop`, `feature/*`
- **Events**: `push`, `pull_request`

## 🚀 Pipeline Steps

### 1. **prepare** - Подготовка
- Отображение информации о сборке
- Проверка Git версии

### 2. **lint** - Линтинг кода  
- Black (форматирование)
- isort (сортировка импортов)
- flake8 (линтинг)

### 3. **test** - Тестирование
- pytest тесты
- Интеграционные тесты

### 4. **security** - Безопасность
- safety (проверка зависимостей)
- bandit (анализ безопасности)

### 5. **typecheck** - Проверка типов
- mypy статический анализ

### 6. **docker_build** - Сборка Docker
- Сборка образа quiz-bot
- Теги: `${DRONE_COMMIT_SHA}`, `latest`
- **Условие**: только `main`, `develop`

### 7. **docker_test** - Тестирование Docker
- Тест импорта модулей в контейнере
- **Зависит от**: `docker_build`
- **Условие**: только `main`, `develop`

### 8. **quality** - Качество кода
- radon (метрики сложности)

### 9. **deploy** - Деплой
- Тег образа для продакшена
- **Зависит от**: `docker_test`, `quality`  
- **Условие**: только `main` + `push`

### 10. **notify** - Уведомления
- Сводка результатов pipeline
- Выполняется всегда (success/failure)

## 🔧 Services Configuration

### Docker-in-Docker Service
```yaml
services:
  - name: docker
    image: docker:27-dind
    privileged: true
    command:
      - --host=tcp://0.0.0.0:2375
    environment:
      DOCKER_TLS_CERTDIR: ""
```

## 🔗 Dependencies Flow

```
prepare → lint     → quality ↘
       → test               → deploy → notify  
       → security           ↗
       → typecheck → docker_build → docker_test
```

## 🌍 Environment Variables

### Drone Built-in Variables
- `${DRONE_BRANCH}` - Текущая ветка
- `${DRONE_COMMIT_SHA}` - SHA коммита  
- `${DRONE_COMMIT_AUTHOR}` - Автор коммита
- `${DRONE_BUILD_NUMBER}` - Номер сборки
- `${DRONE_BUILD_STATUS}` - Статус сборки
- `${DRONE_BUILD_STARTED}` - Время начала

### Docker Connection
- `DOCKER_HOST: tcp://docker:2375` - Подключение к Docker service
- `DOCKER_TLS_CERTDIR: ""` - Отключение TLS для локального Docker

## 🎯 Conditional Execution

### Branch Conditions
- **docker_build/docker_test**: `main`, `develop` ветки
- **deploy**: только `main` ветка

### Event Conditions  
- **deploy**: только `push` events (не pull_request)

### Status Conditions
- **notify**: success или failure

## 💡 Улучшения

### Shell Compatibility
```bash
# Безопасная замена ${VAR:0:8} для BusyBox ash
echo "📝 Commit: $(echo ${DRONE_COMMIT_SHA} | cut -c1-8)"
```

### Error Handling
- Использование `|| true` для не критичных команд
- Graceful degradation при ошибках

### Images Optimization  
- `docker:27-cli` вместо `docker:27` (меньший размер)
- Специфичные версии Python образов

## ✅ Проверка

Pipeline проверен и готов к использованию:
- ✅ YAML синтаксис корректен
- ✅ 10 шагов правильно настроены
- ✅ Зависимости между шагами корректны
- ✅ Условия выполнения установлены
- ✅ Docker-in-Docker сконфигурирован
- ✅ Environment переменные настроены

## 🚀 Готов к запуску

Конфигурация полностью совместима с Drone 1.x+ и готова к продакшену!